How Hubuk works

Every feature explained: what it is, why it is useful, how to use it, and what it changes elsewhere in the app.

The film

What Hubuk is for, in three minutes, shown in the real app.

Getting started

Reading, display, and finding your way around.

Start here

Open

Hubuk is a place to build your own study of the Quran. You record what you notice as you read, connect the verses that belong together, and it all compiles into a body of knowledge you can search, map and come back to.

Why it matters

Notes in margins and notebooks scatter. Here every note is tied to its verse, every tag carries a meaning, and every link runs both ways — so what you noticed last month is still there, and still connected, when you need it.

How to use it

  1. 1Record: in the workspace, open a verse's icons and add a note — a tag, some text, or both, on one verse or a run of them. Give a tag a meaning once and it means the same thing everywhere.
  2. 2Connect: press the link icon on a verse (or Connect to another verse in the note box), then press Link here on the verse it belongs with and say why. In Compare you can drag one verse onto another.
  3. 3Compile: My Study gathers your notes and links theme by theme; the Atlas shows them across the whole Quran; Search finds anything you wrote.
  4. 4Let the Quran show you where to look: tap a word (or rest the pointer on it) for its root and every verse that uses it, and Similar & repeated on any verse for verses that share its wording.
  5. 5Collections, prepared by the Hubuk team, gather the verses on one subject — a prophet's story, the duas, the parables — ready to read and compare.

What it changes

Nothing you write is shared. All of it can be downloaded, or deleted with your account, from Account.

The workspace

Open

Your main reading surface. Pick a surah on the left and its verses load on the right, each with the translation layers you have chosen.

Why it matters

It is the one place where reading and annotating happen together — you never have to leave the text to record what you noticed.

How to use it

  1. 1Choose a surah from the list on the left — rest the pointer on the strip to slide it out, and pin it to keep it open — or type to filter all 114. Each entry says how many verses it has and whether it was revealed in Makkah or Madinah.
  2. 2Use the find bar under the surah name — or press / — to reach a verse or search inside the surah you are reading. A number goes to that verse, "2:255" goes to that verse in another surah, a surah name opens it, and anything else searches this surah's text and your own notes on it.
  3. 3The chip at the end of the find bar switches between This surah and Everywhere — the whole Quran and all your notes. Hubuk remembers your choice on this device. In Everywhere, a bare number means a surah.
  4. 4On a wide screen the verse panel sits on the right and follows the verse you are reading. Using it holds it on that verse; “Follow my reading” lets it go again.
  5. 5Read the verse in the translations and commentaries you have switched on in display settings.
  6. 6Use the small icon row beside a verse number to write a note on it or link it to another verse.
  7. 7The number badge on each icon tells you how much you have already recorded on that verse.
  8. 8In desktop Chrome, the microphone button in the top bar turns on voice commands: say “go to 2:255”, “open Compare”, “play”, “next verse”, “add a note” (then speak it and say “save”) or “link to 2:153”. While the recitation plays, press v first (it pauses the recitation while you speak), or say “hey reader” — best with headphones. Say “what can I say” for the list.
  9. 9To hear the recitation, open ⋯ on a verse and choose Listen from here, or press p. A bar at the bottom pauses, skips, repeats and changes the reciter or speed; the reading follows the verse being recited until you scroll away, and the bar offers to follow again.
  10. 10Once a day, “From your study” at the top brings back something you wrote: a past note, a question you asked a few weeks ago, or one more verse for a theme you are building. Close it and it stays away until tomorrow.

What it changes

Everything you add here immediately becomes searchable, appears in My Study and on the Atlas, and feeds the Tools graphs and the statistics on your Account page.

Shortcuts

j / kNext or previous versenWrite a note on this verselLink this verse to anotherfAdd to or remove from favouritessSimilar verses and repeated wordingwThe words of this versepListen from this verse; pause and carry onvSpeak a voice command (pauses the recitation while you speak)/Find in this surah↑ / ↓Move through the resultsEnterGo to the highlighted resultEscClear the find bar[ / ]Previous or next surah?List every key

Display settings

The gear icon in the top bar controls which translations and commentaries are shown, how large each one is, which Arabic, Urdu and English fonts are used, and which language the microphone listens for.

Why it matters

You can read Arabic-only for memorisation, or stack Arabic with Urdu and tafseer for study, without changing anything else about how you work.

How to use it

  1. 1Click the gear icon at the right of the top navigation bar.
  2. 2Choose Translations or Tafsīr at the top, then switch individual sources on or off — they are grouped by language.
  3. 3Use the − and + buttons beside each source to change its size independently.
  4. 4Pick an Arabic, Urdu and English font — each button previews the font itself.
  5. 5Set Voice Language to the language you will actually speak into the microphone.

What it changes

