---

title: "Persistence" last_updated: 2026-03-21 #

Source of Truth #

Document bytes live on disk inside user-selected locations.

SQLite stores derived/indexed data and app settings.

Backend Persistence #

Persistence is backend-owned (crates/store and src-tauri commands).

Frontend persists settings through Tauri commands rather than local browser persistence middleware.

SQLite Data #

Store location: app data directory under app identifier org.stormlightlabs.commonplace.

Key persisted domains:

• locations
• indexed document metadata
• search index data
• app settings (UI layout, style check, global capture)
• kv state (sidebar expanded locations and expanded directories)
• session restore metadata (last opened document)

Filesystem Access Scope #

Tauri uses dialog + fs plugins plus persisted scope support.

When locations are added, access is scoped and persisted to support reopening and syncing in future launches.

Save Strategy #

Document saves are backend-handled and designed to be safe under partial failures. Index refresh and sidebar refresh follow save completion.