Skip to content

Folder & Vault

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.

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.

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 in Health.md    ├─ 2026-04-28-tuesday.md    ├─ 2026-04-27-monday.json    └─ _healthmd_data_dictionary.json

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

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.