Onboarding

What it does

Onboarding only appears on first launch. It guides you through everything you need to do once so the rest of the app just works:

1. Welcome

What the app does, in one screen — Markdown export, scheduled background runs, and local-first destinations you choose.

2. Health Access

Triggers iOS's HealthKit permission sheet. Tip: choose Turn On All for the simplest setup. You can adjust later in iOS Settings → Privacy & Security → Health → health.md.

3. Pick Your Vault

Opens the iOS document picker. Choose a folder anywhere — iCloud Drive, On My iPhone, an Obsidian vault, or any third-party file provider.

4. Unlock

One-time Full Access purchase for unlimited exports. Apple shows the live local price before purchase, and you can come back to this step later from the Paywall.

5. Ready

Confirms permissions, vault, and unlock state are all set. Get Started dismisses onboarding for good.

Skip-friendly.

The Health Access step is intentionally not gated — denying iOS's permission sheet would otherwise trap you (iOS only shows it once per install). You can grant it later via Settings.

Why these steps, in this order

HealthKit access has to be granted before the export engine can read anything. The vault picker is iOS's UIDocumentPickerViewController — it produces a security-scoped bookmark that the app stores and reuses. Picking the vault before the first export means we never have to interrupt an export run with a folder picker.

Re-running onboarding

There is no in-app reset. To redo the flow, delete and reinstall the app — your purchase will restore via Restore Purchase on the paywall.

Related

NextFolder & Vault — what the picker actually does. NextRun your first export. AccountUnlock & Paywall details.