Template · Health

New

Journal 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
15 Screens4 Flows
Get SwiftPieces Pro

$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 Steps
Play the flow
  1. 01Welcome
  2. 02Your Name
  3. 03Elena
  4. 04The First Mood
  5. 05Good
  6. 06Prompt Time
  7. 07Pick 9:30 PM
  8. 08Allow Notifications
  9. 09Sign In
  10. 10Sign In With Apple
  11. 11Folio Plus
  12. 12Plus Unlocked
  13. 13Today

02 · 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 Steps
Play the flow
  1. 01Today
  2. 02Check In
  3. 03Another Prompt
  4. 04Write
  5. 05A Blank Page
  6. 06Writing
  7. 07Change The Mood
  8. 08Saved
  9. 09Written Today

03 · 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 Steps
Play the flow
  1. 01Moods
  2. 02The Month
  3. 03Set A Day
  4. 04Free Accounts
  5. 05On This Day
  6. 06Last Year's Page
  7. 07Entries
  8. 08Search

04 · 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 Steps
Play the flow
  1. 01You
  2. 02Journal
  3. 03Lock With Face ID
  4. 04Journal Lock
  5. 05Unlock
  6. 06Reminders
  7. 07Prompt Time Picker
  8. 08Pick 9:30 PM
  9. 09Time Saved
  10. 10Theme
  11. 11Widget Gallery
  12. 12Sign Out
  13. 13Signing Out
  14. 14Back To The Welcome

02

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.

    Built onPaywallPurchase

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

Includes

Settings, Purchase, Paywall. Installed together, automatically.

Requires

In-App Purchase capability

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 by JournalAppSample at the foot of JournalApp.swift. Persist them in SwiftData or your backend; save(_:) and checkIn(_:) are the only writes, and a blank page is never kept.
  • Prompts: JournalAppSample.prompts cycle 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 .folioEditorial re-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: put JournalApp() in your own WindowGroup.
  • 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.