How tonykastaneda/amalith works
Amalith is a cross-platform vector-design application centered on an infinite-pasteboard document model and a shared undoable command engine. The principal workflow is a designer editing artwork in the native shell; every mutation goes through the Editor, which applies reversible edits to the document. The repository also includes file-format support, scripting/automation, adjustment processing, and a separately presented marketing website. Several subsystem links below rely on README documentation; unsampled implementations are not inferred beyond those documented capabilities.
Main entry points: editor.rs Command editor · mod.rs Desktop shell · app.rs Script host API · document.rs Document model
Components 24
Native editor
- Desktop shell
crates/amalith-shell/src/app/mod.rs - Canvas tools
crates/amalith-shell/src/canvas.rs - Selection tools
crates/amalith-shell/src/select.rs - Text editing
crates/amalith-shell/src/textedit.rs - Canvas rendering
crates/amalith-shell/src/app/render/mod.rs
Document and editing
- Command editor
crates/amalith-commands/src/editor.rs - Command vocabulary
crates/amalith-commands/src/command.rs - Reversible edits
crates/amalith-commands/src/edit.rs - Undo history
crates/amalith-commands/src/history.rs - Path operations
crates/amalith-commands/src/pathfinder.rs - Document model
crates/amalith-core/src/document.rs - Artwork objects
crates/amalith-core/src/object.rs
Files and rendering
- Document formats
crates/amalith-io/src/lib.rs - SVG support
crates/amalith-io/src/svg.rs - Illustrator support
crates/amalith-io/src/ai.rs - Color adjustments
crates/amalith-adjust/src/color.rs - GPU adjustment jobs
crates/amalith-shell/src/adjust/engine.rs
Automation
- Script engine
crates/amalith-script/src/engine.rs - Script host API
crates/amalith-script/src/host/app.rs - Script file access
crates/amalith-script/src/host/fileio.rs
Website
- Marketing pages
website/app/page.tsx - Downloads page
website/app/downloads/page.tsx
Other components
- Designer
- Website visitor
Connections 23
- Designer → Desktop shell: uses
README.md - Desktop shell → Command editor: issues commands
README.md - Designer → Canvas tools: draws and edits
README.md - Canvas tools → Command editor: submits mutations
README.md - Selection tools → Command editor: submits mutations
README.md - Text editing → Command editor: submits mutations
README.md - Desktop shell → Canvas rendering: renders editor
- Command editor → Command vocabulary: executes commands
crates/amalith-commands/src/editor.rs - Command editor → Reversible edits: applies edits
crates/amalith-commands/src/editor.rs - Command editor → Undo history: records history
crates/amalith-commands/src/editor.rs - Reversible edits → Document model: mutates document
crates/amalith-commands/src/edit.rs - Document model → Artwork objects: owns artwork
crates/amalith-core/src/document.rs - Command editor → Path operations: dispatches operations
crates/amalith-commands/src/editor.rs - Desktop shell → Document formats: saves and loads
README.md - Document formats → Document model: serializes document
README.md - Desktop shell → SVG support: imports SVG
README.md - Desktop shell → Illustrator support: imports Illustrator SVG
README.md - GPU adjustment jobs → Color adjustments: uses color LUT
crates/amalith-shell/src/adjust/engine.rs - Script engine → Script host API: registers host globals
crates/amalith-script/src/engine.rs - Script host API → Command editor: issues commands
- Script host API → Script file access: exposes file access
crates/amalith-script/src/host/app.rs - Website visitor → Marketing pages: browses
README.md - Marketing pages → Downloads page: links downloads
website/app/page.tsx