These settings are global. They change every verse in the workspace, search results, favourites and comparisons — and they also decide what gets copied to your clipboard and what goes into a downloaded verse.

Watch out for

  • — If a translation seems to have disappeared from a page, check whether it is switched off here — it is the most common cause.
  • — One tafsir opens under each verse by itself — the one you opened last. The others are chips beside it; tap one to read it. Turn this off with “Open tafsir automatically” on the Tafsīr tab.
  • — A commentary on several verses opens under the first of them; the verses after it say which verses it covers and that it is above.
  • — While you read a long commentary its heading stays at the top of the screen, so you can close it without scrolling back up.
  • — Voice input uses the language selected here. Speaking Urdu while this is set to English produces nonsense.

The verse toolbar

The few icons beside every verse number: notes, links, favourite, similar verses, and ⋯ for everything else.

Why it matters

Every action you can take on a verse is one click away, and the badges show at a glance which verses you have already worked on.

How to use it

  1. 1Tap any word of the Arabic for its meaning and root — or, with a mouse, rest the pointer on it for a moment.
  2. 2Notes icon — write a note, or read the ones you have, with one count. With nothing yet it stays faint until you point at the verse.
  3. 3Link icon — link this verse to another; once it has links it shows their count and lists them.
  4. 4Heart — save the verse to Favourites, or remove it. A favourite also shows a heart beside the verse number.
  5. 5Similar & repeated — verses worded like this one; resting the pointer on it opens the list.
  6. 6⋯ — open in Compare, ask the AI, the verse details (every translation and tafsir, the words, your notes), copy, or report a problem.
  7. 7On a wide screen the verse panel sits beside the workspace and follows the verse you are reading.
  8. 8The verse number on any page — search, links, similar verses, chat — opens the workspace at that verse.

Watch out for

  • — The link badge counts links pointing at this verse as well as links you created from it, so a verse can show links you did not make.
  • — A note on a run of verses is counted, and listed, on every verse it covers.
  • — Copy only includes the layers currently switched on in display settings.

Favourites

Open

A simple saved list of the verses — and runs of verses — you have hearted.

Why it matters

A shortlist for verses you keep returning to, without needing to remember where they were.

How to use it

  1. 1Press the heart on a verse, or in the verse panel. A run of verses can be saved as one favourite, and is listed once with its verses under it.
  2. 2Open Favourites in the top navigation to see the full list.
  3. 3Remove one the same way — the heart on the verse or in the verse panel.

Your account

Open

Your study at a glance — a year of activity and what you have written — and the settings for your login: your name, your data, signing out, and deleting your account.

Why it matters

One place for your own progress and for the things that affect your login rather than your research.

How to use it

  1. 1Open Account from the top navigation.
  2. 2Your study leads the page; see its own topic for the activity calendar.
  3. 3Edit your name and save.
  4. 4The Danger Zone permanently deletes your account. A Google account confirms without a password, since it has none.

Watch out for

  • — Your email address cannot be changed here: it is the identity you sign in with.
  • — Deleting your account deletes everything in it — every note, link, favourite and chat, and everything else you have saved. It cannot be undone, so download your data first if you want to keep it.

Signing in

Open

Hubuk accounts sign in with Google.

Why it matters

There is no password of ours to remember or reset, and your notes are tied to the Google account you already use.

How to use it

  1. 1Choose Continue with Google on the sign-in page, and pick the account you want your notes kept under.
  2. 2Use the same Google account on the web and in the Android app to see the same notes in both.

Watch out for

  • — Signing in with a different Google account opens a different, empty Hubuk account — it is not a second way into the same one.
  • — A few demonstration accounts use a password instead. Those are set up by an administrator, who can also set a new password.

Your data, and what is measured

Open

Everything you write in Hubuk belongs to you: you can download all of it at any time, and what the app measures about its own use is deliberately limited to shapes rather than content.

Why it matters

A tool you keep years of personal reflection in should be one you can walk away from with your work intact, and one whose measurement you can read in full rather than take on trust.

How to use it

  1. 1Open Account and choose Download my data.
  2. 2You get a zip of JSON files — everything you have written, from tags and their other names, notes and links to favourites, chats and saved AI results — plus a README explaining each file.
  3. 3A single verse can also be downloaded with your notes on it, from the Download button in its details.

What it changes

Your password and sign-in tokens are never in the export. Deleting your account removes everything the export contains from the server.

Watch out for

  • — What is measured: which page you opened, which feature you used, which surah an annotation was on, how many results a search returned, and how fast the API responded.
  • — What is never measured: the text of your notes, tags or chats; the verse text; your name or email. There is no mouse tracking, no keystroke logging and no session replay.
  • — One deliberate exception: if a search returns no results, the words you searched for are recorded. A query that matched nothing has by definition matched none of your own writing, and it is the clearest signal of what the app cannot yet find.
See alsoYour account

Your study

Open

The top of your Account page: a calendar of the last year with a square for each day, darker the more you added, and a dashboard of your research — Quran coverage, counts of your notes, links and favourites, most-annotated surahs, top tags and top sources.

Why it matters

Shows both progress and blind spots — the surahs you have never touched are as informative as the ones you have covered, and the calendar shows the rhythm of your study rather than a streak to keep.

How to use it

  1. 1Open Account; Your study leads the page.
  2. 2Hover a square, or tab to it, to see the date and what you added that day.
  3. 3Click a square to list everything from that day; each item opens where it lives.

Watch out for

  • — Days are counted in your own timezone, so a note written after midnight belongs to the day you wrote it.
  • — The calendar shows what still exists. Delete a note and it leaves the day it was written.
  • — Active days, not a streak: a week away is not a failure, so nothing counts down.

Reporting a problem or an idea

Open

One form for anything you want the people who build Hubuk to know: something broken, an idea, a mistake in a verse, its words or a translation, or anything else. My reports lists what you have sent, what is happening with each, and any reply.

Why it matters

A report with a screenshot and the page it happened on can be reproduced and fixed; a text error tied to its verse can be checked against the source. Ideas decide what gets built next.

How to use it

  1. 1Open the ? menu in the top bar and choose Report a problem or idea — or use the flag on a verse's details to report an error in that verse, which fills in the verse for you.
  2. 2Pick what it is about and describe it. For a text or translation error, name the translation if it is one.
  3. 3Add up to three screenshots and one short video: choose files, drop them on the form, or paste a screenshot straight in.
  4. 4Open Details sent with it to see exactly what else goes with the report, and remove any line you would rather not send.
  5. 5Tick the agreement and send. Follow it under My reports, where you can also withdraw it.

Watch out for

  • — Photos have their location and camera data removed on your device before they are uploaded. Videos are sent as they are, so prefer a screen recording to a phone video.
  • — Images can be up to 5 MB, videos up to 25 MB and 60 seconds. Attachments are kept for a year.
  • — Withdrawing a report deletes it and its attachments; so does deleting your account.

Study guides

Step-by-step ways to use Hubuk for a real piece of study, from start to finish.

Study a theme in an evening

Open

Gather what the Quran says on one theme — patience, trust, mercy — and keep what you notice, so the theme is there, whole, the next time you come back to it.

Why it matters

Read verse by verse, a theme is scattered across the whole Quran. Filed under one tag with a meaning, with your notes and the links between its verses, an evening's reading becomes something you can open again in a second.

How to use it

  1. 1Find the verses. In Advanced Search, add a Root condition (for patience, ṣ-b-r) or a Text condition, and read the results in order.
  2. 2Name the theme once. Tag the first verse — say “Sabr” — then give the tag a meaning in Managing your tags. Every verse you tag after that shares it.
  3. 3Tag each verse that belongs. Where a run of verses makes one point, give the note the whole range instead of tagging each verse.
  4. 4Write as you go: a note where something strikes you, and a question where something does not add up yet — written as a note, ending in a question mark.
  5. 5Connect what belongs together. Press the link icon on a verse, press Link here on the verse it belongs with and write a line on why — or drag one verse onto another in Compare.
  6. 6See it whole. Open My Study and pick your tag: every note and link under it. On the Atlas, pick the tag under Find → My notes to see where the theme falls across the Quran.

What it changes

The theme is now searchable, mapped and linked. Once your tags start landing on the same verses, the Thematic Cluster Map begins to draw them together.

Prepare a lesson from your notes

Open

Turn a theme you have been building into the outline for a class, a study circle or a khutbah.

Why it matters

The hard part of preparing a lesson is remembering what you already found. When the verses, your notes and the links between them are filed under a tag, most of the outline is there before you start.

How to use it

  1. 1Open My Study and pick the theme's tag. Read down what you have gathered, and pick the four or five verses that carry the point.
  2. 2Put parallel passages side by side in Compare — up to 15 surahs — to show how a point is made in more than one place. Drag a verse onto another to record the connection.
  3. 3Read each verse with a commentary layer switched on in the reading settings, and add a note with what you want to say about it, and where it came from.
  4. 4Check nothing is missed with Search: one query covers your own notes as well as the text.
  5. 5To take a verse into your notes or slides, open its details and choose Download: the verse comes with your notes on it.

Keep notes from lessons and books

Open

Record what a teacher, a lecture or a book said about each verse, so it is kept with the verse rather than in a notebook.

Why it matters

Notes from a lesson are only useful if you can find them from the verse later. With the lesson's tag on every note, you can also see everything one teacher or book said, in one place.

How to use it

  1. 1When the lesson reaches a verse, go to it in the workspace — type its reference, such as 2:255, in the find box.
  2. 2Add a note with the point that was made, or the question to look up later. Voice input lets you dictate in English, Urdu or Arabic.
  3. 3Give each note the lesson's tag — the same name each time, such as the teacher or the book — so the notes group together.
  4. 4Later, open My Study and pick that tag: every note from the lesson, verse by verse.
  5. 5Search finds any of it again from a word you remember.

Build a reflection habit

Open

Read a little each day and keep one thought from each sitting.

Why it matters

Small, regular reflection adds up to a record of how your understanding grew — and seeing the days add up is a quiet reason to come back.

How to use it

  1. 1Open the workspace. It remembers where you stopped, so you carry on from the next verse.
  2. 2Read a few verses with the translations you prefer. When one stops you, add a note — a line or two is enough — or a question to carry with you.
  3. 3If a word catches your attention, tap it to see its root and where else it appears.
  4. 4On Account, Your study shows the days you were active — active days, not a streak — and how much of the Quran you have annotated.
  5. 5After a few weeks, open My Study or the Thematic Cluster Map to see the themes you keep returning to.

Trace a word through the Quran

Open

Follow one word, through its root, everywhere it appears — and record what you find.

Why it matters

Arabic roots are how the Quran's vocabulary connects. Seeing every place a root appears often shows a meaning no single verse makes plain.

How to use it

  1. 1In the workspace, tap a word in a verse (or rest the pointer on it) to see its root's meaning, and read every verse that uses it.
  2. 2To see where it falls across the whole Quran, follow the root on the Atlas, or add it to the Occurrence Chart.
  3. 3Tag the verses that matter with a tag for the word or idea, and give the tag a meaning.
  4. 4Where two uses belong together, link the verses.
  5. 5Advanced Search can then combine the root with a phrase, or with one of your tags, within the same verse.

Annotating

Turning what you notice into something you can find again.

Notes and links

Two kinds of annotation you can attach to verses. A note is a tag, some text, or both, on a verse or a run of verses — a thought, a reflection, or a question to come back to. A link joins a verse, or a run of verses, to another.

Why it matters

This is what turns reading into a body of work. Every note is searchable, groupable and visualisable later — instead of scattering across notebooks and margins.

How to use it

  1. 1Press the Notes icon on the verse toolbar. On a verse with no notes, a note box opens right under the verse; otherwise press Write your note… at the top of the notes.
  2. 2Write what you want to keep. Some text is enough; so is a tag alone — type it in the small Tag box under the text, where your own tags drop down as you type, or type a new name. A note has one tag; clear the box to take it off. A note with only a tag shows as a chip, a note with text as a card.
  3. 3If the note is about more than this verse, press + more verses — see Notes on a run of verses.
  4. 4Need a second tag? + Add another note puts a second entry under the first, on the same verses, and Same text as above copies what you typed into it. Each entry is saved as its own note, and they all save together or not at all.
  5. 5Save, or press Ctrl+Enter (⌘+Enter on a Mac). Enter on its own starts a new line.
  6. 6To join verses, press the link icon on the verse. A bar comes up at the bottom of the screen and every other verse shows Link here — scroll to it, or type its reference, some words or a root (rahma) in the bar; the eye beside a result shows the whole verse. Press Link here, say why if you like, and save. Either end is a small pill (2:153 ▾) that opens the range picker, so it can be stretched into a run, and the bar offers to link the same verse again.

What it changes

New tags immediately become available in every autocomplete, in My Study and in search, and are counted in the Tools graphs and your statistics.

Watch out for

  • — A note with three tags is three notes with the same text. Each is its own: editing or deleting one never touches the others.
  • — Notes are private: only you can see them. There is no public switch on a note.
  • — Counts say notes. A question is a note like any other, and counted once, as a note.
  • — Reflections are called tadabbur in some older exports and API responses — they are notes with text.

Words and roots

A word-by-word breakdown of a verse — transliteration and a meaning for each word, plus the Arabic root it comes from and how often that root occurs in the Quran.

Why it matters

Roots are how the Quran's vocabulary actually connects. Seeing them makes patterns visible that translations flatten out.

How to use it

  1. 1Tap any word in a verse's Arabic, or open Words in the verse panel for every word at once.
  2. 2Read across the words; each shows its root and that root's total occurrences.
  3. 3The meaning is in Urdu when you have an Urdu source switched on, and in English otherwise.
  4. 4Open Search → Roots to see every verse a root appears in (the alphabet bar jumps by first letter), or ask the Explore Root AI tool.

Compare

Open

Up to 15 surahs side by side, each in its own scrolling column with its own find bar — and the fastest way to create links between verses.

Why it matters

