Skip to content

arshinmrelju/Library-Management-System

Repository files navigation

Navodhayam Logo

Navodhayam Library

A premium, mobile-first PWA digital library system designed for rural empowerment.

Firebase JavaScript PWA Capacitor Google Sheets


Navodhayam Library is a professional digital library assistant. It provides an intuitive interface for users to browse books, locate them on physical shelves, and request titles seamlessly. The app is powered by Firebase for real-time data synchronization and secure administrative control.

✨ Key Features

👤 User Interface & Experience

  • 📱 Premium PWA Experience: Fully optimized Progressive Web App with custom glassmorphic installation prompts. Supports offline access via Service Workers.
  • 🎨 Modern Design System: Vibrant HSL-tailored color palettes, dark mode support, glassmorphism, and smooth micro-animations.
  • 📷 Book Cover Scanning: Integrated document scanner allowing users to snap, crop, and upload book covers directly from mobile devices.
  • 🔍 Advanced Search & Filter: Paginated data loading for 5,000+ books with multi-criteria search (Book ID, Member ID, Author, Title).

🔐 Admin & Management

  • 🎙️ Malayalam Voice Alerts: Automated audio notifications for new requests using optimized Web Speech detection.
  • 📲 OS Push Notifications: Real-time browser-level alerts even when the librarian portal is in the background.
  • 🛠️ Hidden Debug Suite: A secret 3-tap sync panel for monitoring data flow from Google Sheets and testing PWA triggers.
  • 🔄 real-time Sync: Instant Firestore synchronization ensures librarians and users are always looking at the latest data.

🛠️ Technical Stack

Category Technologies
Frontend Core HTML5, Vanilla JavaScript (ES6 Modules), CSS3 (Custom Design System)
PWA & Mobile Service Workers, Manifest API, CapacitorJS (for Native APK support)
Backend & Auth Firebase (Firestore, Authentication via Google, Storage, Hosting)
Icons & UI Lucide Icons, Inline SVG Symbols, Glassmorphism Backdrop Effects
Data Ingestion Google Apps Script (Automated batch sync from Google Sheets)
Notifications Browser Notification API, Web Speech API (Malayalam prioritized)

🚀 Getting Started

1. Prerequisites

  • Modern browser (Chrome/Safari recommended)
  • Firebase Project setup

2. Quick Setup

  1. Clone the repo:
    git clone https://github.com/arshinmrelju/Navodaya-Library.git
  2. Configure public/js/firebase-config.js with your Firebase credentials.
  3. Deploy:
    firebase deploy

📐 Project Architecture

  • Web App: Single Page Application (SPA) architecture with modular JS.
  • PWA: Service Worker caching strategy for lightning-fast repeated loads and offline request visibility.
  • Data flow: Google Sheets (Source) -> Apps Script -> Firebase Firestore (Live DB) -> Navodhayam UI.

🤝 Credits & Contributors

Developed by Dept. of English Interns at Pazhassiraja College to empower rural communities through organized knowledge access.


© 2026 Navodhayam. Open Source for Community Use.

About

A premium, mobile-first PWA digital library system with real-time Firestore synchronization and Malayalam voice notifications.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors