How chuanqisun/iter works
Iter is a browser-based Gen AI chat frontend for rapid prompt iteration. The main workflow is user input (including attachments or dictation), chat-tree orchestration to a selected provider, streamed response rendering, and Markdown preview with editable runnable artifacts. Settings manage provider connections and model parameters; storage supports saving and restoring chat history. The graph uses README and SOURCE INDEX relationships where available; unsampled implementation details are represented only when documented, and optional external integrations are marked dashed.
Main entry points: chat-tree.tsx Chat interface · preview-worker.ts Markdown renderer · auto-save-service.ts Auto-save history · restore-service.ts History restore
Components 19
Chat workflow
- Chat interface
src/chat-tree/chat-tree.tsx - Chat tree state
src/chat-tree/tree-store.ts
Models and settings
- Provider interface
src/providers/base.ts - Provider selection
src/providers/factory.ts - Provider adapters
src/providers - Connection settings
src/settings/settings-element.ts - Model parameters
src/settings/use-model-parameter-sync.ts
Rendering and artifacts
- Streaming preview
src/chat-tree/streaming-preview.tsx - Preview worker client
src/workers/worker-proxy.ts - Markdown renderer
src/workers/preview-worker.ts - Artifact editor
src/artifact/artifact-editor-element.ts - Run directives
src/artifact/lib/directives.ts
Persistence and input
- Attachments
src/chat-tree/attachment.ts - Speech input
src/voice/speech-recognition.ts - Auto-save history
src/storage/auto-save-service.ts - History restore
src/storage/restore-service.ts
Other components
- User
- Model APIs
- Browser storage
Connections 21
- User → Chat interface: sends input
- Chat interface → Chat tree state: updates tree
src/chat-tree/chat-tree.tsx - Chat interface → Attachments: handles files
src/chat-tree/chat-tree.tsx - Chat interface → Speech input: uses dictation
src/chat-tree/chat-tree.tsx - Chat interface → Provider interface: requests chat
src/chat-tree/chat-tree.tsx - Chat interface → Streaming preview: renders responses
src/chat-tree/chat-tree.tsx - Chat interface → Auto-save history: saves history
src/chat-tree/chat-tree.tsx - Chat interface → History restore: restores history
src/chat-tree/chat-tree.tsx - Provider interface → Provider selection: selects adapter
- Provider selection → Provider adapters: creates provider
- Provider adapters → Model APIs: sends requests
- Connection settings → Provider selection: uses providers
src/settings/settings-element.ts - Connection settings → Model parameters: syncs parameters
- Streaming preview → Preview worker client: renders markdown
src/chat-tree/streaming-preview.tsx - Preview worker client → Markdown renderer: dispatches render
src/workers/worker-proxy.ts - Markdown renderer → Artifact editor: emits artifact markup
- Markdown renderer → Run directives: supports runnable blocks
- Auto-save history → Chat tree state: reads tree
src/storage/auto-save-service.ts - History restore → Chat tree state: restores tree
src/storage/restore-service.ts - Auto-save history → Browser storage: stores history
- History restore → Browser storage: loads history