Skip to content

Sync & storage ​

Aurora is local-first. The app keeps a local cache so you can keep working offline, then syncs when the selected storage mode has a remote or folder target.

Storage Modes ​

ModeAccount requiredBest for
Browser storageNoTrying Aurora or keeping single-browser private notes
Offline foldersNo, desktop-focusedFolder-backed work without AuroraCloud
Local foldersAuroraCloud for syncA local folder copy plus AuroraCloud collaboration
AuroraCloudYesMulti-device sync, collaboration, sharing, publishing, notifications, AI/RAG/MCP

Browser Storage ​

Browser storage keeps data in this browser profile's IndexedDB. It sends nothing to AuroraCloud and needs no account.

Use Browser storage to try the hosted app. Clearing browser/site storage can delete the workspace, so export or promote the workspace before relying on it as your only copy.

Upgrade paths:

  • Save to Local folders: writes the workspace to a user-chosen folder when the browser supports the File System Access API.
  • Enable AuroraCloud sync: signs in and uploads the browser workspace into AuroraCloud.

Signing out from Browser storage is non-destructive. It returns you to the sign-in screen while keeping the local workspace available behind Use without account.

AuroraCloud ​

AuroraCloud sync keeps local IndexedDB plus a hosted account copy. Offline edits queue locally and upload when the app reconnects. That includes new pages: a page you make while offline opens at once and reaches your other devices, with what you typed, when the connection is back. Use Sync now when you want to flush pending work manually.

AuroraCloud enables:

  • multiple devices
  • shared workspaces
  • live editing
  • comments/chat/notifications
  • direct sharing, guest links, and publishing
  • AuroraAI, workspace retrieval, and MCP when available
  • cloud-backed usage history

The sync indicator opens a compact panel for pending, uploading, failed, conflicted, delayed, or stuck work. Settings → Data & sync → Sync includes diagnostics, troubleshooting, and recovery actions such as Recover stuck and Reset sync cursors.

Encrypted workspaces need Aurora 0.12.0 from 15 October 2026

From 15 October 2026, encrypted workspaces on AuroraCloud need Aurora 0.12.0 or later on every device; older apps can still read but their saves are refused until you update. When this happens, the sync panel and Settings → Data & sync → Sync say that an update is needed. Workspaces without encryption are not affected.

Offline Folders ​

Offline folders are folder-backed workspaces without AuroraCloud. They are most useful in the desktop app. You can later promote an Offline folders workspace into Local folders without recreating the workspace.

Local Folders ​

Local folders keep a device-wide folder root with per-workspace subfolders. Owned workspaces can be enrolled automatically; shared workspaces stay off until enabled unless the owner allows offline downloads.

A Local folders root belongs to the AuroraCloud account that chose it. If you choose Use without account while that folder is bound, Aurora does not open or change it: sign in as the owner, or choose another folder to work without an account. To stop using a folder on this device, open Settings → Data & sync → Storage and choose Release this folder from this device. The files stay on disk, and you can choose the folder again later.

Local folders include:

  • Aurora JSON workspace files
  • optional Clean Markdown format/mirror files
  • per-workspace settings snapshots
  • a root-level aurora-device-settings.json portability snapshot
  • non-secret AI, layout, calendar, plugin, and UI state

Aurora never writes passwords, API keys, OAuth tokens, recovery phrases, or similar secrets into the Local files root.

Aurora JSON And Clean Markdown ​

Aurora JSON is the native folder format. It preserves Aurora page structure and is the safest default.

Clean Markdown is a plaintext mode for supported Markdown body edits. Keep mirrored is export-only; Clean sync also imports supported Markdown edits back into Aurora for enrolled workspaces.

Aurora warns before enabling plaintext Markdown behavior for encrypted workspaces.

Read-Only Safe Mode ​

If Aurora loses write access to a folder-backed workspace, cannot reopen the folder, or the workspace owner disables offline downloads, Aurora switches affected folder-backed workspaces to read-only mode. Writes are blocked until you re-authorize the folder, restore the volume, or the owner re-enables offline downloads.

The desktop Recent file activity log and Desktop sync center show watcher events, skipped writes, queued folder sync work, and recovery actions.

Sync Conflicts ​

AuroraCloud workspaces merge normal queued edits in the background. When the same thing was changed differently on this device and in the cloud, Aurora surfaces it in the conflict center at Settings → Data & sync → Sync.

The conflict center leads with a one-line, plain-language status (for example "Everything's synced" or "1 change needs your decision"). When a decision is needed, each affected page gets a focused card with:

  • a short description of what changed,
  • an optional Compare both versions view showing the two values side by side, and
  • two equal-weight choices — Keep this device or Use the cloud — plus a quiet Dismiss.

Neither choice is pre-selected, so you are never nudged toward losing an edit, and a confirmation step runs before anything is overwritten. Diagnostic detail — pending, failed, or stuck queue items, recent sync results, and recovery controls (retry, recover stuck, reset sync cursors) — lives in a collapsible Sync details & troubleshooting drawer that opens automatically when something needs attention.

If the cloud version changes after a card appeared, Keep this device does not overwrite it unseen. The card switches to the current cloud version, opens the comparison, and asks you to choose again. The same happens if it changes while the confirmation step is open: your choice is not applied to a version you had not seen.

Folder-backed workspaces are more conservative. If the same page is edited in multiple sessions or changed externally at the same time, Aurora can pause the import/write and ask you to keep the local version or apply the folder version.

Backups ​

Use AuroraBak backups for a full restore, and Markdown or HTML export only when you want readable plaintext files. See Version history & backups and Import & export.

Aurora is in public beta and free while beta.