وقاية

Wiqaya

Your screen time, redeemed.

A small Chrome extension that watches the time you spend on the sites you cannot put down — and, when the hour you set has passed, opens a single verse of the Qur’ān before letting you continue.

Install Extension Watch demo GitHub
Quran Foundation Hackathon · 2026
Demo · 2:45

See it in action

A short narrated walkthrough — the problem, the idea, and the verse experience.

I  ·  The Method

How it works

Four small movements, repeated patiently — the rest is up to you.

1

Add the sites

Name the places you keep returning to without intending to — Twitter, Reddit, YouTube, or any other.

2

Set a limit

Choose a number of minutes that feels honest. A single global limit, or a different one per site.

3

Browse, while it counts

A small badge on the toolbar tracks the time. When you change tabs or step away, it pauses.

4

Pause, and read

When the limit is met, a verse opens over the page. Read it, listen to it, and carry on.

II  ·  Features

Designed for contemplation

Every detail is small, restrained, and chosen with intention.

Arabic in Uthmani Script

Set in Amiri, full-width, the verse is the page. The translation arrives only when you ask for it.

Reveal Translation

English first hidden behind a small gesture, so the eye reads the Arabic before the mind reaches for meaning.

Audio Recitation

A quiet audio plate with waveform; choose between five reciters, or set the verse to play automatically.

Bookmarks

Save verses you wish to return to. They're kept under Saved, away from the rush of the day.

Live Dashboard

Today's verses, time per site, and your streak — three numbers, nothing more.

Light & Dark Themes

A warm, paper-like light mode for the day; a hushed dark mode for the night.

Reading Streaks

A gentle counter of days kept. Not a leaderboard — only a record of your own consistency.

Engagement Gating

"Continue Browsing" waits, by design, until you have actually engaged with the verse. No reflex dismissal.

Local-First Privacy

Your watchlist and time data never leave your browser. Only the verse APIs and your account are touched.

III  ·  Provenance

Powered by trusted sources

All Qur'ānic content arrives in real time from the Quran Foundation.

Content API · v4
Public; client-credentials grant.
  • Get/api/v4/verses/random
  • Get/api/v4/quran/translations/{id}
  • Get/api/v4/recitations/{id}/by_ayah/{key}
  • Get/api/v4/chapters
User API · v1
OAuth 2.0 — Authorization Code with PKCE.
  • Post/auth/v1/bookmarks
  • Get/auth/v1/bookmarks
  • Post/auth/v1/reading-sessions
  • Get/auth/v1/streaks
IV  ·  Built with

Modern web technologies

A small, sturdy stack — chosen for clarity and longevity.

Extension
Chrome Manifest V3
Frontend
React 18 + TypeScript
Styling
Tailwind CSS v4
Build
Vite 6 + @crxjs
Auth
OAuth 2.0 + PKCE
Overlay
Shadow DOM (isolated)
Content API
Quran Foundation v4
User API
Quran Foundation v1
Fonts
Amiri + Cormorant + Inter
V  ·  To Begin

Install Wiqaya

Two paths in — one for trying it now, one for changing the source.

For everyone

From release

No build step. Pre-built bundle, ready to load.

  1. Download wiqaya-extension.zip from the latest release.
  2. Unzip the file to any folder.
  3. Open chrome://extensions and enable Developer mode.
  4. Click Load unpacked and select the unzipped folder.
  5. Pin Wiqaya to the toolbar — click the icon to begin.
For developers

From source

Build it yourself, with your own credentials.

  1. Clone: git clone https://github.com/0xNoramiya/wiqaya.git
  2. Install: cd wiqaya && npm install
  3. Create .env with your Quran Foundation credentials.
  4. Build: npm run build
  5. Load dist/ as an unpacked extension at chrome://extensions.