How crafter-station/muelle works
Muelle is a Windows taskbar-replacement dock with an optional menu bar and a separate Settings app. The main workflow is Windows shell/window state → dock presentation and interaction → launch, pin, minimize/restore, or file-drop actions. Supporting stages cover shared configuration, animation/layout, status and AI-usage display, and taskbar recovery. Paths and relationships are grounded in the README and shown source/index references; some feature internals are unsampled, so their edges are documented or omitted rather than inferred.
Main entry points: app.rs Dock lifecycle · App.tsx Settings interface · main.rs Dock startup · scene.rs Dock rendering
Components 24
Dock experience
- Dock lifecycle
apps/dock/src/app.rs - Dock startup
apps/dock/src/main.rs - Dock rendering
apps/dock/src/scene.rs - Graphics surfaces
apps/dock/src/gfx.rs - File drop
apps/dock/src/drop.rs - Window previews
apps/dock/src/thumbnails.rs - Minimize animation
apps/dock/src/flight.rs
Windows shell
- Window tracking
crates/muelle-shell/src/tracker.rs - App launching
crates/muelle-shell/src/launcher.rs - Pinned apps
crates/muelle-shell/src/pins.rs - Windows system queries
crates/muelle-shell/src/system.rs - Taskbar watchdog
crates/muelle-shell/src/watch.rs
Layout and animation
- Dock layout
crates/muelle-core/src/layout.rs - Icon magnification
crates/muelle-core/src/magnify.rs - Genie animation
crates/muelle-core/src/genie.rs - Window roster
crates/muelle-core/src/roster.rs
Menu bar and usage
- Menu bar
apps/dock/src/menubar.rs - Provider usage
apps/dock/src/usage.rs
Settings and configuration
- Settings interface
apps/settings/src/App.tsx - Settings backend
apps/settings/src-tauri/src/main.rs - Shared configuration
crates/muelle-config/src/lib.rs
Other components
- User
- GitHub Releases
- AI providers
Connections 24
- User → Dock startup: starts
- Dock startup → Dock lifecycle: runs
apps/dock/src/main.rs - Dock lifecycle → Dock rendering: renders
apps/dock/src/app.rs - Dock rendering → Graphics surfaces: draws with
apps/dock/src/scene.rs - Dock lifecycle → Minimize animation: animates windows
apps/dock/src/app.rs - Dock lifecycle → Window previews: shows thumbnails
- Dock lifecycle → File drop: accepts drops
apps/dock/src/drop.rs - Dock lifecycle → Dock layout: positions icons
- Dock lifecycle → Icon magnification: magnifies icons
- Dock lifecycle → Genie animation: uses animation
- Dock lifecycle → Window tracking: tracks windows
- Dock lifecycle → App launching: launches apps
- Dock lifecycle → Pinned apps: manages pins
- Dock startup → Taskbar watchdog: starts guard
apps/dock/src/main.rs - Dock startup → Windows system queries: uses shell queries
- User → Menu bar: views status
- Menu bar → Provider usage: shows quotas
- Provider usage → AI providers: queries optionally
- User → Settings interface: changes preferences
- Settings interface → Settings backend: uses Tauri backend
- Settings interface → Shared configuration: loads and saves
apps/settings/src/App.tsx - Settings backend → Shared configuration: shares settings
- Settings interface → Dock lifecycle: applies live changes
- Settings interface → GitHub Releases: checks optionally