Skip to content

SharmaNishchay/HexaLibre

Repository files navigation

HexaLibre – Smart College Library App 📚

HexaLibre is a prototype Android application designed to digitalize and simplify the library book issuing system for colleges. Built with real-time features, QR code scanning, secure authentication, and clean UI/UX, it provides students with a seamless and modern way to interact with their campus library.

🔐 This is a collaborative prototype. The code is public for demonstration and portfolio purposes.


📱 Features

  • 🔐 Secure OAuth Login
    Sign in using your college-issued email via Google OAuth with domain restriction.

  • 📷 QR Code Book Issuing & Return
    Scan book-specific QR codes to issue or return books in real time.

  • 📚 Book Availability Status
    Instantly check whether a book is available, issued, or on hold.

  • 🔄 Real-Time Book Status Updates
    All book-related actions reflect instantly across the platform.

  • 🔎 Search & Filter
    Find books quickly with advanced search and real-time availability filtering.

  • Transaction History Tracking
    View a full history of issued and returned books with timestamps.

  • Return Notifications
    Get notified before book return deadlines to avoid fines.

  • 🔁 Hold Feature with Preferred Issue Timing
    Place books on hold and choose your preferred time slot for pickup.

  • 💯 Honor Score System
    Earn points for timely returns and responsible usage; misuse leads to score penalties.

  • 💸 Fine Tracking (Without Auto Fee Addition)
    Students and admins are notified of fines, but charges aren't automatically applied to fee portals.

  • 📬 Notify Me Feature
    Get alerts when currently unavailable books are restocked or returned.

  • 🌓 Modern UI with Dark Mode
    Smooth, responsive design with transitions and a dark/light mode toggle.


🛠 Tech Stack

  • Language: Java, XML
  • IDE: Android Studio
  • Database: Firebase Realtime Database
  • Authentication: Firebase Auth (Google OAuth + Domain Restriction)
  • QR Scanning: ZXing library

👨‍💻 Contributions

Nishchay Sharma

  • Designed and implemented all XML-based UI screens and navigation structure
  • Integrated Google OAuth with domain-level restriction for college emails
  • Developed UI transition logic and helped design user flow

Suman Kumar

  • Firebase integration for user and book data
  • QR code scanner and database sync functionality
  • Managed data synchronization, book availability logic, and fine tracking in backend

🚧 Project Status

  • ✅ Prototype working on real Android devices
  • 🧪 Testing and validation of edge cases in progress
  • 🔒 Code and access logic still under refinement

📂 Running the Project

  1. Clone the repository
  2. Open in Android Studio
  3. Set up Firebase and add your google-services.json
  4. Run on a device with API level 31+
  5. Use a valid college email to sign in via Google OAuth

🖼️ Screenshots

screenshot-2

screenshot-4

screenshot-3

screenshot-1

screenshot-5

screenshot-6

📝 License

This project is licensed under the Proprietary License.


📫 Contact

Nishchay Sharma
📧 [email protected]
🔗 GitHub
🔗 LinkedIn

About

HexaLibre - Next-Gen Library Management System

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages