Build a Mental Health Journal App in SwiftUI

A mental health journal app is a private space for mood check-ins and reflection, not a clinic in your pocket. That distinction shapes every technical choice: entries stay on the device, the app locks behind Face ID, and the language stays supportive rather than diagnostic. VP0 is the free, AI-readable iOS design library builders start from for this kind of app, because a calm, trustworthy layout is most of the work and you can rebuild it in SwiftUI quickly.

Who this is for

You are building a wellness or journaling app for iOS with SwiftUI, possibly with Cursor or Claude Code helping, and you want the architecture to be private, honest, and App Store safe. This is the pattern.

Privacy is the product

People write things in a mood journal they would not put anywhere else, so trust is the feature. Default to on-device storage with SwiftData or Core Data and do not send entries to a server unless the user explicitly turns on sync. Gate the app with Face ID through LocalAuthentication, and lean on the iPhone’s built-in file protection, which encrypts data while the device is locked. If you ever add cloud backup, make it opt-in, encrypt it, and say plainly what leaves the phone. This is the same privacy-first instinct behind a focused ADHD routine planner.

The core screens

A useful journal needs only a few screens, each doing one job well.

Screen	What it does	Honest design note
Daily check-in	One-tap mood plus optional note	Make the note optional so logging stays low-effort
Entry editor	Free text, prompts, tags	Autosave; never lose a half-written entry
Trends	Mood over time with Swift Charts	Show patterns, not diagnoses
Settings	Face ID, reminders, export, delete	Let people delete everything in one tap

Reminders should be gentle and skippable, closer to a forgiving focus timer than a guilt-driven streak. A broken streak should never feel like failure.

Logging mood with HealthKit State of Mind

iOS 18 added State of Mind to HealthKit, so your app can write and read momentary and daily mood with permission and place it next to sleep and activity data. Read Apple’s State of Mind documentation before you wire it up. Request only the types you need, explain the why in the usage description string, and make sure the journal works fully even when the user declines, the same graceful-degradation rule that a HealthKit cold plunge timer follows. Surfacing trends with Swift Charts turns scattered check-ins into something a person can actually reflect on.

Stay on the right side of medical claims

The World Health Organization notes that depressive disorders affect about 5% of adults worldwide, so demand for these apps is real and so is the responsibility. Keep the app a wellness and journaling tool: do not diagnose, do not claim to treat a condition, and do not promise an outcome. Always show emergency and crisis-line resources in a place users can find under stress. That framing keeps you compliant with App Store review and, more importantly, safe for the people using it.

A worked example: the daily check-in

Picture the most common flow. The user opens the app, Face ID unlocks it, and the home screen shows a single prompt: how are you feeling today. They tap a mood, optionally add a sentence, and the entry saves to SwiftData instantly. If they granted HealthKit access, the same mood writes to State of Mind so it sits alongside their sleep and activity. A week later, the Trends screen draws a Swift Charts line of those moods, and the user notices their low days cluster on poor-sleep nights. Nothing here diagnoses anything; it simply reflects a pattern back. That is the entire value loop, and it works whether or not the user ever turns on HealthKit or reminders. If your wellness app also reads a physical tag or wearable, the same consent-first mindset guides a SwiftUI NFC reader.

Common mistakes and fixes

• Sending entries to a server by default. Store on device first; make any sync opt-in and encrypted.
• Using clinical language. Swap diagnose and treat for reflect and notice.
• Punishing missed days. Forgiving streaks beat brittle ones for a wellness app.
• Forcing HealthKit. Let the journal work fully without it, and request the minimum types.
• Hiding the crisis resources. Put them where a struggling user can reach them fast.

Key takeaways

• Keep entries on device with SwiftData and lock the app with Face ID.
• Log mood through HealthKit State of Mind on iOS 18, with consent and a fallback.
• Frame the app as wellness and journaling, never as diagnosis or treatment.
• Start from a calm free VP0 SwiftUI design so the app feels trustworthy.

Frequently asked questions

The FAQ above answers the most common searches: the best way to build the app, whether it counts as a medical device, how to keep entries private, and how to log mood to Apple Health from SwiftUI.