How ptsfdtz/litemark works
LiteMark is a Tauri desktop Markdown editor. The main workflow is opening or creating a workspace document, editing Markdown, previewing it live, and saving it safely; workspace browsing, export, settings, themes, and an optional AI agent are additional capabilities. The graph preserves the agent’s UI-to-runtime stages and document persistence boundaries. Some links are grounded only in README or SOURCE INDEX references; unsampled modules are not treated as inspected.
Main entry points: Layout.tsx Workspace layout · Editor.tsx Markdown editor · run.rs Agent orchestration · lib.rs Tauri runtime
Components 29
App shell
- Application shell
src/App.tsx - Workspace layout
src/components/Layout/Layout.tsx - Editing toolbar
src/components/Toolbar/Toolbar.tsx - Settings & themes
src/components/Settings/Settings.tsx - Theme persistence
src/utils/themeStore.ts
Documents & workspace
- Document session
src/modules/documentSession/useDocumentSession.ts - Tauri document adapter
src/modules/documentSession/tauriDocumentSession.ts - File explorer
src/components/FileExplorer/FileExplorer.tsx - Directory operations
src/modules/directoryTree.ts - Recent documents
src/utils/recentStore.ts
Writing & preview
- Markdown editor
src/components/Editor/Editor.tsx - Markdown editing rules
src/modules/markdownEditing/markdownTransforms.ts - Live preview
src/components/Preview/Preview.tsx - Document export
src/modules/exportDocument.ts - Image preview
src/components/Editor/ImagePreview.tsx - PDF preview
src/components/Editor/PdfPreview.tsx
AI agent
- Agent panel
src/components/AgentPanel/AgentPanel.tsx - Agent session
src/modules/agent/useAgentSession.ts - Conversation history
src/modules/agent/useAgentConversations.ts - Agent client
src/modules/agent/agentClient.ts - Agent protocol
src-tauri/src/agent/protocol.rs - Agent orchestration
src-tauri/src/agent/run.rs - Agent tools
src-tauri/src/agent/tools/mod.rs - Filesystem tools
src-tauri/src/agent/tools/filesystem.rs - Workspace search
src-tauri/src/agent/tools/search.rs - Change checkpoints
src-tauri/src/agent/repository.rs
Tauri services
- Document storage
src-tauri/src/document_storage.rs - Tauri runtime
src-tauri/src/lib.rs
Other components
- Writer
Connections 32
- Writer → Application shell: opens app
README.md - Application shell → Workspace layout: renders
src/App.tsx - Workspace layout → Editing toolbar: renders
src/components/Layout/Layout.tsx - Workspace layout → Settings & themes: renders
src/components/Layout/Layout.tsx - Workspace layout → Document session: manages documents
src/components/Layout/Layout.tsx - Workspace layout → File explorer: renders
src/components/Layout/Layout.tsx - Workspace layout → Directory operations: lists workspace
src/components/Layout/Layout.tsx - Workspace layout → Theme persistence: saves theme
src/components/Layout/Layout.tsx - Document session → Tauri document adapter: uses storage adapter
src/modules/documentSession/tauriDocumentSession.ts - Tauri document adapter → Recent documents: updates recents
src/modules/documentSession/tauriDocumentSession.ts - Tauri document adapter → Tauri runtime: invokes native storage
- Tauri runtime → Document storage: uses storage
src-tauri/src/lib.rs - Workspace layout → Markdown editor: renders
src/components/Layout/Layout.tsx - Markdown editor → Markdown editing rules: applies transforms
- Workspace layout → Live preview: renders
src/components/Layout/Layout.tsx - Workspace layout → Document export: exports document
src/components/Layout/Layout.tsx - Markdown editor → Image preview: shows images
- Markdown editor → PDF preview: shows PDFs
- Workspace layout → Agent panel: hosts agent
src/components/Layout/Layout.tsx - Agent panel → Agent session: drives session
src/components/AgentPanel/AgentPanel.tsx - Agent panel → Conversation history: manages conversations
src/components/AgentPanel/AgentPanel.tsx - Agent session → Agent client: runs turns
src/modules/agent/useAgentSession.ts - Agent client → Tauri runtime: invokes agent commands
- Tauri runtime → Agent orchestration: registers agent runtime
src-tauri/src/lib.rs - Agent orchestration → Agent protocol: uses event protocol
- Agent orchestration → Agent tools: dispatches tools
- Agent tools → Filesystem tools: dispatches filesystem
- Agent tools → Workspace search: dispatches search
- Filesystem tools → Document storage: uses document storage
src-tauri/src/agent/tools/filesystem.rs - Workspace search → Document storage: uses document storage
src-tauri/src/agent/tools/search.rs - Agent orchestration → Change checkpoints: records changes
- Change checkpoints → Document storage: reads and restores files
src-tauri/src/agent/repository.rs