GitHub - Shelf-nu/shelf.nu: A free open source IT asset / Equipment / management and scheduling system.

3 min read Original article ↗

Shelf.nu

Shelf.nu Cover

✨ Open Source Asset Management Infrastructure for Everyone ✨

Shelf 🏷️ is a cutting-edge, open-source asset management platform designed to streamline tracking, organizing, and managing assets for individuals, businesses, and educational institutions.

Core Features 🚀

  • QR Code Generation & Asset Tags: Easily assign and track items with QR codes.
  • Location Tracking: Quickly locate assets using GPS and tagged locations.
  • Team Collaboration: Seamless collaboration with shared access for teams.
  • Digital Asset Catalog: Comprehensive, searchable database of all assets.
  • Booking & Reservation Management: Prevent double bookings and efficiently reserve assets.
  • Remote Access: Manage your inventory remotely from any location.
  • Custom Fields: Tailor item details, including purchase history, warranties, and conditions.
  • Insights: Analyze usage, condition, and other metrics levels at a glance.
  • Instant Search: Advanced, fast, and intuitive search through all assets.

Real Impact: Eastern Michigan University Case Study 🌟

Shelf revolutionized asset management for Eastern Michigan University's Theatre Program:

  • Centralized Inventory: Moving from chaotic spreadsheets to an organized digital catalog.
  • Remote Access: Students coordinate props from different locations, streamlining pre-production.
  • Time Savings: Eliminated hours of searching through physical stock with remote asset visibility.
  • Collaboration: Enabled teams to collaborate on asset reservations and planning with ease.

Use Cases 💡

Shelf is ideal for managing:

  • Tool & Equipment Tracking: For industries needing to oversee large-scale tools or equipment.
  • IT Asset Management: Track devices, peripherals, and office technology.
  • Theatre & Arts: Perfect for managing props, costumes, and scenic elements for productions.
  • Home Inventory: Organize and track personal items, manage warranties, and know their locations.
  • Educational Institutions: Centralize and manage department assets for better collaboration.

Quick Start 🚀

Get Shelf running locally in just a few steps:

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn
  • Git

1. Clone & Install 📦

git clone https://github.com/Shelf-nu/shelf.nu.git
cd shelf.nu
npm install

2. Setup Environment Variables 🔧

3. Setup Supabase Database 🗄️

You'll need a Supabase account and database. Follow our detailed Supabase Setup Guide to:

  • Create your Supabase project
  • Configure authentication
  • Setup storage buckets
  • Get your connection strings and API keys

4. Configure Your .env File ⚙️

After completing the Supabase setup, update your .env file with the values from your Supabase dashboard.

5. Initialize Database 🏗️

6. Start Development Server 🎉

Your app will be available at http://localhost:3000 🎊

Documentation 📚

Alternative Setup Options 🛠️

Docker 🐳

Prefer containers? Check out our Docker setup guide.

One-Click Deploy 🚀

Ready for production? See our deployment guide for Fly.io and GitHub Actions setup.

Contributing 🤝

We encourage contributions! See our contribution guidelines to get started.

License 📜

Shelf.nu is licensed under the AGPL-3.0 License.

⭐️ Star the repo if you find Shelf helpful!