Skip to content

stores

Jump to bottom
github-actions[bot] edited this page Sep 16, 2026 · 5 revisions

Stores Reference

All Zustand state stores with their state shape and key actions. See Architecture for how stores relate to services.

Note Store (src/stores/noteStore.ts)

Purpose: Manages the notes collection, selection, filtering, and CRUD operations.

State:

  • notes: Note[] — all loaded notes
  • selectedNoteId: string | null — currently selected note
  • filter: NoteFilter — active filter (folder, tag, color, search)
  • sortOrder: SortOrder — current sort (updated, created, title, pin)
  • viewMode: 'list' | 'grid' — list vs grid display
  • isLoading: boolean
  • error: string | null

Key Actions: loadNotes, createNote, updateNote, deleteNote, selectNote, setFilter, setSortOrder

Todo Store (src/stores/todoStore.ts)

Purpose: Manages todo items, completion state, and filtering.

State:

  • todos: Todo[]
  • selectedTodoId: string | null
  • filter: TodoFilter
  • sortOrder: SortOrder
  • isLoading: boolean
  • error: string | null

Key Actions: loadTodos, createTodo, updateTodo, deleteTodo, toggleComplete, selectTodo

Canvas Store (src/stores/canvasStore.ts)

Purpose: Manages canvas documents and their local-first document lifecycle.

State:

  • canvases: Canvas[]
  • isLoading: boolean
  • error: string | null

Key Actions: loadCanvases, createCanvas, updateCanvas, deleteCanvas, refreshCanvases, clearError

Chat Store (src/stores/chatStore.ts)

Purpose: Manages AI chat threads and messages.

State:

  • threads: ChatThreadSummary[] — loaded thread summaries
  • activeThread: ChatThread | null — currently open thread (null if none)
  • isLoading: boolean
  • error: string | null
  • isStreaming: boolean
  • storageAdapter: ChatStorageAdapter | null

Key Actions: loadThreads, loadThread, createThread, deleteThread, renameThread, addMessage, updateMessage, removeMessage, truncateAfter, setStreaming, clearActiveThread, clearError, setStorageAdapter

Repo Store (src/stores/repoStore.ts)

Purpose: Manages the repository collection, selected repo, and sync state.

State:

  • repos: Repo[]
  • selectedRepoId: string | null
  • syncState: SyncState — 'idle' | 'syncing' | 'error'
  • lastSyncAt: number | null
  • pendingChanges: number

Key Actions: loadRepos, addRepo, removeRepo, selectRepo, triggerSync

AI Store (src/stores/aiStore.ts)

Purpose: Configures the active AI provider, model, and chat context.

State:

  • provider: AIProvider | null
  • model: string
  • chatRepoOwner: string | null
  • chatRepoName: string | null
  • isConfigured: boolean

Key Actions: setProvider, setModel, setChatContext

Pro Store (src/stores/proStore.ts)

Purpose: Manages Pro subscription state, entitlements, and paywall display.

State:

  • status: 'loading' | 'pro' | 'free'
  • entitlementActive: boolean
  • trialActive: boolean
  • trialEndsAt: number | null
  • entitlementExpiresAt: number | null
  • offeringsReady: boolean
  • monthlyPackage: PurchasesPackage | null
  • yearlyPackage: PurchasesPackage | null
  • lifetimePackage: PurchasesPackage | null
  • currentOffering: PurchasesOffering | null
  • isPurchasing: boolean
  • isRestoring: boolean
  • error: string | null
  • interstitialEligible: boolean
  • configured: boolean

Key Actions:

  • initialize — configures RevenueCat and resolves entitlement
  • refresh — re-fetches customer info
  • purchaseMonthly, purchaseYearly, purchaseLifetime
  • restore — restores purchases from App Store
  • loadOfferingsIfNeeded
  • markInterstitialShown
  • bindAccount, unbindAccount

