Project Overview
MahariLibrary is a cloud-based Library Management SaaS designed for small to medium-sized study centres, reading rooms, and public libraries across India. It helps library owners digitise their entire operation — from student onboarding to fee collection — all in one place.
For Library Owners
Register, manage students, track fees, and monitor analytics from an intuitive admin dashboard.
For Students
Register via QR code, choose a seat and shift, and stay updated on membership status.
For Admins
Full control — manage multiple libraries, subscriptions, payments and earn detailed revenue insights.
Secure & Reliable
Powered by Supabase with end-to-end data security and daily backups. Payments via Razorpay.
Getting Started
Sign Up as a Library Owner
Create your free account and set up your first library branch in minutes.
- 1Go to maharilibrary.com and click "Get Started".
- 2Fill in your name, email address, and a secure password.
- 3Verify your email, then log in.
- 4You will be prompted to create your first library — enter the library name, address, and capacity.
- 5Your dashboard is now ready!
Login to Your Account
Return users can access the dashboard by logging in.
- 1Click "Login" in the top navigation bar.
- 2Enter your registered email and password.
- 3Click "Sign In". You will be redirected to your Admin Dashboard at /admin.
- 4Forgot password? Click the 'Forgot password' link to receive a reset email.
Add Multiple Library Branches
MahariLibrary supports multiple library branches under a single account.
- 1Go to Admin → Settings → My Libraries.
- 2Click "Add New Library".
- 3Fill in branch name, address, and total seat capacity.
- 4Switch between libraries using the top-bar library selector.
Student Management
Add a Student Manually
Use the "Manual" tab in Students to add students directly without QR code.
- 1Go to Admin → Students → click "Add Student" (blue button or + floating button on mobile).
- 2Fill in: Full Name, Phone number, Email (optional), Date of Birth, Photo (optional).
- 3Select the Shift (e.g., Morning, Evening) and a Seat Number.
- 4Set the Join Date and click Save.
- 5The student is now added and their fee tracking starts.
QR Code Self-Registration
Students scan your library QR code and fill in a form — you review and approve them.
- 1Go to Admin → Students → click 'Show QR Code'.
- 2Display the QR code at your library entrance or share the link.
- 3Students scan, select shift/seat, and fill their details.
- 4New pending registrations appear in the "QR" tab with a red badge count.
- 5Review each applicant — click Approve to admit or Reject to decline.
Search & Filter Students
Quickly find any student or segment your list.
- 1Type a student name, phone number, or seat number in the Search bar.
- 2Use the Filter button to filter by Shift or Fee Status (Paid / Pending / Expired).
- 3Combine search and filters for precise results.
- 4Click any student name to view their full profile.
Send Fee Reminder Email
Remind students with pending or expired fees with one click.
- 1In the Students list, find a student with Pending or Expired fee status.
- 2Click the ⋮ (action menu) and select 'Send Reminder'.
- 3An automated email with fee details and due date is sent to the student.
- 4Note: The student must have a registered email address.
Export Student Data (PDF Backup)
Download all student records as a printable PDF for offline use or backup.
- 1Go to Admin → Students.
- 2Click the green "Export Backup" button.
- 3A PDF is generated with all student details including name, phone, seat, shift, fees, and dates.
- 4The file downloads automatically.
Seat Management
Visual Seat Grid
See all seats in a visual grid — colour-coded by status for at-a-glance management.
- 1Go to Admin → Seats. Select a Shift from the top tab bar.
- 2🟢 Green = Available seat | 🔴 Red = Occupied | 🟡 Yellow = Occupied (fees due).
- 3Click any seat to view its details — student name, phone, fee status, and expiry.
- 4On desktop: details appear on the right panel. On mobile: a bottom sheet slides up.
Move a Student to Another Seat
Reassign a student to a different available seat within the same shift.
- 1Click on an occupied seat to open the student details.
- 2Click "Move Student".
- 3All available seats will start pulsing. Click any available (green) seat to move the student there.
- 4Alternatively on desktop, drag & drop an occupied seat onto any green seat.
- 5Click "Cancel" in the bottom overlay to abort the move.
Shift Management
View & Edit Shifts
Shifts define the time slots (Morning, Evening, Night, Full Day) available for students.
- 1Go to Admin → Shifts.
- 2Your existing shifts are displayed as cards (desktop) or a list (mobile).
- 3Click the Edit (pencil ✏️) icon on any shift card to modify it.
- 4Update: Shift Name, Start Time, End Time, Monthly Price (₹), and Total Seat Capacity.
- 5Click "Save Changes" to apply.
Enable or Disable a Shift
Temporarily deactivate a shift without deleting it — disabled shifts won't appear in QR registration.
- 1Toggle the green/grey switch on the top-right of any shift card, or click the "Disable" / "Enable" button on mobile.
- 2Disabled shifts are shown greyed out.
- 3Students already enrolled in a disabled shift are NOT affected.
Payments & Fee Management
Record a New Payment
Log fee collection for a student — new subscription or due clearance.
- 1Go to Admin → Payments → click "Add Receipt" (blue button).
- 2Search for the student by name or phone number.
- 3If the student has dues, the system shows an 'Outstanding Dues' form — enter the paying amount and any discount.
- 4For a new subscription: verify/adjust the Start & End Date, enter the paying amount, apply any discount.
- 5Select Payment Method: Cash, UPI, Card, or Bank Transfer.
- 6Click "Confirm Payment". The student's fee status updates automatically.
View Transaction History
Click any payment row to open the full transaction history for that student.
- 1In the Payments list, click any row.
- 2A modal opens showing all past transactions: date, type, amount paid, discount, payment method, and status.
Filter Payments by Date
Find payments within a specific date range.
- 1Use the Filter button in the Payments table.
- 2Set a Start Date and/or End Date.
- 3The table updates to show only payments in that range.
- 4Search by student name simultaneously for combined filtering.
Expense Tracking
Log an Expense
Record any library expense — electricity, rent, maintenance, stationery, etc.
- 1Go to Admin → Expenses → click "Add Expense".
- 2Enter Expense Title (e.g., Electricity Bill), Amount (₹), and Date.
- 3Click "Add Expense" to save.
- 4The expense is immediately reflected in your Analytics and Dashboard.
Search & Filter Expenses
Quickly find specific expenses or view a range.
- 1Type in the Search bar to find expenses by title.
- 2Use Date filters (Start Date → End Date) to view expenses in a range.
- 3The total for the filtered period is shown in the stats card at the top.
Analytics & Reports
Revenue Analytics
Detailed income, expense, and profit charts to understand your financial health.
- 1Go to Admin → Analytics → select the 'Revenue' tab.
- 2View monthly KPIs: Total Revenue, Total Expenses, Net Profit, and Lifetime Revenue.
- 3The 'Income vs Expenses' bar chart shows the last 6 months side-by-side.
- 4Switch the 'Revenue Growth' chart between Month-wise and Day-wise views.
Student Analytics
Track admission trends, shift distribution, seat utilisation, and conversion rates.
- 1Go to Admin → Analytics → select the 'Students' tab.
- 2KPIs: Today's Registrations, Total Registrations, Active Students, Pending Approval.
- 3Charts: Shift-wise student distribution (Pie), Admission trends over 6 months (Line), Daily admissions this month.
- 4Seat Utilization donut chart shows % of seats occupied.
- 5Conversion Rate panel shows QR inquiries → Approved students %.
Settings & Account
My Profile
Update your personal information and profile photo.
- 1Go to Admin → Settings → My Profile.
- 2Edit your Full Name, Phone Number, and upload a Profile Avatar.
- 3Click Save to apply changes.
Manage Libraries
Add, view, or switch between your library branches.
- 1Go to Admin → Settings → My Libraries.
- 2All registered library branches are listed here.
- 3Click "Add New Library" to create a new branch.
- 4Switch the active library from the Topbar dropdown (shows current library name).
Subscription Plan
View your current plan and upgrade to Premium for unlimited access.
- 1Go to Admin → Settings → Subscription.
- 2Free Plan: Up to 30 students per library.
- 3Premium (Pro Growth — ₹399/mo per branch): Unlimited students, advanced analytics, QR registration, expense tracking.
- 4Click "Upgrade to Premium" and complete payment via Razorpay.
- 5Upgrade is instant — reload the page to activate.
Security & Password
Change your login password to keep your account secure.
- 1Go to Admin → Settings → Security.
- 2Enter your current password, then your new password (twice).
- 3Click Save Changes.
Step-by-Step Workflows
🎓 Workflow 1: Admit a New Student (Manual)
- 1Admin → Shifts → verify the desired shift has capacity available.
- 2Admin → Seats → confirm the seat number you want to assign is free (green).
- 3Admin → Students → click "Add Student".
- 4Enter student details, select shift and seat, set join date → Save.
- 5Admin → Payments → record the first fee payment for this student.
📱 Workflow 2: Student Self-Registers via QR Code
- 1Admin → Students → click "Show QR Code" → display the QR or share the link.
- 2Student scans QR → fills form: name, phone, email, shift (available ones only), available seat.
- 3Submission appears in Admin → Students under the "QR" tab with a red notification badge.
- 4Admin reviews the applicant details → clicks Approve or Reject.
- 5Approved student is added to the admitted list. Collect the first fee via Payments.
💰 Workflow 3: Record Monthly Fee Collection
- 1Admin → Payments → click "Add Receipt".
- 2Search for the student by name or phone.
- 3If no dues: enter the paid amount, optional discount, payment method, and date range (auto-set to next billing month).
- 4If dues exist: enter the amount being paid toward the outstanding balance.
- 5Click "Confirm Payment" — student fee status updates from Pending → Paid automatically.
🪑 Workflow 4: Relocate a Student's Seat
- 1Admin → Seats → select the student's current shift tab.
- 2Click the student's current (red/yellow) seat.
- 3Click "Move Student".
- 4Click any green (available) seat in the grid to complete the move.
- 5The student's profile updates instantly with the new seat number.
📊 Workflow 5: Check Monthly Financial Health
- 1Admin → Dashboard → review KPI cards: Revenue (Month), Expenses (Month), Pending Fees.
- 2Admin → Analytics → Revenue tab → see Income vs Expenses chart for the last 6 months.
- 3Check Net Profit and Profit Margin % for the current month.
- 4Admin → Expenses → filter by current month to see all individual costs.
- 5Admin → Students → filter by Fee Status = Pending/Expired to identify students needing reminders.
Frequently Asked Questions
Still have questions?
Our support team is ready to help you get the most out of MahariLibrary.
