Template · Health
NewJournal App SwiftUI Template
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. 15 screens and 4 flows in Folio, as a SwiftUI app template.
A private journal built around one question a night. First run asks your name, takes the first one-tap mood, sets the time for the nightly prompt and offers an account with Sign in with Apple before a StoreKit 2 paywall. Today puts tonight's prompt on the brand's cover art over the mood check and On this day; an entry carries its mood, the place and weather and a photo; Entries holds every page by month with search; Moods colours a month and the whole year; You holds the Face ID lock, reminders, export and the theme.
- SwiftUI
- iOS 17.0+
- Xcode project 1.0.0
- journal-app
$199 once, every piece included. See how installing works · Sign in
01
Flows
Complete journeys through Folio, from first launch to sign out, screen by screen. Open one to play it, or choose any screen to start there.
The first 3 steps of every flow are open. Pro opens every screen of every template, live in each style, and the SwiftUI to build them.
01 · Onboarding
First Run
From the welcome through your name, the first mood, the prompt time, an account and Folio Plus to tonight's page.
7 Screens13 Steps02 · Core Journey
Tonight's Page
Check in a mood, ask for another prompt, then write tonight's page and see it saved on Today.
2 Screens9 Steps03 · Core Journey
Moods And Memories
Read the year of moods, set a day on the month calendar, open last year's page and search every entry.
4 Screens8 Steps04 · Profile And Settings
You And Settings
The subscription, the Face ID lock, the prompt time, the theme, the widget gallery and signing out back to the welcome.
6 Screens14 Steps02
Screens
Every screen in Folio, 15 in all, each a SwiftUI view in the Xcode project. In Riso, Phosphor and Editorial, light and dark.
First run
Welcome, permissions and the questions that set the app up.
- Welcome
Folio opens on tonight's prompt over the brand's cover art, with one line on what a page a night adds up to.
- Your Name
Type the name Today greets you by, in the display face, with the evening's greeting previewed under it.
- The First Mood
Tap how today felt on five faces and watch the week's last mark take its colour.
- Prompt Time
Pick the evening time tonight's prompt arrives, shown as it lands, and allow the one reminder.
Account and subscription
Sign in, verification and the paywall.
- Sign In
Sign in with Apple to back up the journal, or continue without an account and keep it on this iPhone.
- Folio Plus
Start Folio Plus on a yearly plan with a seven-day trial, or pick monthly.
Tabs
Where the app opens, one screen per tab.
- Today
Read tonight's prompt on its cover art, tap how the day felt and see what you wrote on this date last year.
- Entries
Every page by month with the count and streak, and a search across titles, words, places and tags.
- Moods
The month as a calendar of coloured days you can set, or the whole year as a mark per day, with counts.
Details and sheets
What the tabs push and present.
- Entry
Write or read a page: the title, mood, weather, place and tags as chips, the prompt, the picture and the words, saved as you type.
Profile and settings
The account, preferences, the subscription and sign out.
- You
Manage Folio Plus, your name, place and weather, the Face ID lock, export, reminders and the theme, and sign out.
Built onSettings
- Prompt Time Picker
Move the nightly prompt to any half hour between 7:00 PM and 11:00 PM.
Built onSettings
- Theme
Switch between Folio's Riso, Phosphor and Editorial presets and set the appearance.
- Journal Lock
With the lock on, the journal is covered as the app leaves the screen until Face ID or the passcode opens it.
- Widget Gallery
Review the Tonight and Moods widgets at their real sizes, from You in debug builds.
03
Built from the library
The library screens this template wires together, in the order someone meets them. Each one installs on its own too.
First run
Your name, the first mood, the prompt time and its reminder, Sign in with Apple (or continue without an account) and the StoreKit 2 paywall. Runs once, then records completion.
Tabs
Today, Entries, Moods and You on a floating tab bar. Today is tonight's prompt and the mood check; Moods is the month calendar and the year of moods.
From the tabs
An entry pushes from Today, Entries or a day on Moods, and saves as you type. You pushes its pickers and the theme.
04
What's included
SwiftUI source you own, built on Apple frameworks only.
- Tonight's prompt on the brand's cover art, the same all evening
- A one-tap mood check that colours the day
- Entries with a photo, place, weather and tags, saved as you type
- On this day: what you wrote on this date a year ago
- A month calendar and a year of moods, one mark per day
- Face ID lock, Markdown export, Tonight and Moods widgets
- Three presets: Riso, Phosphor and Editorial
05
Implementation notes
How it behaves, what it handles, and the decisions behind it.
JournalApp is one root view. On first launch it runs Folio's own first run: a welcome with tonight's prompt on the brand's cover art, the first one-tap mood, then the Purchase screen's StoreKit 2 paywall. Closing, purchasing or restoring finishes first run and records it under a completion key, so the root switches to the home on its own.
Four destinations sit under a floating tab bar whose selected tab is an ink pill carrying its name. Today greets you, sets tonight's prompt on SPCoverArt with Write and Another prompt, holds the one-tap mood check on five faces and shows On this day: what you wrote on this date in an earlier year. Write opens a page that answers the prompt, with the mood as chips and the words in the display face. Entries lists every page with search. Moods sets the year as twelve columns of marks, one per day, coloured by mood, with today ringed and a sentence naming the year ("mostly good"). You is Settings, with sign out back to first run.
Adapting it
- Products: pass your App Store Connect ids as
productIDs. Until they exist, the paywall shows its designed "plans didn't load" state and its close button still finishes first run. - Your journal: pages and moods live in
JournalAppModel, seeded byJournalAppSampleat the foot ofJournalApp.swift. Persist them in SwiftData or your backend;save(_:)andcheckIn(_:)are the only writes, and a blank page is never kept. - Prompts:
JournalAppSample.promptscycle one a night by the day's number, so the same evening always shows the same prompt. Add or reorder your own. - Theme: everything follows the theme you set on
JournalApp. Without a brand it wears Folio Riso;SPBrandTheme(.folioPhosphor)or.folioEditorialre-skin every destination, including the mood colours and the cover art.
The Xcode project
The download is a complete project on Tuist: SwiftData entries and day moods behind a repository protocol, in an App Group the widgets share; a first run that asks your name, takes the first mood, sets the prompt time and offers Sign in with Apple (or no account) before the paywall; entries with a photo, place, weather and tags that save as you type; a month calendar you can set any past day on; search across every page; the nightly prompt reminder, each evening carrying its own prompt; a Face ID lock that covers the journal in the app switcher; Markdown export; Tonight and Moods widgets; three presets; unit tests, a first-run UI test and a settings UI test.
Notes
- Not
@main: putJournalApp()in your ownWindowGroup. - Enable the In-App Purchase capability before testing purchases. The project's Face ID lock needs
NSFaceIDUsageDescription, and real places and weather need Core Location and WeatherKit. - Previews ship with the file: first run, home, and home in each Folio preset.
06
Keep building
Pieces that work well next to this one.









