--- title: "02 iOS App" canonical_url: https://mdflow.cz/share/c/h0L7MvX5Cy5sST3qPnApqHOmrQ36JTVy169qJMtDMya9Kc30zm04cg9OuPSSPwvj/0a35e506-d632-4f07-aa6a-1d19a5ab3940 md_url: https://mdflow.cz/share/c/h0L7MvX5Cy5sST3qPnApqHOmrQ36JTVy169qJMtDMya9Kc30zm04cg9OuPSSPwvj/0a35e506-d632-4f07-aa6a-1d19a5ab3940.md visibility: public --- # iOS App The MDflow iOS app puts your workspace on your iPhone and iPad, with deep integration into iOS itself — Siri, Spotlight, widgets, the share sheet, and Face ID. **The iOS app is not Pro-gated.** Unlike the Web Clipper, the editor extension and the n8n node, it does not use a Personal Access Token, so everything in it works on a Free account. ## Requirements - **iOS 26.5 or later.** - iPhone and iPad. The iPad runs the same layout as iPhone rather than a split-view design. ## Signing in Four providers, matching the web app: - **Sign in with Apple** — the native system sheet. - **Google**, **GitHub**, **Microsoft** — a secure system web sheet. There is no email-and-password option. Use the same provider you use on the web, or you will end up in a different account. ## Getting around The app is a single navigation stack, not a tab bar: - **Home** — the workspace browser: a workspace switcher, search, and your Favorites, Recent and Folders. - **Folder** — subfolders and documents, with actions to create, rename or delete. - **Document** — read, edit, and everything in the `…` menu. ## Workspaces **Switch** workspaces from the dropdown at the top of Home. You **cannot create, rename or delete workspaces** in the app. Do that on the web. ## Folders - **Create** a folder at the root or nested inside another. - **Rename** and **delete** from the folder's `…` menu. Deleting warns that the documents inside will be permanently deleted. - Rows show the folder name and its subfolder count. Two absences worth knowing: you **cannot move a folder** to a different parent, and **folder descriptions are not shown or editable** in the app. Both are web app features. ## Documents Full create, read, update and delete: - **Create** in a folder. Type a title — `.md` is appended automatically. - **Edit** in a plain monospaced text editor. - **Preview** with a segmented Edit/Preview toggle, rendering proper markdown. - **Rename**, **Move to folder**, **Delete**, and **Favorite** with the star. - **Zoom** text in and out from the `…` menu. The zoom is global across all documents and is remembered. ### Saving The app **autosaves** about a second after you stop typing, with a live **Saving… / Saved / Not saved** indicator. Pending edits are flushed when you leave the screen. Note this differs from the web app, where autosave is a Pro feature you switch on per document. On iOS, autosave is simply how the editor works — for everyone. ### Task lists Markdown checkboxes render properly in Preview. They are **not tappable**, and the app has no task management — the `/tasks` view is a web app feature. ## Finding things - **Search** from Home, scoped to the current workspace. It matches **titles and body text**, returns up to **50** results, newest first. Pull to refresh. - **Favorites** — every starred document in the current workspace. - **Recent** — the **5** most recently updated documents. Encrypted documents are stored as ciphertext, so their contents are not searchable. ## Encryption Full end-to-end encryption, interoperable with the web app: - **Encrypt** a document with a password from the `…` menu, with a confirm step and a clear warning that **there is no recovery**. - **Locked documents** show a gate requiring the password. - **Face ID / Touch ID unlock** — the derived key (never the password) is stored in the iOS Keychain, so later opens use biometrics instead of typing the password. - Once unlocked, the document stays **editable**, and is re-encrypted on save. Same `mdflow-enc:v1` format as everywhere else — AES-GCM with PBKDF2-SHA256 at 600,000 iterations — so a document encrypted on your phone opens on the web, and vice versa. **You cannot remove encryption in the iOS app.** The option only appears for unencrypted documents. Use the web app or the VS Code extension to convert a document back to plain markdown. Biometrics protect **encrypted documents only**. There is **no app-level lock** on MDflow itself. ## Sharing — read this carefully The `…` menu has **Share**, but it does something narrower than you might expect: > **Share exports the document as a `.md` file** through the iOS share sheet — AirDrop, Files, Mail, and so on. It **does not create a share link.** There are **no share links, collaborators, comments, or permissions** in the iOS app. To publish a document, use the web app. Share is hidden while a document is locked. ## iOS integrations This is where the app earns its place: | Feature | What it does | | --- | --- | | **Share Extension** | Share text or a text file from any app into MDflow. It is saved to an **"iOS" folder in your oldest workspace**, with the message "Saved to mdflow. Open MDflow to edit it." | | **Widget** | A small-size tile that opens a document you choose. Small size only. | | **Control** | A **New Note** control for Control Center, the Lock Screen, and the Action Button. | | **Siri / Shortcuts** | Four actions: **Open Document**, **Search Documents**, **New Note** (title and text), and **Append to Document**. | | **Spotlight** | Document **titles** appear in system search and open on tap. Bodies are never indexed. Cleared when you sign out. | | **Dark mode** | Follows your system appearance. No in-app toggle. | ## Offline behaviour Be clear-eyed about this: > **There is no offline document access.** Reading or editing any document requires a network connection. There is no local cache, no draft store, and no conflict resolution — the last write wins. This is a real difference from the web app, which keeps local drafts and lets you keep writing offline. What **does** work without a connection: notes captured by the **Share Extension**, the **New Note** control, and **Siri intents**. These are queued locally and imported the next time you open the app. Document **titles** are cached too, so the widget and the Siri document picker work offline. So: capture works offline, reading and editing does not. ## What the iOS app does not have - Images or attachments — cannot view or insert them. - PDF export or printing. - Share links, collections, comments. - Tasks. - A settings screen (About, Sign out and Delete account live in the Home `…` menu; text zoom is in the document `…` menu). - Workspace create/rename/delete, folder moves, folder descriptions. - Push notifications. - Any Pro upsell — there is no paywall in the app at all. ## Account deletion **Delete account** is in the Home `…` menu. It is permanent and removes all of your documents, folders and images — the same cascade as the web app, since it calls the same endpoint. See [03 Deleting Your Account and Data](/doc/e74e57f7-89cc-4bfb-89ab-eb566a13c781).