-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Gubbins is a local-first inventory app for tracking your stuff — parts, tools, equipment, collections, household supplies, or a whole workshop. It runs entirely in your browser, works fully offline, and keeps all of your data on your own device.
This wiki explains every feature, concept, option and setting, with pictures. If you're new, start with the three pages below; otherwise jump straight to a section from the sidebar.
- Introduction — what Gubbins is, who it's for, and the ideas behind it.
- Installing Gubbins — supported browsers and installing the app.
- Quick start — from a blank slate to your first tracked item in a couple of minutes.
- Core concepts — the handful of ideas (items, locations, stock, tracking modes) that everything else builds on.
| Area | What's inside |
|---|---|
| Inventory | Items, Tracking modes, Locations & stock, Batches & lots, Variants, Kits, Custom fields |
| Asset lifecycle | Warranty & depreciation, Maintenance, Cycle counts, Insurance schedule |
| People & time | Contacts, Loans, Bookings |
| Search | Search overview, Visual builder, Text syntax, Natural language |
| Scanning & labels | Camera scanning, QR & labels, OCR |
| Purchasing & projects | Projects & BOM, Purchase orders, Reorder, Wishlist, Suppliers |
| Reports | Reports overview, Valuation & spend, Sales & margin |
| Data & sync | How your data is stored, Cloud sync, Backup & restore, Import |
| Integrations | Bridge overview, Home Assistant, AI assistant |
| Customising | Appearance, Dashboard, Modular UI, Language |
💡 Tip Gubbins only shows the features you use. Any page or capability in this wiki can be hidden from the app on the Modular UI screen — so if something described here isn't visible, it may simply be switched off on your device. Your data is never affected.
ℹ️ About this wiki The screenshots throughout use invented sample data — none of the names, items or contacts are real. Gubbins itself never sends your data anywhere; see Privacy & security.
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