How rackulalives/rackula works
Rackula is a drag-and-drop rack-layout designer: users build and arrange rack equipment, then save, share, or export layouts. The graph follows that workflow from the application shell through editing and persistence, and includes the documented NetBox import, image assets, and server-backed storage branches. Source excerpts are partial; several product capabilities are therefore connected only where the README documents them, and unsampled implementation details are not inferred.
Main entry points: App.svelte Application shell · driver.ts Storage driver · app.ts API application · Canvas.svelte Rack canvas
Components 23
Application interface
- Application shell
src/App.svelte - Toolbar and actions
src/lib/components/Toolbar.svelte - Dialog orchestration
src/lib/components/DialogOrchestrator.svelte
Layout editing
- Rack canvas
src/lib/components/Canvas.svelte - Layout state
src/lib/stores/layout.svelte.ts - Layout commands
src/lib/stores/commands/index.ts - Placement collision
src/lib/utils/collision.ts - Hardware library
src/lib/data/starterLibrary.ts - NetBox import
src/lib/utils/netbox-import.ts - Bundled device images
src/lib/data/bundledImages.ts
Persistence and output
- Layout export
src/lib/utils/export/index.ts - Layout sharing
src/lib/utils/share.ts - Storage manager
src/lib/storage/manager.svelte.ts - Layout load pipeline
src/lib/storage/load-pipeline.ts - Server storage client
src/lib/storage/api.ts
API and service storage
- API application
api/src/app.ts - Auth and security
api/src/security/index.ts - Layout routes
api/src/routes/layouts.ts - Asset routes
api/src/routes/assets.ts - Storage driver
api/src/storage/driver.ts - Filesystem backend
api/src/storage/filesystem.ts - R2 backend
api/src/storage/r2-driver.ts
Other components
- Rack planner
Connections 23
- Rack planner → Application shell: plans racks
README.md - Application shell → Toolbar and actions: renders
src/App.svelte - Application shell → Dialog orchestration: renders
src/App.svelte - Application shell → Storage manager: loads workspace
src/App.svelte - Rack planner → Rack canvas: arranges equipment
README.md - Hardware library → Rack canvas: supplies devices
- Rack canvas → Layout state: edits layout
- Layout state → Layout commands: records edits
- Rack canvas → Placement collision: checks placement
- Rack planner → NetBox import: imports devices
README.md - Rack planner → Layout export: exports layout
README.md - Rack planner → Layout sharing: shares layout
README.md - Storage manager → Layout load pipeline: loads layouts
src/lib/storage/manager.svelte.ts - Layout load pipeline → Server storage client: loads saved copy
src/lib/storage/load-pipeline.ts - Server storage client → API application: requests layouts
- API application → Auth and security: configures security
api/src/app.ts - API application → Layout routes: mounts routes
api/src/app.ts - API application → Storage driver: selects backend
api/src/app.ts - Layout routes → Storage driver: uses storage
api/src/routes/layouts.ts - Asset routes → Storage driver: uses storage
- Storage driver → Filesystem backend: supports backend
api/src/storage/driver.ts - Storage driver → R2 backend: supports backend
api/src/storage/r2-driver.ts - Application shell → Bundled device images: uses device images