How moddroid94/stlvault works
STLVault is a web-based library manager for 3D-printable models. A user organizes a collection through the frontend, which calls the FastAPI backend for model and folder operations; the backend persists metadata in SQLite and model files in storage. The interface also supports URL imports, print groups, manuals, settings, search, slicer launching, and 3D previews. Edges reflect shown imports/calls or README-documented capabilities; some backend routes and persistence details are only partially excerpted.
Main entry points: App.tsx App coordinator · app.py REST API · api.ts API client · ModelList.tsx Model list
Components 20
Library interface
- App coordinator
frontend/App.tsx - Folder navigation
frontend/components/Sidebar.tsx - Model list
frontend/components/ModelList.tsx - Model details
frontend/components/DetailPanel.tsx - Navigation bar
frontend/components/Navbar.tsx - Settings
frontend/components/Settings.tsx
Model workflows
- Manual editor
frontend/components/ManualModal.tsx - 3D viewer
frontend/components/Viewer3D.tsx - STEP loader
frontend/components/STEPLoader.tsx - Thumbnail generator
frontend/services/thumbnailGenerator.ts - Print group view
frontend/services/modelGroupView.ts
Backend services
- API client
frontend/services/api.ts - REST API
backend/app.py - Printables importer
backend/importers/printables.py - MakerWorld importer
backend/importers/makerworld.py
Persistence and files
- SQLite database
backend/app.py - Model and manual files
backend/app.py
Other components
- Library user
- Printables service
- MakerWorld service
Connections 23
- Library user → App coordinator: uses
README.md - App coordinator → Folder navigation: renders
frontend/App.tsx - App coordinator → Model list: renders
frontend/App.tsx - App coordinator → Model details: renders
frontend/App.tsx - App coordinator → Navigation bar: renders
frontend/App.tsx - App coordinator → Settings: renders
frontend/App.tsx - App coordinator → Manual editor: renders
frontend/App.tsx - App coordinator → API client: calls
frontend/App.tsx - App coordinator → Thumbnail generator: generates thumbnails
frontend/App.tsx - Model details → 3D viewer: renders
frontend/components/DetailPanel.tsx - Model details → Thumbnail generator: generates thumbnails
frontend/components/DetailPanel.tsx - 3D viewer → STEP loader: loads STEP
frontend/components/Viewer3D.tsx - Thumbnail generator → STEP loader: loads STEP
frontend/services/thumbnailGenerator.ts - Model list → Print group view: uses
frontend/services/modelGroupView.ts - Model list → API client: gets slicer settings
frontend/components/ModelList.tsx - Manual editor → API client: loads manual URL
frontend/components/ManualModal.tsx - API client → REST API: sends API requests
README.md - REST API → SQLite database: reads and writes
backend/app.py - REST API → Model and manual files: stores and serves
backend/app.py - REST API → Printables importer: dispatches import
backend/app.py - REST API → MakerWorld importer: dispatches import
backend/app.py - Printables importer → Printables service: requests model data
backend/importers/printables.py - MakerWorld importer → MakerWorld service: imports from