library-os

KO | EN

gitlite — search

#react #android #rust #deep-learning #docker #macos #nodejs #java #windows #awesome #vue #awesome-list #mcp #ios

(★ 13)

【Making code with love - show some love back with a star! 💝⭐️】A modern, full-featured library management system built with Next.js 15 and Supabase. Features real-time book tracking, user authentication, borrowing management, and a responsive UI powered by shadcn/ui components.

library-os Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Project Banner](https://raw.githubusercontent.com/ChanMeng666/library-os/master/public/images/placeholder-1.jpg)](#)

# 📚 LibraryOS<br/><h3>The Operating System for Modern Libraries</h3>

LibraryOS is a comprehensive multi-tenant library management system that enables organizations to manage their book collections, track loans, handle reservations, and manage team members with role-based access control.<br/>
Built with Next.js 16, React 19, TypeScript, Supabase, TailwindCSS 4, and Stripe for subscription billing.<br/>
One-click **FREE** deployment for your digital library transformation.

[Live Demo][demo-link] · [Documentation][docs-link] · [Report Bug][issues-link] · [Request Feature][issues-link]

<br/>

[![🚀 Visit Live Site 🚀](https://gradient-svg-generator.vercel.app/api/svg?text=%F0%9F%9A%80Visit%20Live%20Site%F0%9F%9A%80&color=000000&height=60&gradientType=radial&duration=6s&color0=ffffff&template=pride-rainbow)][demo-link]

<br/>

[![][github-release-shield]][github-release-link]
[![][vercel-shield]][vercel-link]
[![][github-stars-shield]][github-stars-link]
[![][github-forks-shield]][github-forks-link]
[![][github-issues-shield]][github-issues-link]
[![][github-license-shield]][github-license-link]

**Share Repository**

[![][share-x-shield]][share-x-link]
[![][share-linkedin-shield]][share-linkedin-link]
[![][share-reddit-shield]][share-reddit-link]

<sup>🌟 LibraryOS: The operating system for modern libraries. Built for organizations, librarians, and book enthusiasts.</sup>

[![][github-trending-shield]][github-trending-url]

## 📸 Project Screenshots

> [!TIP]
> Experience the modern, intuitive interface designed for both librarians and library users.

<div align="center">
  <img src="https://github.com/user-attachments/assets/70bd5184-9eb6-4670-b3de-5a4002c34a46" alt="Main Dashboard" width="800"/>
  <p><em>User Dashboard - Complete overview of borrowed books and library statistics</em></p>
</div>

<div align="center">
  <img src="https://github.com/user-attachments/assets/54da54eb-a64d-4f93-b69a-b36349c77a43" alt="Book Catalog" width="400"/>
  <img src="https://github.com/user-attachments/assets/a0313675-7dd5-4a3b-911e-9df6e05aee32" alt="Book Details" width="400"/>
  <p><em>Book Catalog and Detailed Book Information</em></p>
</div>

<details>
<summary><kbd>📱 More Screenshots</kbd></summary>

<div align="center">
  <img src="https://github.com/user-attachments/assets/dc8b1980-44a4-4b59-9f6d-c92f60016a0c" alt="Authentication" width="600"/>
  <p><em>Secure Authentication System</em></p>
</div>

<div align="center">
  <img src="https://github.com/user-attachments/assets/c67b34d7-b771-4b86-b43a-68704cec7acb" alt="Search and Filter" width="600"/>
  <p><em>Advanced Search and Filtering</em></p>
</div>

</details>

**Tech Stack Showcase:**

</div>

## 🌐 See it live

![Demo: LibraryOS walk-through — hero landing page, scroll to 10K+ books and 500+ organizations stats, then transition to the Create Account registration form with split green-gradient layout](https://raw.githubusercontent.com/ChanMeng666/library-os/master/docs/showcase/demo.gif)

<details>
<summary>📝 Get started — Create your account</summary>

</details>

<details>
<summary>📱 Mobile view</summary>

</details>

> [!IMPORTANT]
> This is a **multi-tenant SaaS platform** where organizations can create isolated library environments. Features include Stripe subscription billing (Free/Basic/Pro/Enterprise plans), role-based access control (Owner/Admin/Librarian/Member), team invitations, and comprehensive book management.

<details>
<summary><kbd>📑 Table of Contents</kbd></summary>

#### TOC

- [📚 LibraryOSThe Operating System for Modern Libraries](#-libraryosthe-operating-system-for-modern-libraries)
  - [📸 Project Screenshots](#-project-screenshots)
      - [TOC](#toc)
      - [](#)
  - [🌟 Introduction](#-introduction)
  - [✨ Key Features](#-key-features)
    - [`1` Multi-tenant Organizations](#1-multi-tenant-organizations)
    - [`2` Smart Book Management](#2-smart-book-management)
    - [`3` Subscription \& Billing](#3-subscription--billing)
    - [`4` Role-based Access Control](#4-role-based-access-control)
    - [`*` Additional Features](#-additional-features)
  - [🛠️ Tech Stack](#️-tech-stack)
  - [🏗️ Architecture](#️-architecture)
    - [System Architecture](#system-architecture)
    - [Database Schema](#database-schema)
    - [Core Workflows](#core-workflows)
  - [⚡️ Performance](#️-performance)
  - [🚀 Getting Started](#-getting-started)
    - [Prerequisites](#prerequisites)
    - [Quick Installation](#quick-installation)
    - [Environment Setup](#environment-setup)
    - [Database Setup](#database-setup)
  - [🛳 Deployment](#-deployment)
    - [Vercel Deployment](#vercel-deployment)
    - [Environment Variables for Production](#environment-variables-for-production)
  - [📖 Usage Guide](#-usage-guide)
    - [For Organization Owners](#for-organization-owners)
    - [For Librarians](#for-librarians)
    - [For Members](#for-members)
  - [🔌 Integrations](#-integrations)
  - [⌨️ Development](#️-development)
    - [Development Commands](#development-commands)
    - [Project Structure](#project-structure)
  - [🤝 Contributing](#-contributing)
  - [📄 License](#-license)
  - [👥 Author](#-author)

####

<br/>

</details>

## 🌟 Introduction

This comprehensive library management system is designed for **organizations** that need to manage their book collections with team collaboration. Each organization operates in an isolated environment with its own books, members, and settings.

**Key Differentiators:**
- **Multi-tenancy**: Each organization has isolated data and settings
- **Subscription Plans**: Tiered pricing with different quotas and features
- **Team Management**: Invite members with different roles and permissions
- **Modern Stack**: Built with the latest versions of Next.js, React, and TailwindCSS

> [!NOTE]
> - Node.js >= 18.0 required
> - Supabase account required for database and authentication
> - Stripe account required for subscription billing
> - Modern web browser with JavaScript enabled

| [![][demo-shield-badge]][demo-link]   | Experience the system firsthand with our live demo - no installation required!                           |
| :------------------------------------ | :--------------------------------------------------------------------------------------------- |
| [![][discord-shield-badge]][discord-link] | Join our community of developers and library professionals. |

> [!TIP]
> **⭐ Star us** to receive notifications about new features and updates!

[![][image-star]][github-stars-link]

<details>
  <summary><kbd>⭐ Star History</kbd></summary>
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ChanMeng666%2Flibrary-management-system&theme=dark&type=Date">
    <img width="100%" src="https://api.star-history.com/svg?repos=ChanMeng666%2Flibrary-management-system&type=Date">
  </picture>
</details>

## ✨ Key Features

### `1` Multi-tenant Organizations

Create and manage multiple library organizations, each with isolated data and customizable settings.

**Organization Features:**
- 🏢 **Create Organizations**: Set up new library environments with custom branding
- 👥 **Team Management**: Invite members via email with role assignment
- 🔄 **Organization Switching**: Users can belong to multiple organizations
- ⚙️ **Custom Settings**: Configure loan duration, max loans per user, and more
- 📊 **Organization Stats**: Track books, members, loans, and usage

```mermaid
graph LR
    A[User] --> B[Organization 1]
    A --> C[Organization 2]
    B --> D[Books]
    B --> E[Members]
    B --> F[Loans]
    C --> G[Books]
    C --> H[Members]
    C --> I[Loans]
```

</div>