User Guide

1. Getting started

There is nothing to install or sign up for. Open qurani.space in any modern browser and you are immediately on the first flashcard.

Your progress is stored automatically in your browser. If you clear your browser data or switch to a different browser or device, your progress will not follow — this is by design (see the Privacy Policy for why). The login button in the header is for site administrators only; you do not need it to use the app.

2. Anatomy of a flashcard

Every card shows you four things:

• The Arabic word, large and centred, in a Quranic-style script.
• A transliteration in Latin letters underneath, to help with pronunciation if you don't read Arabic yet.
• The English meaning, kept short — usually one or two senses.
• A status badge in the top corner once you've classified the word as Learned or For Review. Untouched cards show no badge.

The card counter (e.g. "3 of 47") tells you where you are in the current stack. The stack changes as you adjust filters.

3. Moving through cards

You have three equivalent ways to navigate:

• Swipe. On a touchscreen, swipe the card left or right. Click and drag works the same way on desktop.
• Buttons. Use Previous and Next above the card to step through without classifying.
• Action buttons. The Learned and Review buttons below the card both mark the current word and advance to the next one.

Note: swipe gestures both classify and advance. If you only want to flip past a card without committing to a status, use the Next arrow.

4. Marking words: learned vs. review

• Swipe right (or tap Learned): you know this word. It moves into your Learned bucket.
• Swipe left (or tap Review): you'd like to come back to this word. It moves into your For Review bucket.
• A word can only be in one bucket at a time. Marking a "review" word as "learned" moves it across, and vice versa.

The progress bar at the bottom of the screen and the counts in the filter buttons update in real time.

5. Filtering your stack

Two filters work together to give you the exact set of words you want to study.

By status

The four buttons above the card switch between status views:

• All — every word in the current tag selection.
• To Learn — words you have not yet classified.
• Learned — only the words you've marked as learned.
• Review — only the words you flagged for another pass.

By tag

The dropdown labelled Filter by Tags lets you pick one or more categories:

• Nouns
• Verbs
• Daily-Use Phrases

Selecting nothing is treated the same as selecting everything. Selected tags appear as removable chips below the dropdown — click the × on a chip to drop it.

Tip: a focused session — for example, "Verbs only, To Learn only" — is usually more productive than scrolling the entire deck.

6. Seeing the word in context

Tap Show Verses on any card to open a panel listing every verse in which the word appears. Each entry shows:

• The surah (chapter) and verse reference.
• The Arabic verse, with the word — and its alternate grammatical forms — highlighted in yellow.
• A transliteration of the verse.
• An English translation.

Close the panel with the × in the top-right of the card to return to the flashcard face.

7. Suggesting an edit

Found a typo, a better English meaning, or a transliteration that could be clearer? Tap the Suggest Edit (pencil) button on the card. Fill in:

• The Arabic, transliteration, and meaning fields with your proposed change.
• An optional Notes line explaining your reasoning (e.g. "Hans Wehr gives this as 'reverence' rather than 'fear'.").
• If you are not signed in, a short arithmetic CAPTCHA to confirm you are human.

Submissions go into a queue and are reviewed by an admin before they are applied. Thank you in advance for helping to improve the content.

8. Tracking progress

• The number on each filter button is a live count for that bucket.
• The text under the card shows Learned and For Review counts against the total in your current tag selection.
• The green progress bar visualises overall completion.
• The Reset Progress button (bottom right of the card area) clears every status mark and starts you back at zero. This is permanent — there is no undo.

9. Theme and display

Use the sun/moon icon in the header to cycle between Light, Dark, and System themes. System follows your operating system's preference and updates automatically when it changes.

The Arabic font is sized large by default for readability and scales up further on tablets and desktops.

10. Installing as an app (optional)

Qurani.Space is a Progressive Web App, so you can pin it to your home screen for a full-screen, app-like experience.

• iPhone / iPad (Safari): tap the Share button → Add to Home Screen.
• Android (Chrome): tap the menu (⋮) → Install app or Add to Home screen.
• Desktop (Chrome / Edge): click the install icon in the address bar (a small monitor with a down-arrow) when offered.

The installed app uses the same browser storage, so your progress carries over.

11. Tips for effective study

• Short, frequent sessions beat long ones. Ten minutes a day is more effective than an hour once a week.
• Use the Review bucket honestly. Anything that wasn't instant recall belongs in review, not in learned.
• Read the verses. Don't skip Show Verses — seeing the word in real Quranic sentences is what makes it stick.
• Cycle your filters. Spend one session in To Learn, the next in Review, occasionally a refresh in Learned to keep words fresh.
• Try one tag at a time. Mastering all the most common nouns first, then verbs, builds a clearer mental model than mixing.

12. Troubleshooting

• "My progress disappeared." The most common cause is clearing browser data, switching browsers, or using private/incognito mode. Progress is tied to your browser's local storage on a per-device basis.
• Cards won't load. Check your internet connection and reload the page. The first load fetches the vocabulary; subsequent navigation is instant.
• Swipes feel jumpy. Try the Learned / Review buttons instead — they do exactly the same thing without relying on gesture recognition.
• The text looks small or cut off. Try rotating your device, or switch to a larger screen — the layout expands at tablet and desktop widths.

13. Getting help

For bug reports, content corrections, or general feedback, email contact@qurani.space.