How swayaa/hows works
Hows is a local Windows-first Steps Recorder successor: the user starts capture, reviews and annotates the resulting guide, then saves or exports it. The desktop path runs through the Svelte editor and Tauri commands into a recorder worker and capture/session core; guides use the documented .steps format. Exporting is available in the app, while steps-cli also exports existing guides and builds guides from scripts. The graph preserves documented CLI and settings capabilities; unsampled implementation links are omitted where the excerpts do not establish them.
Main entry points: commands.rs Tauri commands · App.svelte Editor shell · recorder.rs Recorder worker · lib.rs Steps storage
Components 18
Desktop experience
- Editor shell
app/src/App.svelte - Annotation tools
app/src/AnnotateStage.svelte - Annotation geometry
app/src/annotate.ts - Settings screen
app/src/SettingsPage.svelte
Capture runtime
- Tauri commands
app/src-tauri/src/commands.rs - Recorder worker
app/src-tauri/src/recorder.rs - Capture window
app/src-tauri/src/capture_window.rs - Local settings
app/src-tauri/src/settings.rs - Platform capture
core/capture/src/lib.rs - Recording session
core/session/src/lib.rs - Step text templates
core/session/src/texts.rs
Guide data
- Guide model
core/store/src/model.rs - Steps storage
core/store/src/lib.rs - .steps guide
Export and CLI
- Export engine
core/export/src/lib.rs - PDF renderer
core/export/src/pdf.rs - steps-cli
core/cli/src/main.rs
Other components
- Guide author
Connections 21
- Guide author → Editor shell: starts capture
README.md - Editor shell → Tauri commands: invokes commands
app/src/App.svelte - Tauri commands → Recorder worker: controls recording
app/src-tauri/src/commands.rs - Recorder worker → Recording session: runs session
app/src-tauri/src/recorder.rs - Recorder worker → Platform capture: captures input
- Platform capture → Recording session: supplies events
- Recording session → Step text templates: generates text
core/session/src/lib.rs - Tauri commands → Capture window: syncs capture UI
app/src-tauri/src/commands.rs - Tauri commands → Local settings: loads and saves
app/src-tauri/src/commands.rs - Settings screen → Tauri commands: updates settings
app/src/SettingsPage.svelte - Guide author → Annotation tools: edits screenshots
README.md - Editor shell → Annotation tools: renders editor stage
app/src/App.svelte - Annotation tools → Annotation geometry: uses geometry
app/src/AnnotateStage.svelte - Guide author → .steps guide: saves guide
README.md - Steps storage → Guide model: uses data model
core/store/src/lib.rs - Steps storage → .steps guide: reads and writes
- Editor shell → Export engine: exports guide
README.md - Export engine → PDF renderer: renders PDF
core/export/src/lib.rs - steps-cli → Steps storage: opens guides
- steps-cli → Export engine: exports formats
README.md - Guide author → steps-cli: runs scripts
README.md