Parallels and contrasts are far easier to see when the two passages are next to each other, and you can record the connection the moment you notice it.

How to use it

  1. 1Press Add Surah for each surah you want, up to 15, or Start from a collection to open a group's passages side by side.
  2. 2Scroll each column on its own, or use its find bar: a number goes to that verse, and words search that surah and your notes on it.
  3. 3Drag a verse from one column and drop it onto a verse in another.
  4. 4The link dialog opens pre-filled with both verses — add a description and save.

What it changes

Links made here show up on both verses' toolbars, in search, and as edges in the Cross-Reference Explorer graph.

Watch out for

  • — Dropping a verse inside its own column does nothing — links must cross columns.
  • — Four columns share the width of the screen; with more, the row scrolls sideways so each stays readable.

Managing your tags

Open

A tag is a thing in its own right, not just a word repeated on each verse. It has one name, one meaning, and can have other names that point at it.

Why it matters

Renaming used to be impossible: the word was stored separately on every note and link, so fixing a typo meant redoing all of them. Now you rename once and everything follows. Two tags that turned out to mean the same thing can be merged into one.

How to use it

  1. 1Open My Study → Notes & tags. Each tag shows how many times it is used — on notes and links together.
  2. 2Use the gear beside a tag to rename it, say what it means, or merge it into another.
  3. 3Add an 'also known as' so a second spelling reaches the same tag instead of creating a new one.
  4. 4Archive a tag to hide it, and the notes that are nothing but that tag. A note with text stays, without the label, so the reasons you wrote are never lost.
  5. 5A tag nothing uses any more is kept and marked unused, ready to be used again. Filter to unused tags to archive them all at once, or delete one from its gear.

Watch out for

  • — Capitalisation no longer matters. Typing 'mercy' where 'Mercy' exists attaches to the existing tag.
  • — A tag has two kinds of description. The one on the tag says what it means, everywhere. The text of a note you write with the tag says why it is on those verses, and is different every time.
  • — Merging keeps the old name as an alias, so typing it still finds the merged tag.
  • — Archiving is reversible. Deleting is not, which is why only a tag nothing uses can be deleted — a tag still in use is archived or merged instead, so nothing written with it is lost.
  • — Removing the last note that uses a tag does not delete the tag: its name, meaning and other names are your own vocabulary.

Notes on a run of verses

Open

A note — or a link, or a favourite — can cover a run of verses instead of one: 2:153–157 rather than five separate verses. A single verse is simply a run of one.

Why it matters

Some things are true of a passage rather than of any one verse in it. Giving the note the whole range means one card and one reason to write, instead of five that have to be kept in step by hand.

How to use it

  1. 1In the note box, press + more verses: the run starts at the verse you opened it from, and the end can be picked, stepped on with + next verse, or typed (2:153-157). Every entry in the box sits on the same run.
  2. 2A range may cross into the next surah — 105:5-106:1 is allowed — and is shown as 2:286 – 3:2.
  3. 3The note is then listed on every verse in its range, with its range as its label, and counted on each of them.
  4. 4To change where a note ends, edit it (+ more verses again on a one-verse note) and change the range. Nothing else about it moves.
  5. 5A link joins a range to a range: both ends are chosen the same way, and the Links panel shows every verse of the other end.

Watch out for

  • — Each note owns its range. Two tags on the same run are two notes, so changing one never moves the other.
  • — Anything below a whole verse — a phrase inside a verse — is not a range. Say it in the note's text.
  • — A verse that does not exist is refused, not rounded: 2:300 is a broken reference, not the end of al-Baqarah.

Exploring

Searching and browsing everything you have built.

Similar verses and repeated wording

Two lists behind the Similar & repeated button on every verse (rest the pointer on it), and under Similar in the verse panel. Similar Verses are verses that share a run of wording with this one, ranked by how much they share. Repeated Wording lists exact phrases from this verse that occur elsewhere, with how many verses and surahs each reaches.

Why it matters

The Quran often says a thing more than once, in the same words or nearly. These lists show you where, so you can read the parallels together — and keep the connection with one click.

How to use it

  1. 1Rest the pointer on Similar & repeated on a verse, or press it; it also sits under Similar in the verse panel.
  2. 2Open a similar verse to see the shared words marked. The bar shows how much of the verse you are reading the match accounts for.
  3. 3Open a repeated phrase to see every verse it appears in, each with the phrase marked where it sits.
  4. 4Press Link beside any of them to link it to the verse you are reading, with a line on why.

What it changes

A link made here is an ordinary link: it shows in both verses' Links, in the Cross-Reference Explorer and on the Atlas.

Watch out for

  • — Both lists are worked out from the Arabic text and are the same for every reader. The verses you linked yourself are under Links, not here.

Collections

Open

