Folder & Vault
What “vault” means here
Section titled “What “vault” means here”The app uses vault as a generic name for your selected folder, even if you do not use Obsidian. If you use Obsidian, select your Obsidian vault root. Otherwise, select any folder, such as iCloud Drive's Documents/Health or an On My iPhone folder.
How the picker works
Section titled “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
Section titled “Subfolder name”After picking the vault, you are prompted to name the subfolder where exports go. The default is Health. Whatever you choose becomes the prefix for every exported file's path:
You can change the subfolder later from Settings → Obsidian Vault. Existing files are not moved.
Cross-app behavior
Section titled “Cross-app behavior”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.
Replacing or moving a selected folder safely
Section titled “Replacing or moving a selected folder safely”When a saved bookmark resolves at a changed path, Health.md rebinds automatically if persistent identity proves it is the same folder. It can also accept a successfully resolved security-scoped bookmark when neither the saved nor resolved folder exposes persistent identity, which is common for cloud providers. It never treats a nearby path alone as proof. Export history still shows the privacy-safe destination label used by each run.
Select the folder again if it was deleted or access was revoked. Also select it again if persistent identities conflict or Health.md cannot verify a move. Health.md fails closed instead of writing to an ambiguous destination. Each export profile owns its destination. Verify or select the affected folder again for each profile.