Built in public.
Noorani is open source. You can read the code, audit the data-handling paths, fork it, and build your own. We'd rather earn trust than assert it.
View the source on GitHub github.com/WaleedNaeem/noorani-browser
The repository
Noorani's source is hosted at github.com/WaleedNaeem/noorani-browser and is open to the public. The repository layout:
/browser— the Chromium fork with our additions/prayer-engine— standalone prayer-time calculation library (JavaScript + Rust)/filter-lists— content filtering rulesets, organised by category and sensitivity/quran-assets— bundled Arabic text, translations, reciter metadata (with license info)/docs— build instructions, architecture notes, contribution guide
Licensing
Noorani's own code is released under a permissive open-source license (specific license finalised at v1.0; expected to be MIT or BSD-2-Clause to align with Chromium). Chromium components retain their upstream BSD license. Bundled third-party components each carry their own license; full attribution is in the browser's About dialog.
Built on Chromium
We want to be explicit: Noorani is a Chromium fork, the same way Chrome, Edge, Brave, Opera, and Arc are. Chromium does the heavy lifting — rendering, networking, security model, extension APIs. We add what's specific to our audience and remove what isn't.
Specifically, we rebase against Chromium stable on a predictable cadence (aiming for weekly for security updates, monthly for feature updates). We don't lag security patches.
Key dependencies
- Chromium — browser engine (BSD 3-Clause)
- EasyList and EasyPrivacy — tracker blocking lists (CC BY-SA / GPL)
- uBlock Origin filter format — block-list evaluator (GPL v3)
- Tanzil Quran text — canonical Arabic text (CC BY 3.0)
- Saheeh International, Asad, Usmani — English translations, bundled by permission
- Al-Sudais, Al-Ghamdi, Al-Afasy — reciter recordings, bundled under license
- Noto Naskh Arabic, Inter, Fraunces — fonts (OFL)
A complete SBOM (software bill of materials) is generated for each signed release and published alongside the binaries.
Contributing
Contributions are welcome under the standard GitHub flow: fork, branch, pull request. Before writing a feature-sized patch, please open an issue at github.com/WaleedNaeem/noorani-browser/issues so we can confirm it aligns with the roadmap.
Contribution areas where help is especially welcome:
- Prayer-calculation edge cases (especially high-latitude behaviour)
- Translations — UI strings in new languages
- Accessibility — screen reader compatibility, keyboard navigation
- Filter-list curation — regional trackers we haven't seen yet
- Documentation — getting-started guides in different languages
Code of conduct
Be kind. Disagree with ideas, not with people. Contributions are evaluated on technical merit and alignment with the project's direction. We don't tolerate harassment of any kind.
Acknowledgements
Noorani stands on decades of open-source work by thousands of contributors. Chromium alone represents hundreds of person-years of engineering. The Islamic calendar scholarship behind our calculation methods goes back centuries. We inherit all of it with gratitude.
A full list of contributors will be maintained in CONTRIBUTORS.md in the repository at launch.