Projects¶
Group related prints into projects to track multi-part builds, gift sets, or any collection of related prints.

What Are Projects?¶
Projects let you:
- Group prints - Organize related archives together
- Track progress - See completion status
- Set targets - Define how many prints needed
- Bill of materials - Track sourced parts (screws, electronics)
- File attachments - Store documentation and references
- Cost tracking - Budget and expense tracking
- Color code - Visual identification
- Add notes - Document the project
Use Cases¶
| Project | Description |
|---|---|
| Voron Build | All parts for a Voron printer |
| Gift Set | Prints for a birthday gift |
| Home Organizers | Kitchen and bathroom organizers |
| Prototypes | Iterations of a design |
| Commission | Client order tracking |
Creating a Project¶
- Go to the Projects page
- Click New Project
- Fill in the details:
| Field | Description |
|---|---|
| Name | Project name (required) |
| Description | What the project is for |
| Color | Badge color for identification |
| Target Count | Number of prints needed |
- Click Create
Adding Archives to Projects¶
From Archive Card¶
- Right-click an archive card
- Select Add to Project
- Choose the project
- Archive is linked
From Archive Details¶
- Open an archive
- Click the Project dropdown
- Select a project
- Changes save automatically
Bulk Assignment¶
- Select multiple archives (Shift+click or Ctrl+click)
- Right-click the selection
- Choose Add to Project
- All selected archives are assigned
Progress Tracking¶
Track how close you are to completing a project:
Progress Bar¶
Progress States¶
| State | Description |
|---|---|
| Not started (0%) | |
| In progress | |
| Complete (100%) |
Target Count¶
Set a target to track completion:
- Target: 10 with 5 completed = 50%
- Leave blank for no specific target
Color Coding¶
Each project has a color-coded badge:
Available Colors¶
- Red
- Orange
- Yellow
- Green
- Blue
- Purple
- Gray
Badge Display¶
Project badges appear on:
- Archive cards
- Archive list view
- Project overview
Project Cards¶
Each project displays as a card:
┌────────────────────────────────────────┐
│ [Color] Voron Build │
│ │
│ Building a Voron 2.4r2 printer │
│ │
│ [████████████░░░░░░░░] 65% │
│ 13 of 20 parts printed │
│ │
│ Latest: stealthburner_main.3mf │
└────────────────────────────────────────┘
Card Information¶
- Color badge - Visual identification
- Name - Project title
- Description - What it's for
- Progress - Completion percentage
- Count - Prints completed / target
- Latest - Most recent print added
Editing Projects¶
- Click the edit icon on a project card
- Modify any field
- Click Save
Editable Fields¶
- Name
- Description
- Color
- Target count
Filtering by Project¶
Filter archives to show only those in a project:
- Go to Archives page
- Click the Project filter
- Select a project
- Only linked archives are shown
Deleting Projects¶
Deleting a project:
- Click the delete icon on a project card
- Confirm deletion
Archives Preserved
Deleting a project does NOT delete the archives. They remain in your archive but are no longer linked to a project.
Project Archives View¶
Click a project card to see all its archives:

- Grid view of all linked prints
- Same filtering and sorting as main Archives
- Quick access to add more prints
Bill of Materials¶
Track non-printed parts needed for your project (screws, electronics, hardware):
Adding BOM Items¶
- Open a project
- Scroll to Bill of Materials
- Click Add Item
- Fill in the details:
| Field | Description |
|---|---|
| Name | Part name (e.g., "M3x8 SHCS") |
| Quantity | How many needed |
| Unit Price | Cost per item |
| Sourcing URL | Where to buy |
| Remarks | Additional notes |
Tracking Acquisition¶
- Check the box when a part is acquired
- Progress bar shows acquired/total items
- Use Hide done to focus on remaining items
File Attachments¶
Attach reference files to your project:
Supported File Types¶
| Category | Extensions |
|---|---|
| Images | JPG, PNG, GIF, WebP, SVG |
| Documents | PDF, DOC, DOCX, TXT, MD |
| 3D Files | STL, OBJ, 3MF, STEP, F3D, SCAD |
| Archives | ZIP, RAR, 7Z, TAR, GZ |
| Scripts/Configs | PY, SH, CFG, GCODE, INI |
| Data | JSON, XML, YAML |
Uploading Files¶
- Open a project
- Scroll to Attachments
- Click Upload or drag and drop
- Files are stored with the project
Cost Tracking¶
Track project expenses:
Cost Categories¶
- Parts cost - Sum of BOM item prices
- Additional costs - Manual entries for other expenses
Currency¶
Uses your configured currency from Settings → General.
Project Ideas¶
Multi-Part Prints
Create a project for complex models that print in multiple pieces. Track which parts are done.
Gift Planning
Start a project before a birthday or holiday. Add prints as you complete them.
Printer Builds
Building a Voron, Trident, or other kit? Track every printed part.
Iterative Design
Group prototypes of the same design to see your progression.
Client Orders
Track prints for commission work or client requests.