Assalamu A'laikum! Welcome to MaktabMate

This guide will walk you through everything you need to get your maktab up and running. From initial setup to daily use — follow each section step by step, or jump to what you need.

1. Install MaktabMate as an App
Add it to your home screen for the best experience

MaktabMate works as a web app that you can install directly to your phone's home screen — no app store needed. It looks and feels just like a native app, with its own icon, full-screen experience, and offline support.

1
Open MaktabMate in Chrome
Go to maktabmate.co.uk/app in Google Chrome and log in to your account.
Using a Samsung device? Samsung Internet (the browser pre-installed on Samsung phones) tends to work better than Chrome for installing and running MaktabMate. If you have it, open maktabmate.co.uk/app in Samsung Internet instead — the steps below are nearly identical.
2
Tap the menu icon
Tap the three-dot menu (⋮) in the top-right corner of Chrome. You may see a banner at the bottom saying "Add MaktabMate to Home screen" — if so, you can tap that instead.
Chrome three-dot menu highlighted

Screenshot: Chrome three-dot menu highlighted

install-android-menu.png
3
Tap "Add to Home screen"
Scroll down in the menu and tap Add to Home screen (or "Install app"). Confirm by tapping Add.
"Add to Home screen" option in Chrome menu

Screenshot: "Add to Home screen" option in Chrome menu

install-android-add.png
4
Done — open from your home screen
The MaktabMate icon now appears on your home screen. Tap it to open the app in full-screen mode, just like a regular app.
MaktabMate icon on Android home screen

Screenshot: MaktabMate icon on Android home screen

