Logo
Deploy Now

Categories

Self-Hosted Asset Management Inventory Tracking Equipment Management QR Code Booking System IT Management

Stars

2,983

Forks

365

Watchers

13

Developer links

Last Updated: 08-21-2026 10:24 PM (UTC)

Shelf

Shelf answers the three questions every equipment manager dreads — who has it, where is it, and when is it coming back — using QR-code-first tracking where every asset gets a unique scannable label, every handover is logged with timestamps and e-signed custody agreements, and every scan captures GPS coordinates displayed on a map. Built on React Router 7 with React 19, TypeScript 5, Prisma 6 ORM, and Tailwind CSS 3 with Radix UI components, the platform generates QR codes and barcodes (Code128, Code39, Datamatrix) printable on DYMO, Brother, and Zebra label printers. The custody system records every handover with user details and generates PDF custody agreements with e-signatures for high-value items, while a complete audit trail tracks responsibility from check-out to return. The visual booking calendar prevents double-bookings automatically, supports partial check-outs and returns with segmented lifecycle bars, and handles quantity-tracked consumables alongside individually serialized equipment. Asset Models enable bulk creation of identical items with shared defaults while maintaining individual QR codes and custody histories. Location tracking displays last-scanned GPS coordinates on MapTiler maps. Supabase Auth provides email and SSO authentication, pg-boss handles background job queuing, and Nodemailer delivers SMTP email. The Shelf Companion app on iOS and Android enables field scanning and bookings. Export Asset Inventory, Asset Distribution, and Custody Snapshot reports for compliance. Deploy via Docker with PostgreSQL and Supabase. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. AGPL v3.0 licensed.

Shelf
Shelf
Shelf
Shelf
Shelf

Benefits

  • QR-Code-First Asset Tracking
  • Every asset receives a unique QR code scannable from any phone browser or the native Companion app on iOS and Android, with automatic GPS location capture on each scan.
  • Custody Accountability Built In
  • Every handover is logged with timestamps and user details, generating PDF custody agreements with e-signatures for high-value items and maintaining a complete audit trail.
  • Conflict-Free Equipment Booking
  • Visual booking calendar with automatic double-booking prevention, partial check-outs and returns, quantity-tracked consumables, and Asset Model-based reservations for pooled equipment.
  • No Per-User Pricing Limits
  • Self-hosted deployment supports unlimited team members, unlimited assets, and unlimited workspaces without per-seat fees, scaling freely on your own infrastructure with AGPL licensing.

Features

  • QR Code Scanning
  • Generate unique QR codes and barcodes (Code128, Code39, Datamatrix) for every asset, printable on DYMO, Brother, and Zebra label printers.
  • Custody Tracking
  • Automatic handover logging with timestamped audit trails, PDF custody agreements with e-signatures, and workspace-separated accountability for multi-department organizations.
  • Equipment Booking
  • Visual calendar with conflict prevention, partial check-out and return workflows, Asset Model pooling for interchangeable equipment, and quantity-tracked consumable reservations.
  • Location Map Tracking
  • GPS coordinates captured on each QR scan displayed on MapTiler maps, showing last-known asset locations across all organizational sites.
  • Reports and Exports
  • Export Asset Inventory, Asset Distribution, and Custody Snapshot reports for insurance, grant, financial compliance, and operational audits via CSV.