Verses gathered by subject by the Hubuk team — the prophets' stories, duas, parables and more — each group with its passages in order and a short note on each.

Why it matters

The gathering is done for you: every telling of a story, or every verse on a subject, in one place, ready to read side by side and write about.

How to use it

  1. 1Open Collections in the top bar. A shelf holds groups, and a group can hold smaller ones; open one to see its passages, each with its verses and a short note.
  2. 2Press Open in Compare on a group, or the columns icon beside a row, to read its passages side by side.
  3. 3On any verse, the verse panel lists the collections it belongs to, under In collections.

Watch out for

  • — Where a group draws on a book, it names it. Collections are the same for every reader; what you write about them stays in your own notes.
  • — “You have notes on 3 of its 8 passages” counts your notes, not your reading. New marks a group added in the last two weeks.

My Study

Open

Everything you have kept, theme by theme. Under My Study → Notes & tags, pick a tag on the left and see everything it touches on the right; My collections, beside it, holds the study plans you saved.

Why it matters

Search answers a question you already have. My Study shows you what you have accumulated — including themes you did not realise you had been building.

How to use it

  1. 1Open My Study in the top bar. Filter the list of tags on the left, then select one.
  2. 2For a tag, the right-hand side groups everything carrying it — notes and links — as sections you can open one at a time. The number beside the tag is the total of those sections, so it always matches what you can see.
  3. 3Every verse carrying it appears on the right, with the matching word marked in the text.
  4. 4Roots, which need no notes at all, are under Search → Roots.

Watch out for

  • — “Unused” means used nowhere at all, because that is what Archive all unused acts on.

Copying and exporting

A verse can leave the app with your notes on it, and the Occurrence Chart can leave as a picture or an interactive page.

Why it matters

Your research can go into a lesson, a document, a slide, or a backup without being retyped.

How to use it

  1. 1Use the Copy icon on the verse toolbar for a quick clipboard copy.
  2. 2Open a verse's details and use Download for the verse with everything you have written on it — as text, Markdown, JSON, a readable HTML page or PDF.
  3. 3The Occurrence Chart exports as a PNG or as interactive HTML.
  4. 4For everything at once, use Download my data on your Account page.

Watch out for

  • — Exports follow your display settings — a translation that is switched off will not be in the file.
  • — PDF opens your browser's print dialog; choose Save as PDF there.

Atlas

Open

The whole Quran drawn as one strip you can zoom into, with everything you have added marked on it, and a Find panel that lights up where words, roots and your notes appear.

Why it matters

You always see where you are in the Quran. From one screen you can go from a verse to its links, its roots and every other place a theme appears — and step back along the way you came.

How to use it

  1. 1Click the strip to go to a surah — or, once zoomed in far enough to tell verses apart, to open the verse. Scroll over it to zoom and drag to pan; the corner buttons zoom in, zoom out, or show the whole Quran again. On a phone, tap a surah, drag to move, and press and hold to preview.
  2. 2Press Z with the pointer over the strip (or double-click it) to magnify that stretch to about sixty verses; press Z or Esc to go back.
  3. 3Rest the pointer on the strip for a moment to read the verse under it, or on an arc for two seconds to read both of its verses and its note. Press Space to keep that preview open.
  4. 4The map button at the start of the strip's toolbar holds what the Atlas is, this help, and the keyboard shortcuts.
  5. 5Hover a verse square, a search result, a root's surah or a link to read the verse without opening it; click to open it. On a touchscreen, press and hold instead of hovering.
  6. 6In a verse, hover Notes or Links to preview what is there, and click one to pin its full panel open.
  7. 7Find has three tabs. Words lights up every verse a word appears in, or jumps to a reference like 2:255 or a surah by name. Roots follows a root through the Quran — type it in Arabic, spelled out (sabr, rahma) or by meaning. My notes lists your tags to pick from, and Enter searches the words of your notes.
  8. 8What is lit up shows as a chip under the strip, with how many verses and arrows to read them in order (or N and Shift+N); its last button zooms the strip to take them all in.
  9. 9Use back and forward to retrace your steps. The address bar always holds a link to where you are, so a place can be bookmarked or shared.
  10. 10Choose what the strip shows from Show: your notes and links; favourites; links; Makkan and Madinan surahs; the juz grid; and Revelation order, which lays the surahs out in the order they were revealed.

Shortcuts

/Focus Find← →Previous or next verse, or surah[ ]Back and forwardN Shift+NNext or previous match — or link, when a link is openZMagnify the strip where the pointer is; again to returnSpaceKeep a verse preview openEscStep back: preview, magnification, link, what is lit up?All Atlas shortcuts

