Al-Rafeeq · a friend in-deed
الرفيق

The Platform Manual

How the whole system works, in plain words. Part 1 is for learners. Part 2 is for the teaching team. Part 3 explains the ideas underneath, for anyone curious. Everything here describes what the platform does today.

Al-Rafeeq means "the companion". The platform is the digital companion to the real classes that run every week in Perth: it teaches the basics of Islam to new Muslims and to anyone starting again, it remembers where each learner is up to, and it helps the teaching team notice when someone needs a check-in.

Part 1

For learners

You can use everything without an account

The moment you open the site you can read every lesson, play the alphabet game, walk through wudu step by step, and browse the classes. Nothing you do is sent anywhere: your progress is saved on your own device only, and no record of you exists on our side. This is not a limited trial mode; it is the normal way to start.

An account exists for exactly one reason: so your progress can follow you to another device. If you only ever use one phone, you may never need one.

Finding your way around

PageWhat it is
HomeThe front door: what Al-Rafeeq is and where to start
LearnYour journey: the next lesson, your progress rings, both tracks
AlphabetThe Arabic letters: meet them with sound, then play the path game
ClassesThe real weekly classes, with registration, plus other events around Perth
LibraryThe class books as short tap-through lessons, one step at a time
Sign inA six-digit code by email. There are no passwords anywhere

"How to pray, right now"

The button on the home page is there for one moment: prayer is in twenty minutes and you do not know what to do. It gives you enough to pray tonight, immediately: face the qiblah, move when you hear Allahu akbar, say SubhanAllah in each position. That is genuinely acceptable while you are learning; your teachers taught it this way long before there was an app. Below it sits the full ladder you will climb at your own pace.

Lessons, rings, and days walked

The Learn page shows one recommended next step at a time, never a wall of choices. Under it, six rings show what you can do so far: wudu, prayer postures, Al-Fatihah, a short surah, foundations, attendance.

A line we do not cross

Nothing here ever counts your worship. No prayer counter, no fasting tracker, nothing of the kind, stored or hidden. What you owe to Allah is not ours to score. The rings count study only, and days walked counts days you studied; a gap does not reset anything.

Some lessons end with a button you cannot press: "Show a teacher". That is deliberate. Reading instructions off a screen cannot tell you whether the words are coming out right; one person listening once can. Those steps unlock when a teacher confirms them, in class or on a call, and they are the whole reason this platform exists. Once confirmed, it shows as done on your own Learn page, no button of yours to press; finishing every lesson and having at least one of these confirmed is also a second way to earn your certificate of participation, alongside simply attending enough classes.

The alphabet

Some letter sounds are native-speaker recordings, the rest use a studio voice for now; the teacher's own voice will replace them all.

Creating your place (an account)

On the register page you give a name (any name you like, it does not have to be your legal one), an email, and you tick permissions:

BoxWhat it allowsRequired?
Box 1Store your name and email so you can sign inYes, for an account to exist
Box 2Store which lessons you have done, and which prayer instruction to show youNo. That is information about religious belief. Sign-in and the whole site still work without it; what changes is that your progress stays on this device only, instead of following you to another one

Once box 2 is ticked, you are also asked where you are starting: Just exploring, New Muslim, Returning to practice, or Been Muslim a while. It is optional and skippable, and it only helps us know where to start you. Choosing Just exploring carries the same promise as the teacher's queue below: nobody ever chases you.

Then a six-digit code arrives by email. It works once and expires in fifteen minutes. Type it in, and if box 2 is ticked your progress from this device carries over and your step count never goes down when you sign up; without box 2, that progress simply stays on this device. The email comes from a plain address and does not name the organisation, in case someone else sees your inbox.

Which prayer instruction should we show you?

The covering required during prayer differs for men and women, so the pictures differ. You choose: Brothers, Sisters, Show me both, or Not sure yet (which shows no body imagery at all and suggests a word with a teacher). This is a display choice, not a question about who you are, and you never have to answer it.

Classes

The Classes page shows the real weekly classes with live seat counts. Registering needs an account. When you register:

Happening elsewhere lists talks and gatherings around Perth chosen by hand by our team. The line under each one, "Listed for information. Al-Rafeeq is not the organiser", means exactly that.

Your certificate of participation

There are two ways to earn one. The first: attend enough of a class's sessions, worked out from real attendance, never guessed. The second: finish every lesson in the course and have a teacher confirm at least one "Show a teacher" step, on top of having attended at least once. Either way your teacher issues it from their own screen, with you present, asking exactly how your name should read on it. You get an email with a private link (unless you told us you are "just exploring", in which case no email goes out at all: your teacher hands you the link directly). It certifies that you attended, never that you are competent at anything, and never anything about worship, whichever way you earned it.

From your own certificate page you can rename it at any time, or remove your name entirely (it then reads "Name withheld" to anyone who sees it). If you ever delete your account, your name disappears from this record on its own: the class, the date, and the fact that a certificate was issued all stay, but nothing on it will name you again. The page prints A4, landscape, straight from your browser.

The library

The Library page turns the books our teaching team uses in class into short tap-through lessons: pick a lesson, move one step at a time, and finish in a few minutes. There are four so far: the practical method of wudhu, ghusl, salaah and tayammum as taught in class, forty short teachings of the Prophet, peace be upon him, on how to live, everyday fiqh, covering cleanliness, personal hygiene, wudhu and the five pillars of Islam, and Basic Aqaaid, the core beliefs of Islam. Each reading also offers itself as one long page for anyone who prefers plain text. Using the library needs no account and adds nothing to any learner profile.

