How storytold/lightcraft works
LightCraft is a cross-platform photo library and non-destructive RAW developer, with native, browser, CLI, and MCP entry points. The main user workflow is to import or open photos, organize and search a catalog, adjust images, then preview or export results. The graph preserves documented editing, masking, color, AI-agent, and multi-platform capabilities. Several links between app layers are dashed because the sampled excerpts do not show their runtime wiring; unsampled subsystems are represented only where the tree and README establish their role.
Main entry points: mod.rs Engine commands · lib.rs Web app · query.rs Search and sort · media.rs Decode and previews
Components 23
App entry points
- Desktop app
apps/lightcraft/src/main.rs - Web app
apps/lightcraft-web/src/lib.rs - CLI
apps/lightcraft-cli/src/main.rs - Engine commands
crates/engine/src/cmd/mod.rs
Photo library
- Catalog model
crates/catalog/src/model.rs - Search and sort
crates/catalog/src/query.rs - Keywords
crates/catalog/src/keywords.rs - Folders and albums
crates/catalog/src/folders.rs - Catalog rules
crates/catalog/src/rules.rs - Photo import
crates/engine/src/import.rs - File operations
crates/engine/src/files.rs - Browser storage
apps/lightcraft-web/src/store.rs
Image development
- Decode and previews
crates/engine/src/media.rs - Image codecs
crates/codecs/src/lib.rs - Develop settings
crates/develop/src/lib.rs - Develop pipeline
crates/pipeline/src/lib.rs - GPU rendering
crates/gpu/src/render.rs - Image export
crates/engine/src/export.rs - Denoising
crates/denoise/src/lib.rs - Render workers
apps/lightcraft-web/src/workers.rs
AI and services
- MCP server
crates/mcp/src/server.rs - Face recognition
crates/faces/src/lib.rs
Other components
- Photographer
Connections 22
- Photographer → Desktop app: edits photos
README.md - Photographer → Web app: edits photos
README.md - Desktop app → Engine commands: dispatches commands
- Web app → Engine commands: dispatches commands
- CLI → Engine commands: runs commands
- MCP server → Engine commands: exposes tools
- Engine commands → Photo import: imports photos
- Photo import → Catalog model: records photos
- Engine commands → Search and sort: queries catalog
- Search and sort → Folders and albums: uses folder filters
crates/catalog/src/query.rs - Search and sort → Catalog rules: uses rules
crates/catalog/src/query.rs - Search and sort → Keywords: uses keywords
crates/catalog/src/query.rs - Engine commands → Decode and previews: requests previews
- Decode and previews → Image codecs: decodes images
- Decode and previews → Denoising: uses denoising
crates/engine/src/media.rs - Decode and previews → Face recognition: supports face work
- Engine commands → Develop settings: sets adjustments
- Develop settings → Develop pipeline: configures rendering
- Develop pipeline → GPU rendering: renders on GPU
- Engine commands → Image export: exports results
- Web app → Browser storage: persists data
- Web app → Render workers: dispatches renders
apps/lightcraft-web/src/workers.rs