install-android-done.png
1
Open MaktabMate in Safari
Go to maktabmate.co.uk/app in Safari (this must be Safari — it won't work from Chrome or other browsers on iPhone).
Important: On iPhone, you must use Safari to install a web app. Chrome and other browsers don't support "Add to Home Screen" on iOS.
2
Tap the Share button
Tap the Share button (the square with an arrow pointing up) at the bottom of the Safari toolbar.
Safari share button highlighted at bottom of screen

Screenshot: Safari share button highlighted at bottom of screen

install-iphone-share.png
3
Tap "Add to Home Screen"
Scroll down in the share sheet and tap Add to Home Screen. You'll see a preview with the MaktabMate name and icon. Tap Add to confirm.
"Add to Home Screen" option in Safari share sheet

Screenshot: "Add to Home Screen" option in Safari share sheet

install-iphone-add.png
4
Done — open from your home screen
The MaktabMate icon now appears on your home screen. Tap it to open the app in full-screen mode with no browser bars — just like a native app.
MaktabMate icon on iPhone home screen

Screenshot: MaktabMate icon on iPhone home screen

install-iphone-done.png
2. Your Role in MaktabMate
Understand what you can access based on your role

MaktabMate has four user roles, each with different levels of access. Find your role below to see which features and pages are available to you.

Headteacher
Full access to everything. Manage staff, students, classes, settings, fees, and view all reports. You're the admin of your maktab.
Dashboard Staff Classes Students Attendance Progress House Points Homework Messages Fees Reports Calendar Settings
Office Staff
Similar access to headteacher for day-to-day management. Can manage students, attendance, fees, and communicate with parents.
Dashboard Students Classes Attendance Progress House Points Messages Fees Reports Calendar
Teacher
Focused on your assigned class. Mark attendance, record Quran progress, set homework, award house points, and message parents.
Dashboard Students Attendance Progress House Points Homework Messages Clock In/Out
Parent
View your child's attendance, Quran progress, homework, and fees. Receive messages from teachers and the maktab office.
Dashboard Attendance Progress Homework Messages Fees
Throughout this guide, look for the role badges — Headteacher Teacher etc. — to quickly see which sections apply to your role.
3. Setup Wizard
Your first 2 minutes after registering

After creating your account, the setup wizard guides you through four quick steps to configure your maktab. You only need to do this once.

1
Welcome Screen
You'll be greeted with an overview of the four setup steps: Details, Schedule, Appearance, and Done. Tap Get Started to begin.
Welcome screen with the four setup icons

Screenshot: Welcome screen with the four setup icons

setup-welcome.png
2
Organisation Details
Enter your maktab's name, email, phone number, and address. The URL slug is generated automatically from your maktab name — this becomes your unique login link.
Organisation details form

Screenshot: Organisation details form

setup-details.png
Your URL slug determines your login link, e.g. maktabmate.co.uk/app/al-noor-islamic-school. Choose carefully — it can't be changed later.
3
Programme Schedule
Configure your operating schedule. You can enable both the Maktab programme (Quran reading classes) and the Hifdh programme (Quran memorisation). For each, select your operating days and set start/end times. Hifdh classes can optionally have two sessions (morning and evening).
Programme schedule with day selectors and time pickers

Screenshot: Programme schedule with day selectors and time pickers

setup-schedule.png
You can enable or disable either programme at any time. If your maktab only runs Maktab classes, simply toggle Hifdh off.
4
Appearance & Theme
Choose between Light, Dark, or System theme. This can be changed later in Settings.
Theme selector with Light, Dark, and System options

Screenshot: Theme selector with Light, Dark, and System options

setup-theme.png
5
All Set!
A summary of everything you've configured is shown, along with three suggested next steps: Add teachers & staff, Create classes, and Enrol students. Tap Go to Dashboard to begin.
Setup complete summary with next steps

Screenshot: Setup complete summary with next steps

setup-complete.png
4. Dashboard Overview
Your maktab at a glance

The dashboard is the first screen you see after logging in. It's tailored to your role — headteachers and office staff see the full overview, while teachers and parents see what's relevant to them.

Headteacher Office
Quick Stats
Total students, staff, classes, and this week's attendance percentage at a glance.
Today's Snapshot
Live attendance ring chart with present/late/absent/unmarked breakdown, plus staff clock-in status.
Session Awareness
If Hifdh has morning and evening sessions, toggle between them to see session-specific data.
Recent Activity
Latest messages, homework updates, and notifications from across your maktab.
Headteacher dashboard with stats, attendance ring, and staff status

Screenshot: Headteacher dashboard with stats, attendance ring, and staff status

dashboard-ht.png
Navigation: Use the sidebar on desktop or the bottom navigation bar on mobile to move between pages. On mobile, tap More to access all pages.
5. Setting Up Your Maktab
Classes, terms, and academic calendar
Headteacher Office
1
Create Your Classes
Go to Classes in the sidebar. Tap Add Class to create a new class. Enter the class name, select the programme type (Maktab or Hifdh), and optionally assign a teacher. You can also bulk import classes using the Excel template — tap Import/Export → Download Template.
Classes page with Add Class button and class list

Screenshot: Classes page with Add Class button and class list

classes-page.png
2
Set Up Your Academic Calendar
Go to Calendar to add term dates, holidays, Eid breaks, and inset days. Use Manage Keys to create colour-coded event types (e.g. "Half Term", "Eid", "Parent Evening"). Then tap Add Event to schedule them on the calendar.
Calendar page with colour-coded events and monthly view

Screenshot: Calendar page with colour-coded events and monthly view

calendar-page.png
Important: Holidays marked on the calendar will automatically block attendance and progress recording for those dates. Inset days allow staff to clock in but block student attendance.
3
Configure Your Curriculum
Go to Curriculum to set up the subjects your Maktab classes will teach (e.g. Quran Reading, Islamic Studies, Arabic). These subjects appear when teachers record Maktab progress.
Curriculum page with active subjects

Screenshot: Curriculum page with active subjects

curriculum-page.png
6. Managing Staff & Students
Add your people and assign them to classes

Adding Staff

Headteacher Office
1
Add Staff Members
Go to Staff and tap Add Staff. Enter their name, email, phone number, and select their role (Teacher or Office). An account is created for them automatically — they'll receive login details. You can also bulk import staff using the Excel template.
Staff page with staff list and Add Staff button

Screenshot: Staff page with staff list and Add Staff button

staff-page.png
2
Assign Staff to Classes
Open any class from the Classes page and assign a teacher. Alternatively, you can assign classes when adding a staff member. Each class can have one teacher assigned.

Adding Students

Headteacher Office
1
Enrol Students
Go to Students and tap Add Student. Enter their details including name, date of birth, class assignment, and parent/guardian contact information. A parent account is created automatically when you enter parent details. You can also bulk import students from Excel.
Students page with student list and stat cards

Screenshot: Students page with student list and stat cards

students-page.png
Parent Accounts: When you add a student with parent details, the parent automatically gets their own login to view their child's attendance, progress, homework, and messages.
2
Student Profiles
Each student has a detailed profile with their personal information, class assignment, attendance history, progress records, and medical notes. Tap any student's name to view their profile.
Student profile page

Screenshot: Student profile page

student-profile.png
7. Daily Use — Attendance & Progress
Track attendance, Maktab reading, Hifdh memorisation, and homework

Attendance

Headteacher Office Teacher
1
Mark Student Attendance
Go to Attendance. Select the date and class. Each student is listed with quick-tap buttons for Present, Late, or Absent. Teachers see only their own class; headteachers and office staff can view and mark any class. You can also add notes for individual students and export records to Excel or PDF.
Attendance page with student list and Present/Late/Absent buttons

Screenshot: Attendance page with student list and Present/Late/Absent buttons

attendance-page.png

Staff Clock In/Out

Teacher Office
1
Clock In via QR Code
Staff go to Clock In/Out and tap Scan QR Code to record their arrival. The headteacher generates and displays the QR code for staff to scan. Clock-out works the same way. Today's record shows clock-in time, duration, and status.
Clock In/Out page with QR scan button and today's record

Screenshot: Clock In/Out page with QR scan button and today's record

clock-page.png

Maktab Progress

Teacher Headteacher
1
Record Quran Reading Progress
Go to Maktab Progress. Teachers select a student from their class and record what page, surah, or section they've reached. Headteachers and office staff can select any class and student to view progress across the maktab.
Maktab Progress page with student selector and progress form

Screenshot: Maktab Progress page with student selector and progress form

maktab-progress.png

Hifdh Progress

Teacher Headteacher
1
Track Quran Memorisation
Go to Hifdh Progress. For each student, teachers record their daily Sabak (new lesson), Sabak Para (recent revision), and Dhor (older revision) — including the surah, ayah range, and quality rating. Teachers can also add notes for each entry.
Hifdh Progress page with Sabak/Para/Dhor sections

Screenshot: Hifdh Progress page with Sabak/Para/Dhor sections

hifdh-progress.png

Homework

Teacher Parent
1
Assign & Track Homework
Teachers go to Homework and tap Assign Homework to set work for their class. Stats at the top show assigned, complete, overdue, and incomplete counts. Parents see their child's homework in their own app and can tap Mark Done when complete — the teacher then verifies and marks it as officially complete.
Homework page with stats and student list

Screenshot: Homework page with stats and student list

homework-page.png
8. House Points
Motivate students with a reward system
Headteacher Office Teacher
1
Set Up Houses
The headteacher can configure houses (teams/groups) via the Settings icon on the House Points page. Create houses with names and colours, then assign students to them.
2
Award Points
Teachers and staff can award house points to individual students directly from the House Points page. Select a student, choose a reason, and set the number of points. Points update in real time across all devices.
House Points page with leaderboard and award button

Screenshot: House Points page with leaderboard and award button

house-points.png
3
View Leaderboard & Export
The page shows a house leaderboard and individual student rankings. Export data to Excel or PDF for assemblies or reports.
9. Fees Management
Set up fees, track payments, and send reminders
Headteacher Office
1
Configure Fee Settings
On the Fees page, tap the Settings icon to set your fee amounts, payment frequency, and any fee categories. Fees can be configured separately for Maktab and Hifdh programmes — use the Switch to Hifdh/Maktab button to toggle between them.
2
Track Payments
The fees page shows an Academic Year Overview with total expected, collected, outstanding, and collection rate. Below that, each student's payment status is listed with the amount due and paid. Record payments as they come in.
Fees page with yearly overview and student payment list

Screenshot: Fees page with yearly overview and student payment list

fees-page.png
3
Send Payment Reminders
Tap Send Reminders to notify parents of outstanding fees. You can also export all fees or just outstanding fees to Excel or PDF.
Parents can view their own child's fee status in their parent app — they'll see what's been paid and what's outstanding.
10. Reports
Generate progress and attendance reports
Headteacher Office Teacher
1
Choose Programme & Filters
Go to Reports. Toggle between Hifdh and Maktab programmes at the top. Then filter by class and select a specific student to view their detailed report.
2
View Report Tabs
Reports are organised into tabs: Summary (overview of progress and attendance), Monthly (month-by-month breakdown), and detailed data views. Each tab shows relevant statistics, charts, and records.
Reports page with programme toggle, filters, and summary tab

Screenshot: Reports page with programme toggle, filters, and summary tab

reports-page.png
3
Export Reports
All reports can be exported for printing or sharing. Use these for parent meetings, governing body updates, or internal reviews.
11. Settings
Manage your maktab configuration and preferences

Settings are organised into tabs based on your role. Headteachers have access to all settings; other roles see a subset relevant to them.

Organisation
Update your maktab name, contact details, and address.
Schedule
Modify operating days, times, and Hifdh session configuration.
Features
Toggle features on or off — e.g. homework, house points, messaging.
Permissions
Control what teachers and office staff can access.
Term Dates
View and manage your academic terms.
Appearance
Switch between Light, Dark, or System theme.
Year End
Run the Year End Wizard to promote students and prepare for the new academic year.
My Account
Update your personal details and password.
Settings page with tab navigation

Screenshot: Settings page with tab navigation

settings-page.png
Changes are saved when you tap Save. An unsaved changes banner appears at the bottom of the page if you have pending changes, with options to Save or Discard.