Bike Parts Inventory

A standalone bicycle parts inventory system for small bike shops and repair studios. The UI is in Traditional Chinese. On first launch, a setup wizard guides you through email notification configuration — no manual config file editing required.

Parts below their reorder level are highlighted in red.

Log multiple entries at once with optional notes.

Shows parts that have triggered an alert. Automatically cleared after restocking.

Submit multiple entries at once. Successful rows are removed immediately; failed rows (e.g. insufficient stock) stay highlighted inline so you can fix and resubmit without re-entering the others. A low-stock warning modal pops up automatically if any part drops to or below its reorder level after the operation.

Email settings can be changed directly in the UI with a test-send button. No restart required. Email notifications can be toggled on/off without removing the SMTP credentials.

• Parts CRUD with soft delete
• Stock increase / decrease with movement history
• Batch stock-out: all rows submitted together; failed rows highlighted inline, successful rows removed immediately
• Low stock pop-up alert on the decrease page when stock drops to or below reorder level
• Low stock email alerts via Gmail SMTP (triggered on decrease + daily retry scheduler)
• Email notifications toggle (enable/disable without clearing credentials)
• Idempotency key support for stock mutations
• Vanilla JS frontend (sidebar layout, senior-friendly)
• First-run setup wizard + settings UI (no manual config file editing)
• E2E tests with in-memory SQLite

• Backend: Go, Gin, SQLite (go-sqlite3)
• Frontend: Vanilla JS, HTML, CSS (no build step)
• Email: Gmail SMTP via gomail.v2

make run
# open http://localhost:8080

On first launch, a setup wizard will guide you through email configuration. No .env file required.

Optional: copy .env.example to .env to pre-fill settings via environment variables.

All persistent data is stored in the OS user config directory:

Files created:

• data.db — SQLite database
• config.json — email and port settings
• app.log — rotating log (10 MB max, 3 backups, 30-day retention)

Environment variables override settings from config.json. Useful for server deployments.

Stock mutation endpoints require an Idempotency-Key header (UUID) to prevent duplicate operations.

Download the latest bikeparts.exe from the Releases page and run it.