Guide

Walkthroughs that go beyond the per-feature manual pages. Currently:

• ROOT app — generating leaf text apps — how to use zudotext.app (ROOT) to generate LEAF text apps via the no-compile copy-based pipeline.

• Cloud-first onboarding (web editor) — getting started in the browser-based editor against the cloud backend.

• Inline AI command — the @@ / Cmd+J prompt surface inside the editor, and how to choose between baked ghost text and the mini panel.

• Inline AI command — skill authoring — how to write your own /skill-name skill files and where they live.

• MCP integration (Claude Code and Codex) — install the public npm package and official skills, mint a workspace-bound token, and use the exact 21-tool document/history/change/asset/agent surface.

• Agent task recipes (MCP) — the same surface organized by task: the sentence to type at Claude Code or Codex, the tool sequence it triggers, and the one caveat that matters per job.

• Media uploader — drag, attach, paste, or shortcut any file (not just images) into the editor; how cloud R2 storage differs from the local desktop path.

• Settings Doctor — how the app auto-detects and repairs color setting problems at boot, what to do when the recovery toast appears, and how to reset colors to defaults.

• Pile View — the responsive horizontal/vertical card overlay for reviewing, selecting, and archiving notes; pointer-native scroll rail, card-size controls, sweep/archive buttons, and keyboard focus navigation.

• Diff View — compare the active file against nearby notes, workspace notes, other zudo-text apps, or a Mac Spotlight file-name search.

• Mind maps — using a markdown mind map inside a Note Tray leaf or as a dedicated frame beside other work.

• Frame Components Reference — every view provider you can load into a leaf, what each one shows, and how the layout switcher behaves.

• Header pins — the toolbar shortcut icons, how to create/edit/reorder them, and the temp-pin draft-mode mechanics.

• Scroll sync — how the editor and preview panes keep their scroll positions aligned.

• Spotlight file/directory picker — the keyboard-driven path picker that replaces the native macOS folder dialog, and how to disable it.

• Auto-managed frontmatter fields — the built-in created_at / updated_at and other fields the app maintains for you.

• Frontmatter schema — how the per-workspace schema defines and validates note/archive metadata.

• Personal Access Tokens — least-privilege document/asset defaults, optional agent access, explicit Full compatibility, workspace binding, and revocation.

• Notifications and Notification Center — transient toast notifications, the stacking model, action buttons (Undo, Reload / Keep Mine), and the Notification Center history panel.

• Preview themes — the ten built-in themes, how to pick one (toolbar, command palette, shortcut), settings, and setting a theme at app-generation time.

• Spreadsheet Helper — turning a GFM table into a Sheets-like editing surface: formulas, fill, sort, number formats, the formula bar, and the A1-addresses-body-rows convention.

• Slow workspaces in synced folders — why Dropbox/OneDrive/iCloud can make large archives slow to browse, the "Make available offline" fix, and the in-app notice that flags it.

• Note History — the per-note cloud version timeline with A/B compare, checkpoint tag markers, non-destructive restore, and save-as-note-N.

• Checkpoints — document change-log markers, summaries, client-orchestrated restore manifests, and the local-agent undo boundary; assets are excluded.