DEV_FORCE_PRO: In __DEV__ on iOS Simulator, Pro gate is forced open via EXPO_PUBLIC_FORCE_ENABLE_PRO_ON_SIMULATOR env var for QA testing without real IAP.

Account Store (src/stores/accountStore.ts)

Purpose: Manages user accounts (GitHub, GitLab, etc.) and authentication tokens.

State:

  • accounts: Account[]
  • activeAccountId: string | null

Key Actions: addAccount, removeAccount, setActiveAccount

Folder Store (src/stores/folderStore.ts)

Purpose: Manages folder tree and folder selection for note organization.

State:

  • folders: Folder[]
  • selectedFolderPath: string | null
  • expandedFolderIds: string[]

Key Actions: loadFolders, createFolder, deleteFolder, selectFolder

Reminder Store (src/stores/reminderStore.ts)

Purpose: Manages scheduled reminders for notes and todos.

State:

  • reminders: Reminder[]
  • isLoading: boolean

Key Actions: loadReminders, createReminder, deleteReminder, snoozeReminder

Template Store (src/stores/templateStore.ts)

Purpose: Manages note templates.

State:

  • templates: Template[]
  • isLoading: boolean

Key Actions: loadTemplates, createTemplate, deleteTemplate, applyTemplate

Render Style Store (src/stores/renderStyleStore.ts)

Purpose: Manages per-note render style preferences (markdown, rich text, plaintext).

State:

  • defaultStyle: RenderStyle
  • perNoteOverrides: Record<string, RenderStyle>

Key Actions: setDefaultStyle, setNoteOverride

Conflict Store (src/stores/conflictStore.ts)

Purpose: Manages sync conflicts requiring user resolution.

State:

  • conflicts: Conflict[]
  • selectedConflictId: string | null
  • isResolving: boolean

Key Actions: loadConflicts, resolveConflict, dismissConflict

Git Activity Store (src/stores/gitActivityStore.ts)

Purpose: Tracks recent git operations for display in the UI.

State:

  • recentCommits: Commit[]
  • recentPushes: Push[]
  • unpushedCount: number

Key Actions: recordCommit, recordPush, clearHistory

Floating Git Button Store (src/stores/floatingGitButtonStore.ts)

Purpose: Controls visibility and state of the floating git sync button.

State:

  • visible: boolean
  • hydrated: boolean
  • unpushedCount: number

Key Actions: show, hide, hydrate

Git Operation Store (src/stores/gitOperationStore.ts)

Purpose: Tracks in-flight git operations for progress display.

State:

  • operations: GitOperation[]
  • isAnyRunning: boolean

Key Actions: startOperation, endOperation, cancelOperation

Draft Store (src/stores/draftStore.ts)

Purpose: Stores unsaved edits as drafts for recovery.

State:

  • drafts: Record<string, string> — noteId → draft content
  • lastSavedAt: Record<string, number>

Key Actions: saveDraft, loadDraft, clearDraft

AI Hub Store (src/stores/aiHubStore.ts)

Purpose: Manages AI Hub (multi-provider AI chat) state and picker visibility.

State:

  • pickerVisible: boolean
  • selectedProviders: AIProvider[]

Key Actions: openPicker, closePicker, selectProvider

GitHub Activity Store (src/stores/githubActivityStore.ts)

Purpose: Tracks GitHub notifications and activity for the Explore screen.

State:

  • notifications: GitHubNotification[]
  • lastFetchedAt: number | null

Key Actions: fetchNotifications, markRead

Git Button Action Store (src/stores/gitButtonActionStore.ts)

Purpose: Queues actions triggered by the floating git button (push, pull, sync).

State:

  • queuedAction: GitButtonAction | null
  • isHolding: boolean
  • holdProgress: number

Key Actions: queueAction, setHolding, setProgress

See Also

  • Services — Business logic layer that updates stores
  • Architecture — Overall data flow
  • Screens — UI components that consume stores

Clone this wiki locally