For IT administrators

Everything you need to deploy and unblock Qur'an Adventure, on one page.

The short version

It is a website. There is nothing to install and no licence to buy.
Use https://quranadventure.com exactly. Not the www form, which redirects.
No student accounts. No rostering. We receive no student data.
One origin, one port: 443. Plus api.quranadventure.com for game data.
Please categorise us as Education, not Games.

Does it work here? Test it now

Run this from a student device on the network you care about, before a lesson rather than during one. It checks the same things a game does.

Install it to managed Chromebooks

Google Admin console, no Chrome Web Store listing needed:

Devices → Chrome → Apps & extensions → Users & browsers
Select the organisational unit you want.
Click + and choose Add by URL.
Enter https://quranadventure.com
Set Installation policy to Force install + pin to ChromeOS taskbar.

Use the apex, with no www. Google's own guidance says to use URLs that do not redirect to a different origin, and www.quranadventure.com redirects to the apex. Entering the www form produces an app that installs but does not behave like one.

Install it to managed Windows devices

Microsoft Edge supports force-installing a web app by URL. In Intune, Settings catalog, search for Configure list of force-installed Web Apps (WebAppInstallForceList), and paste:

[
  {
    "url": "https://quranadventure.com",
    "default_launch_container": "window",
    "create_desktop_shortcut": true,
    "custom_name": "Qur'an Adventure"
  }
]

The same policy is available through Group Policy under Administrative Templates → Microsoft Edge, and through the registry at SOFTWARE\Policies\Microsoft\Edge. Supported on Windows and macOS from Edge 80.

Hostnames, ports and protocols

Host	Port	What it is	Needed?
`quranadventure.com`	443	The games and the catalogue	Yes
`api.quranadventure.com`	443	Scores and saved games	Only if pupils sign in
Clerk sign-in host	443	Optional sign-in	Only if pupils sign in

Fonts, stylesheets, scripts and images are all served from quranadventure.com itself. We deliberately load no fonts or libraries from a third-party CDN, so there is no other host to allow and nothing of your pupils' traffic reaches anybody else.

The room games, where one screen is shared and pupils join with a short code, need no special rule at all. They use ordinary HTTPS requests to the same host, a few seconds apart, so a filter that allows quranadventure.com already allows them. There are no WebSockets, no long-lived connections and no non-standard ports anywhere on this platform.

If we are blocked

The commonest cause is category, not content. Filtering products file us under Games, and many schools block that category wholesale without realising the same setting also catches Educational Games.

We ask vendors to categorise us as Education. If your filter still has us under Games, allow quranadventure.com explicitly, or ask your vendor to recategorise us. We are happy to be copied into that request.

Privacy, in one paragraph

Every game is fully playable with no account. Playing signed out, we collect no name, no email address, no location and no identifier that persists between visits. There is no rostering and no school sign-in, so we receive no student data from you at all. There is no advertising and no third-party tracking of any kind.

Sign-in is optional and exists only to carry scores between devices. If a pupil signs in, we hold their email address with our sign-in provider, and in our own database only an opaque identifier and a handle we assign, like SteadyFalcon. We never store a pupil's name.

For a privacy impact assessment, a vendor questionnaire, a data privacy agreement or an accessibility conformance report, write to info@resourcesforislamicschools.com. See also our Privacy Policy.

On the board

The games are built to be played on an interactive panel as well as on a device. If text is small for the back of the room, turn on Classroom mode from the menu in any game: it scales the type and the touch targets up and quietens the background.

Panels vary enormously in age and browser version. If a game misbehaves on a specific panel, tell us the model and what the browser reports at info@resourcesforislamicschools.com. We would rather support an old panel than tell a class to use something else.

← Back to Qur'an Adventure