Watch out for

  • — A verse square has a mark for your notes and a corner for a favourite, so each reads without colour. The blue dot is a link, a dashed outline is the root you are following, and an underline is a Find match.
  • — With a verse open, its links out arc above the strip and its links in arc below it; every other link fades back.
  • — Marks for individual verses appear on the strip once you have zoomed in far enough to tell verses apart.
  • — Revelation order changes where surahs sit on the strip, not what is in them.
  • — Words searches the verse text and its translations, not tafsir — a verse is not lit up because its commentary mentions the word.
  • — While a search or root is lit up, the strip answers only to its verses: the pointer snaps to the nearest one and a click opens it. Clear the search or root (Esc) to use the whole strip again.
  • — One thing is lit up at a time. Follow a root while a search is lit (or the other way round) and the new one replaces the old; Back brings the old one back.
  • — With a tag or notes search leading, the bright corners of a verse square — and the ringed buttons on an open verse — are the annotations that matched; the rest are dimmed.
  • — Links touching what is lit up stay highlighted while the rest fade. Open one and the rest of them are listed underneath to step through.

AI

The assistant, and the AI research tools.

Chat

Open

A conversational assistant that answers questions about the Quran and about your own annotations, citing the verses it uses.

Why it matters

It is the quickest way in when you do not yet know which verse you are looking for — and because it cites references, you can check every claim against the text.

How to use it

  1. 1Click New Chat and ask your question. The conversation is saved when you send the first message — an unused new chat leaves nothing behind.
  2. 2Watch the reply stream in; verse references appear as cards you can expand inline.
  3. 3Listen to a reply with its speaker button, and rate it with the thumbs so answers can be improved.
  4. 4Rename a conversation with the pencil beside its title in the list.
  5. 5Archive conversations you have finished with rather than deleting them.

Shortcuts

EnterSendShift + EnterNew line

Watch out for

  • — Verse citations in a reply are collapsed — click one to read the verse without leaving the conversation.
  • — Deleting a conversation is permanent; archiving is not.
  • — If a reply fails, your question stays in the conversation with a Retry button — asking again does not repeat it.

Voice input

A microphone button that dictates into any text box — chat messages and notes.

Why it matters

Notes in Urdu or Arabic are far faster to speak than to type, especially on a phone.

How to use it

  1. 1Set your language in display settings first.
  2. 2Click the microphone and speak.
  3. 3Text is inserted at your cursor, so you can dictate into the middle of what you have already written.
  4. 4Click again to stop.

Watch out for

  • — This uses your browser's speech recognition — it works in Chrome and Edge, and is unavailable in Safari and Firefox.
  • — Recognition language comes from display settings, not from what you are speaking.

AI research tools

Open

AI help on a verse — questions to reflect on, a short reflection, suggested tags and connected verses — under Ask → AI on a verse and in the AI tab of the verse panel; under Ask too, a study plan generator and a root explorer.

Why it matters

They break a blank page — giving you a starting angle on a verse, a vocabulary for tagging, questions you had not thought to ask, or a structured plan for a topic you want to work through.

How to use it

  1. 1Open Ask → AI on a verse and pick a verse; or, on a verse, open ⋯ → Verse details and choose the AI tab; or ⋯ → Ask about this verse, which opens the AI tab on Reflection with your angle box ready.
  2. 2Pick a tool and generate. Nothing is generated until you press the button.
  3. 3Open “Add your own angle” first if you already know how you want the verse read — that you are treating it as law rather than consolation, say, or tracing one thread through a surah. It is optional, and leaving it shut changes nothing.
  4. 4Anything useful can be added to your own account: a question or a reflection as a note, a tag as a note with that tag, a connected verse as a link, and a chat reply as a note on the verse it cites. Each opens the real form with it filled in, so you edit before saving. A suggested tag brings its reason with it, as the text of the note.
  5. 5Suggestions you add are marked Added; ones that do not fit, Dismiss. Undo puts either back. The marks are kept with the result, so reopening it from history — on any device — shows what you already did, and history says how many you added.
  6. 6Use Study Plan for a day-by-day plan on a topic. Its verses are ones Hubuk finds for the topic — your own notes under a tag of that name first, then the root and the word — and the AI only arranges them and writes a question for each day. Save it as a collection to tick the days off in My Study → My collections, and walk it in the reading view with a bar that moves between days.
  7. 7Use Explore Root for the semantic range of an Arabic root.
  8. 8Rate a result with the thumbs; it is how the tools get better.

What it changes

Accepted suggestions become real annotations, edited by you rather than taken as offered. Every generation is saved to your history on the server, so you can reopen it later from any device — along with the angle you asked for.

Watch out for

  • — “Build on what I have written” sends your reasons, notes and open questions into a study plan, so it can pick up where your own thinking stopped instead of repeating what you have covered.
  • — The angle shapes emphasis. It will not make the answer stray from the verse, and it is not a way to have a claim asserted for you.
  • — AI output is a starting point for your own study, not a ruling. Verify against the text and reliable scholarship.
  • — Undo on an added suggestion only forgets the mark. The note it made is yours and stays where it is.

