Docs

Folio: Journal App in SwiftUINew

Setup guide for Folio, a complete Journal App Xcode project in SwiftUI. Install, rename and theme version 1.0.0.

Folio is a complete Journal App in SwiftUI: an Xcode project you rename and ship. Folio, a private journal: a complete Xcode project with a nightly prompt, a one-tap mood check, entries with photo, place and weather, On this day, a year of moods, widgets and three brand presets. This guide takes you from download to a running, renamed app. It covers version 1.0.0. See the screens on its library page.

Requirements

  • Xcode 26 and an iOS 17.0 or later deployment target
  • Tuist 4 (brew install tuist)
  • An Apple Developer team for devices, App Groups and Sign in with Apple. The simulator runs without one.

Install

Download

Included with SwiftPieces Pro. Not signed in? The button takes you to sign in or create an account, then starts the download when you're back. Unzip the archive; it contains one folder, Folio/.

Make it yours

cd Folio
scripts/setup.sh --name YourApp --bundle-id com.you.yourapp --preset folio-phosphor

The script rewrites the project configuration, renames the paywall product ids, renders the app icon in the chosen preset and runs tuist generate.

Run it

Open YourApp.xcworkspace, choose an iPhone simulator and run the YourApp scheme. The first launch loads sample data so every screen has content.

Screens and flows

Folio ships 15 screens, joined by 4 flows. Play each flow step by step on the site:

  • First Run: onboarding, 13 steps. From the welcome through your name, the first mood, the prompt time, an account and Folio Plus to tonight's page.
  • Tonight's Page: core journey, 9 steps. Check in a mood, ask for another prompt, then write tonight's page and see it saved on Today.
  • Moods And Memories: core journey, 8 steps. Read the year of moods, set a day on the month calendar, open last year's page and search every entry.
  • You And Settings: profile and settings, 14 steps. The subscription, the Face ID lock, the prompt time, the theme, the widget gallery and signing out back to the welcome.

Every screen is a SwiftUI view in the project. Search for its type to find the file.

ScreenSwiftUI viewWhere
WelcomeWelcomePageFirst run
Your NameNamePageFirst run
The First MoodMoodPageFirst run
Prompt TimeReminderPageFirst run
Sign InSignInViewAccount and subscription
Folio PlusPaywallViewAccount and subscription
TodayTodayScreenTabs
EntriesEntriesScreenTabs
MoodsMoodsScreenTabs
EntryEntryScreenDetails and sheets
YouFolioSettingsScreenProfile and settings
Prompt Time PickerSettingsPickerListProfile and settings
ThemeThemeSettingsViewProfile and settings
Journal LockLockViewProfile and settings
Widget GalleryWidgetGalleryViewProfile and settings

Rebrand options

OptionWhat it sets
--nameTarget, scheme and product name. Letters and digits.
--bundle-idThe bundle id. The widget, modules, tests and the App Group derive theirs from it.
--display-nameThe name under the icon. Copy that mentions the app reads it at runtime.
--teamYour Apple Developer team id.
--presetThe starting brand preset. Also re-renders the app icon.
--product-prefixApp Store Connect product id prefix. Defaults to the bundle id plus .pro.

The values live in Tuist/ProjectDescriptionHelpers/AppConfig.swift if you prefer to edit them by hand.

Theming

Folio reads every color, type size, radius and animation from @Environment(\.spTheme). Its three presets are three different scheme families, so switching changes the whole look: ground, surfaces, color blocks, type and shape. People switch presets and appearance in Settings > Theme, and the widget follows.

PresetIdLookType
Risofolio-risoNewsprint, fluorescent pink and riso blue, overprinted shapes and halftone.Bricolage Grotesque
Phosphorfolio-phosphorTerminal black, amber and green phosphor, squared technical type, dithered pixels.Chakra Petch
Editorialfolio-editorialSerif headlines over scenery, ink and paper.New York
  • Blocks: theme.color.tiles holds each family's solid block colors with the ink that reads on them. Use them for categories, charts and highlights, and keep the accent for the primary action.
  • Numbers and display type: theme.type.numeral(64) and theme.type.display(40) set any size in the family's style, scaling with Dynamic Type.
  • Backdrop: SPBrandBackdrop draws the family's motif (contours, scenery, shapes, blobs, rings, the Pearl haze, Confetti's sprinkles or Prism's luminous field) behind hero surfaces.
  • Liquid Glass: .spGlass uses glass on iOS 26, Material on iOS 17 and 18, and an opaque surface under Reduce Transparency.

To build your own brand, start from the preset closest to it in BrandPresets.swift, copy it, and change its colors; every role and block pairing should keep 4.5:1 contrast. For a quick start from hues, SPBrandConfiguration.custom(...) builds an accessible palette from three OKLCH hues.

Purchases and accounts

  • PurchaseStore handles StoreKit 2: products, purchase, restore and transaction updates. The scheme runs with Configuration/Products.storekit, so purchases work in the simulator before App Store Connect is set up.
  • Create the products in App Store Connect with the ids in the project's catalog (the product prefix plus .yearly and .monthly).
  • AccountStore signs in with Apple and keeps the account in the Keychain. People can also continue without an account.
  • Data lives in SwiftData inside the App Group, so the widget reads the same store. Replace the sample data by conforming your own type to the repository protocol.

Launch arguments

Debug builds accept these arguments for demos and screenshots. Release builds ignore them.

ArgumentEffect
-SPMockStoreLocal purchases with the same plans
-SPMockAccountA signed-in sample account
-SPSkipOnboardingOpen on the home screen
-SPResetOnboardingRun first launch again
-SPResetDataReseed the sample data
-SPTab followed by a tab idOpen a tab
-SPPresent paywallPresent the paywall
-SPPreset folio-phosphorStart with a preset
-SPAppearance darkForce light or dark

Changelog

1.0.0

2026-11-08

  • Tuist project with feature modules (Onboarding, Today, Entry, Entries, Moods, Settings) on a shared DesignSystem and the PageKit domain module.
  • One-command setup: name, bundle id, team, product ids, brand preset and app icon.
  • Brand presets Riso (default), Phosphor and Editorial with Bricolage Grotesque, Chakra Petch and New York display type, switchable in You.
  • First run with tonight's prompt on the brand's cover art, your name, the first one-tap mood, the nightly prompt time with the notification permission, Sign in with Apple (or none) and a StoreKit 2 paywall with a .storekit configuration and a mock store for demos.
  • A floating capsule tab bar: Today, Entries, Moods and You.
  • Today: a greeting by name, tonight's prompt with Write, a photo button and Another prompt, the one-tap mood check and On this day.
  • The entry editor: title, mood, weather and place chips, tags, a photo or the brand's cover art, the prompt it answers, autosave, and a keyboard bar for photo, place, tag, quote and delete.
  • Entries: every entry by month with search across titles, words, places and tags, and the streak.
  • Moods: a month calendar you tap to set or change a day's mood, and the year as twelve columns of marks with the year's phrase and a count per mood.
  • You: your name, place and weather, Face ID lock, Markdown export, the nightly prompt and mood check reminders, theme and appearance.
  • SwiftData persistence in an App Group with fourteen months of sample pages and a repository protocol.
  • Tonight (small and medium) and Moods (medium) widgets.
  • Light and dark mode, Dynamic Type, VoiceOver labels on every mood, day and month, and Reduce Motion.
  • String catalog, unit tests, a first-run UI test and a settings UI test.