health.md icon health.md
Getting Started · Step 2

Folder & Vault

Pick where your Markdown files live and name the subfolder where exports get written. The vault is just any iOS folder — Obsidian, Files, iCloud Drive, or third-party file providers all work.

Export modal
Export modal

What "vault" means here

The app uses vault as a generic name for the folder you've picked, regardless of whether you actually use Obsidian. If you do use Obsidian, point it at your Obsidian vault root. Otherwise, pick any folder — iCloud Drive's Documents/Health, an On My iPhone folder, etc.

How the picker works

Tapping the vault row opens iOS's standard document picker (UIDocumentPickerViewController). When you pick a folder, iOS returns a security-scoped URL — a long-lived handle that lets the app keep accessing the folder across launches without re-prompting. The app stores this as a bookmark in UserDefaults.

Subfolder name

After picking the vault, you're prompted to name the subfolder where exports go. The default is Health. Whatever you choose becomes the prefix for every exported file's path:

{vault}/
{subfolder}/                 ← what you name here
  2026-04-28-monday.md
  2026-04-27-sunday.md
  ...

You can change the subfolder later from Settings → Obsidian Vault. Existing files are not moved.

Cross-app behavior

Obsidian

Pick the Obsidian vault root. Set the subfolder to e.g. Health so exports show up as a folder in your vault tree.

iCloud Drive

Pick a folder under iCloud Drive. Files sync to all your Apple devices automatically.

On My iPhone

Pick a folder you've created in Files → On My iPhone. Local-only, no sync.

Third-party providers

Dropbox, Google Drive, Working Copy, etc. — anything that exposes a Files-app provider works the same way.

iOS quirk.

If iOS revokes the security-scoped bookmark (rare — usually only if the underlying folder is deleted or moved), exports will start to fail. The fix is to re-pick the vault from Settings.

Related