AI limits

Open

Chat and the AI tools each have a daily allowance, so the service stays affordable to keep open to everyone.

Why it matters

Knowing what is left lets you save a study plan for the question that needs it, rather than finding out halfway through.

How to use it

  1. 1Each AI tool shows how many uses you have left today beside its button — for example, 2 of 3 reflections.
  2. 2Chat has a daily and a monthly allowance measured by how much is read and written, not by message count. A long answer that looks up many verses uses more than a short one.
  3. 3Allowances reset at 00:00 UTC each day, and the monthly chat allowance on the 1st.

What it changes

The tools and chat are counted separately: using up your tag suggestions does not affect chat, and a long conversation does not use up your reflections.

Watch out for

  • — If a chat answer reaches the limit partway through, it stops and says so rather than going over.
  • — A request that fails does not count against a tool's daily uses.
  • — AI features need a verified email address.
See alsoChat

Research tools

Graphs, charts, statistics, and comparisons.

Research tools

Open

Analysis and visualisation tools built on the Quranic text and on the annotations you have made.

Why it matters

They answer questions no amount of reading will: where a root clusters, which verses are hubs in your own thinking, and how two surahs share their vocabulary.

How to use it

  1. 1Open Tools and pick one — each page explains what it needs.
  2. 2Most tools need some annotations of your own before they show anything useful.
  3. 3The Occurrence Chart can be exported as an image or as interactive HTML.

Watch out for

  • — Your statistics moved to your Account page, under Your study.

Occurrence Chart

Open

Plots up to five roots, search terms, tags or sources across the whole Quran as a surah grid or a linear timeline.

Why it matters

Shows where a theme actually concentrates — often revealing that a subject belongs to one revelation period rather than being spread evenly.

How to use it

  1. 1Add up to five items, mixing types freely.
  2. 2Switch between the surah grid and the linear timeline.
  3. 3Export as an image, or as an interactive HTML file you can share.

Word Frequency Analyzer

Open

The roots a surah leans on, or the ones that recur across the whole Quran.

Why it matters

Counting alone puts the same roots on top of every surah. Ranking by what is distinctive shows what a surah is preoccupied with: the cave, the dog and the ship in Al-Kahf.

How to use it

  1. 1Choose the whole Quran, or one or more surahs.
  2. 2Rank by Count for the most frequent roots, or by Distinctive for the roots used more here than in the rest of the Quran.
  3. 3Hide very common roots to see past the ones found in nearly every surah, and page through the rest with Next.
  4. 4Use Compare surahs to set two or three surahs side by side.

Watch out for

  • — Distinctive needs something to compare against, so it is off while the whole Quran is chosen.
  • — "×3" means three times as often as in the rest of the Quran, allowing for length; "only here" means no other surah uses the root.

Thematic Cluster Map

Open

Clusters your own tags by how often they appear on the same verses.

Why it matters

Surfaces the structure hidden in your tagging — which themes you consistently treat together, and which stand alone.

How to use it

  1. 1Raise the Min Co-occurrence slider to keep only the stronger relationships.
  2. 2Click a tag to see what it connects to and the verses they share.

Watch out for

  • — This tool only uses your own tags, so it needs a body of tagging before it shows anything.

Cross-Reference Explorer

Open

Every verse-to-verse link you have made, drawn as one interactive network.

Why it matters

Shows the shape of your thinking as a whole, and the leaderboard identifies the verses you keep returning to.

How to use it

  1. 1Filter by surah or tag, or jump to a reference like 2:255.
  2. 2Filter the network to one surah or one tag.
  3. 3Check Most Connected Verses for your hubs.

Watch out for

  • — Empty until you create links — the fastest way to make them is dragging between panels in Compare.
See alsoCompare

Comparative Surah Analysis

Open

Two or three surahs compared by their vocabulary: length, unique roots and root occurrences, the roots they share, and the roots that set each apart. It reads the text only; your notes and links on these surahs are in My Study, the Atlas and the Cross-Reference Explorer.

Why it matters

Puts numbers behind an intuition that two surahs are related, shows which vocabulary they hold in common, and shows where their emphasis differs.

How to use it

  1. 1Select two or three surahs.
  2. 2Read the structural table, then the shared roots. Rank them by Distinctive to put first the roots characteristic of every surah chosen, rather than the ones common everywhere.
  3. 3What Sets Them Apart lists, for each surah, the roots it uses more than the others.

Watch out for

  • — Shared roots means roots present in every selected surah, so adding a third surah narrows the list.
  • — Counts allow for length, so a long surah does not win just by being long.