Repolode
Shelf-nu

Shelf-nu/shelf.nu

Open-source asset management platform for tracking equipment, tools and inventory with QR tags, bookings and custody.

Open-source alternative to:Snipe-IT

Stars
3,051
Forks
385
Open issues
162
Last commit
yesterday

What is it?

Shelf is a web platform for tracking physical assets such as equipment, devices, tools, vehicles and props. It helps teams see what they own, where each item is located, and who currently has it. Each asset can be given a printable QR code that anyone can scan with a phone to view details, check out, or report a problem.

Beyond basic tracking, Shelf covers scheduling and organization. Bookings and reservations prevent double-booking and set checkout and return dates with calendar integration. Assets can be grouped into categories, tags, and kits, placed in hierarchical locations such as buildings, floors and shelves, and extended with custom fields for serial numbers, warranty and condition. Team access is controlled through Owner, Admin, Base and Self Service roles, and separate workspaces can hold different inventories.

The application is built with React Router 7, TypeScript, Prisma and PostgreSQL via Supabase, and it is organized as a pnpm and Turborepo monorepo. A companion mobile app lives in the same repository under a separate, non-open-source license. Fly.io deployment is documented, and community-maintained Docker support is available for self-hosting with an external Supabase instance.

Key features

  • 01Generate and print QR codes to view, check out, or report assets by scanning
  • 02Schedule bookings with double-booking prevention and calendar integration
  • 03Assign custody of assets to team members and track who holds what
  • 04Organize assets in hierarchical locations, categories, tags and kits
  • 05Import and export assets in bulk via CSV, with custom fields and reminders

Use cases

  • Tracking shared equipment and tools across a company or film crew
  • Managing rental gear with scheduled checkout and return dates
  • Keeping an IT inventory of devices with warranty and serial number records
  • Running multi-location inventories for separate departments or organizations

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/Shelf-nu/shelf.nu.git
  2. 2

    Install dependencies with pnpm

    pnpm install
  3. 3

    Generate Prisma client and run migrations (after setting up .env with Supabase credentials)

    pnpm webapp:setup
  4. 4

    Start the development server

    pnpm webapp:dev

Things to know

  • Requires a Supabase project for the database and authentication.
  • Setup involves multiple services and a multi-step configuration, so self-hosting takes effort.
  • The companion mobile app is under a non-open-source license and may not be distributed.

In collections

Topics

#asset-management#inventory#qr-code#equipment-rental#scheduling#self-hosted#typescript#react#asset-management-system#assets-management

FAQ

What is shelf.nu?
Open-source asset management platform for tracking equipment, tools and inventory with QR tags, bookings and custody. Shelf is a web platform for tracking physical assets such as equipment, devices, tools, vehicles and props. It helps teams see what they own, where each item is located, and who currently has it. Each asset can be given a printable QR code that anyone can scan with a phone to view details, check out, or report a problem.
Is shelf.nu free to use? What license does it have?
shelf.nu is open source under the Other license. Check the license terms before using it in commercial products.
Is shelf.nu still maintained?
Actively maintained. The last commit to shelf.nu was on Nov 6, 2026.
What can I use shelf.nu for?
Tracking shared equipment and tools across a company or film crew Managing rental gear with scheduled checkout and return dates Keeping an IT inventory of devices with warranty and serial number records Running multi-location inventories for separate departments or organizations
How do I install shelf.nu?
Clone the repository: git clone https://github.com/Shelf-nu/shelf.nu.git Install dependencies with pnpm: pnpm install Generate Prisma client and run migrations (after setting up .env with Supabase credentials): pnpm webapp:setup Start the development server: pnpm webapp:dev
Where can I get shelf.nu?
The source code and installation instructions are on GitHub: https://github.com/Shelf-nu/shelf.nu

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects