-
Notifications
You must be signed in to change notification settings - Fork 0
Introduction
Gubbins is an app for keeping track of your things — and everything you might want to know about them: how many you have, where they are, what they're worth, when they need servicing, who you lent them to, and when to reorder.
It's built for people with a lot of stuff to keep straight: makers and electronics hobbyists, workshops and studios, home organisers, collectors, and small teams who share tools and equipment. Whether you're cataloguing a component drawer, a garage, or a props store, the same building blocks apply.

- Local-first and fully offline. Your inventory lives in a database inside your browser, on your own device. There's no account to create and no server to sign in to — Gubbins works with no internet connection at all, and keeps working if a service ever goes away. See How your data is stored.
- Private by default. Nothing is uploaded anywhere unless you turn on an optional feature and point it at your own storage. See Privacy & security.
- Installable. Add Gubbins to your device like a native app, with its own window and an offline indicator. See Installing Gubbins.
- As simple or as deep as you need. Track a shelf of boxes with nothing but names and counts, or go all the way to serialised assets with warranties, batch expiry, depreciation and calibration logs. Features you don't use can be hidden entirely — see Modular UI.
| Area | What it's for |
|---|---|
| Dashboard | Your landing overview — totals and anything needing attention, on a board of widgets you can rearrange. See Dashboard & widgets. |
| Inventory | The heart of the app: your items, locations and stock. |
| Projects | Group items into builds with a bill of materials and a budget. See Projects & BOM. |
| Contacts | The people and suppliers you lend to, borrow from or buy from. |
| Reports | Valuation, spend, sales and stock insights across your inventory. |
| Search | Find anything fast — full-text, a visual builder, or plain English. |
💡 Tip Don't feel you have to set everything up at once. Add a few items, get a feel for the app, and switch on richer features (batches, maintenance, projects) only when you need them.
- Ready to start? Head to the Quick start.
- Want to understand the model first? Read Core concepts.
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