Your data, your choices

One honest limit

We make things hard to notice, but we cannot make your own device private. If someone can read your phone or your inbox, they can see what is on it. Nothing on our side changes that.

Part 2

For the teaching team

Roles, and who sees what

RoleCan
TeacherThe attention queue, class rosters (names only), community listings
CoordinatorEverything a teacher can, plus the brothers/sisters session groups on rosters
Super adminEverything above, plus user management (list, roles, removal)

The session-group difference is deliberate, not an oversight: which session a learner attends is between them and their coordinator, so plain teacher accounts see names without groups. Please do not work around this by asking learners in front of others.

Signing in is the same email-code flow learners use. There are no passwords for anyone, including you.

The Needs Attention queue

The first thing you see on the admin page. It lists learners who may need a human, most urgent first:

BandMeaning
Never startedRegistered five or more days ago, opened nothing yet
QuietNo activity for 10 or more days
Very quiet21 or more days
Dormant45 or more days

Two buttons per row: Contacted after you have actually reached out (the learner leaves the queue for seven days), and Snooze for when you know why they are away (seven days, no contact recorded).

A row can also appear because of a Missed sessions chip, separate from the bands above: a learner who missed the last two in-person sessions of a class they are enrolled in or registered for shows up even with no band at all, because they are otherwise active online. That is the exact person the register exists to catch: someone who signed up, came once, then quietly stopped walking through the door while still opening lessons on their phone. The same suppressions apply identically: exploring, snooze, and recent contact all suppress the missed chip too.

What the queue deliberately does not do

It never shows anyone who marked themselves as just exploring: that suppression is absolute and no role can override it. Someone quietly exploring Islam must never receive a "we miss you" message. It shows no email addresses and sends no messages: it tells you who might need you, and the reaching out stays human, through the channels you already share.

Class rosters

On its own page, /admin/classes: each class with its registrations. Names for everyone; session groups only for coordinators and the super admin. A learner who cancels disappears on their own action; a learner who erases their account disappears from everything.

Each class links to two things: Mark roll, the mobile screen a teacher actually uses in the musallah on a phone (one tap per person, Present or Absent, an "Add a walk-in" field, and a visible "N marks not saved" queue if the signal drops so a tap is never silently lost); and Print roll, the same A4 paper backstop as before for a session with no reception at all. Typing in a paper roll afterwards works from the same mobile screen, behind an "Entering from paper" switch, so a late entry is honestly recorded as a later entry, never backdated to look like it happened live. Each learner row on Mark roll also carries three small skill chips, one per "Show a teacher" step (Wudu, Prayer postures, Al-Fatihah): an already-confirmed one shows as a tick, the rest stay tappable Verify buttons. A tap confirms it permanently, right there while the learner is standing in front of you. A wrong tap is corrected by a super admin only, with a reason on record, not undone from this screen.

Both surfaces, and the roster list itself, show the same people: everyone enrolled in the class, everyone registered for that session, and anyone already marked present or absent, including a walk-in from a previous visit who is not formally enrolled. Registrations alone are no longer the whole list.

Coordinators (not plain teachers) also see an Attendance sheet per class: a term-long grid, one row per learner, one column per session, with a CSV download for the organisation's own records. It is the one place a term of individually marked rolls turns into the actual answer: who is still coming.

Certificates

On its own page, /admin/certificates, a Certificates ready section lists every learner who qualifies and does not have a certificate yet, by either route: attended enough sessions of a class, the threshold worked out from real attendance, never a number you type in; or finished every lesson and had at least one "Show a teacher" step confirmed, alongside having attended at least once. The row tells you which way they qualified. Confirm the name with the learner, then tap Issue; the row disappears once it is done. A learner marked "just exploring" still appears here (earning what you attend is not the same as being chased for it), but the section tells you plainly that no email will go out for them: hand them the link yourself.

Each class also links to a Certificate eligibility page: who qualifies, who is exactly one session short and why, on screen only, nothing to export or print here. A learner who is one session short but marked "just exploring" is left off that list on purpose; nobody gets nudged toward attendance they never signed up for.

Revoking a certificate is a super admin action taken from the certificate's own page, and it asks for a reason first. It is permanent: a revoked certificate cannot be re-issued from this queue, and the learner sees an honest "no longer available" message rather than a broken link.

Community listings ("Happening elsewhere")

The management section lets you add a listing: title, where, when, and an optional detail line (put the event's link and one line on why it is worth going). Times are Perth times; enter them as you would say them.

Before you press Add

Each listing is your judgement call. A new revert reads a listing here as "Al-Rafeeq checked this out". List accordingly. Made a mistake? Hide removes it from the public page immediately.

Class events cannot be hidden from here: a hidden class would strand its registered learners, so classes are managed separately (ask the technical team the first time).

What staff accounts deliberately cannot do

Part 3

How it works underneath

Six promises, each one enforced by the system itself, not by policy documents.

Over a hundred automated tests run on every change, and several exist purely to protect the promises above. If one fails, the change cannot ship.

Roadmap

Not built yet, so you do not go looking

Video lessons and recitation audio (waiting on filming and recording), donations, notifications, and the native phone apps. A learner's own view of their own attendance (the register above is a staff tool for now); a certificate arrives by email and its own private link, not through a page listing your attendance history. The old website's information pages (What is Islam, FAQ) have not moved over yet either. Each arrives as its own well-tested piece, the same way everything above did.