How haisenberg-creator/vault works
Vault is a local-first Markdown and task-management desktop app. Users navigate a workspace, open and edit Markdown notes, and track checklist tasks in folder-scoped YAML dashboards; changes are stored as ordinary files through Tauri. The graph also includes settings, session persistence, shortcuts, and archive/export capabilities documented in the repository. Several component and backend excerpts were not sampled, so links between those areas are shown only where supported by the README or sampled imports and calls.
Main entry points: DualColumnLayout.tsx Dual-column layout · fileService.ts File operations · App.tsx App bootstrap · TaskDashboardSidebar.tsx Workspace sidebar
Components 21
Application shell
- App bootstrap
src/App.tsx - Dual-column layout
src/components/layout/DualColumnLayout.tsx - Session persistence
src/services/sessionService.ts
Workspace and notes
- Workspace sidebar
src/components/sidebar/TaskDashboardSidebar.tsx - File tree navigation
src/components/sidebar/SidebarTree.tsx - Markdown editor
src/components/editor/EditorPane.tsx - Interactive checklists
src/components/editor/ChecklistNode.tsx - File operations
src/services/fileService.ts - Archive export
src/components/sidebar/ExportArchiveModal.tsx
Tasks and dashboards
- Dashboard queries
src/services/dashboardService.ts - Dashboard views
src/components/dashboard/DashboardView.tsx - Task widgets
src/components/dashboard/DashboardSectionWidget.tsx - Task Markdown operations
src/services/workspaceService.ts
Desktop and preferences
- Tauri commands
src-tauri/src/lib.rs - Settings interface
src/components/settings/SettingsModal.tsx - Theme preferences
src/services/themeService.ts - Global shortcuts
src/services/globalShortcutService.ts - Shortcut hook
src/hooks/useGlobalShortcuts.ts - Update notification
src/components/ui/UpdateNotification.tsx
Other components
- Vault user
- Local workspace files
Connections 21
- Vault user → App bootstrap: opens
- App bootstrap → File operations: requests workspace
- App bootstrap → Dual-column layout: renders
- Dual-column layout → Workspace sidebar: shows navigation
- Dual-column layout → Markdown editor: shows editor
- Workspace sidebar → File operations: loads and changes files
- Markdown editor → File operations: reads and saves notes
- Markdown editor → Interactive checklists: renders tasks
- File operations → Tauri commands: invokes filesystem commands
- Tauri commands → Local workspace files: reads and writes
- Workspace sidebar → Dashboard queries: extracts task metadata
- Dashboard views → Dashboard queries: queries dashboard tasks
- Dashboard views → Task widgets: renders sections
- Dashboard queries → Task Markdown operations: uses task parsing
- Task Markdown operations → Interactive checklists: gets task state
- Archive export → File operations: exports workspace archive
- Dual-column layout → Session persistence: persists workspace state
- Settings interface → Theme preferences: changes appearance
- Shortcut hook → Global shortcuts: registers shortcuts
- Dual-column layout → Shortcut hook: enables shortcuts
- App bootstrap → Update notification: displays updates