Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
4ef94e1
added material-ui as dependency
moddroid94 Jan 14, 2026
eac731d
migrated folders to Material UI
moddroid94 Jan 14, 2026
a2b2287
migrated search and sort to Material UI
moddroid94 Jan 14, 2026
811373f
migrated header section of model list to Material UI
moddroid94 Jan 14, 2026
12ea4a1
Added Material UI X as dependency
moddroid94 Jan 15, 2026
a9e6070
migrated header and folder form to Material UI
moddroid94 Jan 15, 2026
58f902b
completed migration of sidebar to Material UI
moddroid94 Jan 17, 2026
a630242
Updated dashboard preview to new MUI interface
moddroid94 Jan 17, 2026
6ecafd0
change sidebar icons color to secondary
moddroid94 Jan 17, 2026
792dcfc
migrated detail panel to Material UI
moddroid94 Jan 17, 2026
f7dfb23
Update screenshots in README.md
moddroid94 Jan 17, 2026
ef8f6a7
added source filename to info
moddroid94 Jan 17, 2026
439e9d1
Added API Host missing error
moddroid94 Jan 17, 2026
40d5938
implemented STEP preview and Thumbnail
moddroid94 Jan 18, 2026
46cf7a8
fixed select all button not respecting search filtration (now selects…
moddroid94 Jan 18, 2026
13a0222
fixed function type in component
moddroid94 Jan 18, 2026
d68810e
Material UI Refactor and STEP Support
moddroid94 Jan 18, 2026
c05fb8e
Add STEP file support to 3D Preview feature
moddroid94 Jan 18, 2026
801eb3d
feat(frontend): added orbit control switch to allow of full rotation …
moddroid94 Jan 22, 2026
dae12f6
updated readme roadmap and features
moddroid94 Jan 22, 2026
db5bab0
added folder name in model list
moddroid94 Jan 22, 2026
83abb8c
Feat(frontend): Added Generate Thumbnail from 3Dviewer and integrated…
moddroid94 Jan 22, 2026
ed73bdf
fix(frontend):improved handling of file editing to avoid extension ch…
moddroid94 Jan 22, 2026
4bbe08f
feat(frontend): implemented Back to Parent folder button (not history…
moddroid94 Jan 22, 2026
27fb684
Add custom thumbnail generation feature
moddroid94 Jan 24, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 17 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@
[![Docker Frontend CI](https://img.shields.io/github/actions/workflow/status/moddroid94/STLVault/Docker%20Backend%20CI.yml?style=for-the-badge&logo=docker&label=Backend)](https://github.com/moddroid94/STLVault/actions/workflows/Docker%20Backend%20CI.yml)
[![Docker Pulls](https://img.shields.io/docker/pulls/moddroid94/stlvault-frontend?style=for-the-badge&logo=docker)](https://hub.docker.com/u/moddroid94)


![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)

**STLVault** is a containerized 3D Model library manager and organizer, designed specifically for 3D printing enthusiasts. It provides a clean, modern web interface to manage your growing collection of STL, STEP, and 3MF files.
Expand All @@ -25,7 +26,8 @@
- **🔗 URL Import:** Import multiple files from Printables URL, with granular file selection. (Only models URL)
- **🖱️ Drag n' Drop:** Seamlessly import new models or move files between folders.
- **📦 Bulk Actions:** Tag, move, delete, download, or upload multiple files at once.
- **👁️ 3D Preview:** Integrated web-based 3D viewer for STL and 3MF files.
- **👁️ 3D Preview:** Integrated web-based 3D viewer for STL, 3MF, STEP and STP files, with Trackball/Orbit controls switch to allow full rotational freedom (beta)
- **🖼️ Custom Thumbnails:** Generate a thumbnail of the model from the 3D viewer directly or upload an image to be shown as a thumbnail.
- **🏷️ Metadata Management:** Add tags, descriptions, and metadata to your models for easy retrieval.
- **🔍 Global Search:** Sidebar search and filtering to find models library-wide.

Expand All @@ -43,10 +45,10 @@

## 📸 Screenshots

![Dashboard Preview](https://github.com/user-attachments/assets/3d8aa851-392c-4bd0-8819-2a802ec63e2c)
![Setting Page](https://github.com/user-attachments/assets/f1326a8c-3ef0-4b17-be5a-e75aea2cb59a)
![Upload Modal Preview](https://github.com/user-attachments/assets/34f995d3-bc09-489f-92f3-1408bf0196a0)
![Model Viewer/Info Preview](https://github.com/user-attachments/assets/ac373cf5-3952-4336-8b56-e2864127c3aa)
![Dashboard Preview](https://github.com/user-attachments/assets/33be62e6-d7fd-455b-9ef1-e1d363bff6f8)
![Model Viewer/Info Preview](https://github.com/user-attachments/assets/db0c4141-51f6-408d-a6c5-9b3df20a3fc7)![ModelViewer2](https://github.com/user-attachments/assets/dc470ef9-0cf3-4f08-b60d-3985d2461576)
![Setting Page](https://github.com/user-attachments/assets/23c703ce-73b0-43bb-9ff4-f4a64c5f7147)


---

Expand Down Expand Up @@ -138,18 +140,22 @@ The application requires two main volumes to persist data. If you are using the
- `/backend/uploads`: Stores your actual 3D model files.
- `/backend/data`: Stores the SQLite database file.

> **Tip:** If deploying on a NAS or server, map `/backend/uploads` to your existing 3D model library folder to ingest them (import functionality may be required).

---

## 🗺️ Roadmap

- [x] Basic File Management (Upload, Move, Delete)
- [x] 3D Viewer (STL, 3MF)
- [x] 3D Viewer (STL, 3MF, STEP)
- [x] Open in Slicer settings
- [ ] Thumbnails / 3D viewer for STEP
- [x] Model import via Printables URL
- [ ] User Authentication
- [x] Thumbnails / 3D viewer for STEP
- [x] Model import via Printables URL with interactive models selection.
- [ ] Backend folder structure follows frontend
- [ ] "All models" folder Pagination to speedup large collection first load.
- [ ] Zip Import
- [ ] Root folder Scan and import
- [x] Generate thumbnail from 3D Preview (to fix bad oriented models or to choose a better angle)
- [ ] Models Collections (to group models for projects or variants)
- [ ] Multi-User with Authentication

---

Expand Down
Loading