-
Notifications
You must be signed in to change notification settings - Fork 0
Projects and BOM
A project groups items into a build with a bill of materials (BOM), reservations and a budget — a repair, a make, a job, a kit you're assembling. It answers "do I have everything I need, and can I afford it?"
Where to find it: the Projects screen (in the menu, when the module is enabled).

A project's BOM lists the items it needs and how many of each. From that list, Gubbins works out:
- What you already have versus what's short.
- An automatic shopping list of the missing pieces.
So starting a project immediately tells you whether you can proceed or need to buy first.
Reserve stock for a project to earmark it — the reserved quantity is set aside so it isn't accidentally used elsewhere before you get to the build. Your available count reflects the reservation.
A project can total its cost, and toggle how it's costed (for example, what you'd pay to buy the missing parts versus the value of everything in the build). The missing-parts shopping list flows into your purchasing.
💡 Tip Projects are great even for one-off jobs: drop in the parts, see what's short, and let Gubbins build the shopping list — no need to work it out on paper.
ℹ️ Note A project is a one-off build with its own BOM and budget. A reusable assembly you make repeatedly is better modelled as a kit.
- Budgets — setting and tracking a project's budget.
- Kits & bundles — reusable assemblies.
- Reorder & shopping list — buying what a project needs.
- Export & import — projects get their own export sub-folders.
Gubbins · a local-first, offline inventory app · Report an issue
Getting started
Inventory
- Items
- Tracking modes
- Locations & stock
- Location photos & regions
- Batches & lots
- Variants & SKUs
- Kits & bundles
- Tags, attachments & related
- Custom fields & capabilities
- Low stock & gauges
- Counting by weight
- Container weights
- Bulk edit & clone
- Inventory views
Asset lifecycle
- Warranty & depreciation
- Current value & revaluation
- Maintenance & servicing
- Test & calibration records
- Condition grading
- Cycle counts & audit day
- Insurance & estate schedule
People, loans & bookings
Users & access
Search
- Search overview
- Visual query builder
- Text query syntax
- Natural-language search
- Saved searches & favourites
Scanning & labels
Purchasing & projects
- Projects & BOM
- Budgets
- Purchase orders
- Reorder & shopping list
- Wishlist
- Supplier parts & price history
- Suppliers
Reports & insights
- Reports overview
- Valuation & spend
- ABC, turnover & aging
- Sales & margin
- Data hygiene
- Parts catalogue
Sales & disposals
Alerts, activity & agenda
Companion extension
Data, sync & resilience
- How your data is stored
- Cloud sync
- Backup & restore
- Export & import
- Migrating from another tool
- Storage triage
- Danger zone: erasing data
Bridge & Home Assistant
- Bridge overview
- Running the bridge
- Bridge API tokens
- Home Assistant
- AI assistant query (MCP)
- Webhooks
- Webhooks, MQTT & iCal
Settings & customisation
- Appearance & theming
- Branding
- Dashboard & widgets
- Modular UI
- Language & region
- Notifications
- Kiosk & tablet mode
Reference