{"id":16181058,"url":"https://github.com/pr-mais/noor","last_synced_at":"2025-10-06T23:38:34.162Z","repository":{"id":42402248,"uuid":"365642209","full_name":"pr-Mais/noor","owner":"pr-Mais","description":"Noor is a mobile app designed to help in providing a comfortable reading experience for Muslims, by referencing the book \"Hisnul Muslim\", and some other references.","archived":false,"fork":false,"pushed_at":"2024-08-17T09:04:08.000Z","size":4237,"stargazers_count":118,"open_issues_count":4,"forks_count":32,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-07T13:39:24.846Z","etag":null,"topics":["dart","firebase-messaging","flutter","hacktoberfest","remote-config"],"latest_commit_sha":null,"homepage":"https://noorathkar.com","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pr-Mais.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-09T01:14:38.000Z","updated_at":"2025-04-05T01:15:19.000Z","dependencies_parsed_at":"2022-09-11T22:01:38.541Z","dependency_job_id":"0a37b0e7-914f-4ebc-82c3-99895ca56086","html_url":"https://github.com/pr-Mais/noor","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/pr-Mais/noor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pr-Mais%2Fnoor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pr-Mais%2Fnoor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pr-Mais%2Fnoor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pr-Mais%2Fnoor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pr-Mais","download_url":"https://codeload.github.com/pr-Mais/noor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pr-Mais%2Fnoor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278698611,"owners_count":26030397,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dart","firebase-messaging","flutter","hacktoberfest","remote-config"],"created_at":"2024-10-10T06:11:45.017Z","updated_at":"2025-10-06T23:38:34.135Z","avatar_url":"https://github.com/pr-Mais.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [Noor App | تطبيق نُور](https://noorathkar.com)\n\n[![Codemagic build status](https://api.codemagic.io/apps/6208f023546bd24402e57b64/6208f023546bd24402e57b63/status_badge.svg)](https://codemagic.io/apps/6208f023546bd24402e57b64/6208f023546bd24402e57b63/latest_build)\n\n\u003cp\u003e\n  \u003ca href=\"https://apps.apple.com/sa/app/نور-noor/id1463334485\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/41123719/117558302-db848980-b084-11eb-8ef8-1dac2eb5ea56.png\" atl=\"app-store-badge\" width=\"125\"/\u003e     \n  \u003c/a\u003e\n  \u003ca href=\"https://play.google.com/store/apps/details?id=com.noor.sa\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/41123719/117558323-243c4280-b085-11eb-857d-219e2c9d88c6.png\" atl=\"google-play-badge\" width=\"125\"/\u003e     \n  \u003c/a\u003e\n\u003c/p\u003e\n\n## Overview\n\nNoor is an islamic mobile app, consists of four main pages: home, favorite, alsabha, and settings. The data is structured in Cards that are easy to read, and has some actions that can be performed with the card content. Noor is designed to help in providing a comfortable reading experience for Muslims, by referencing the book \"Hisnul Muslim\", and some other references.\n\nThis project contains the codebase for the Android version that is on Play Store, it can run on iOS as well. Built with Flutter, and Firebase.\n\n## App Preview\n\n\u003cp\u003e\n   \u003cimg src=\"https://user-images.githubusercontent.com/41123719/118995957-3759e700-b990-11eb-99dc-2964369af25a.gif\" atl=\"Noor Light Mode\" width=\"200\"/\u003e     \n   \u003cimg src=\"https://user-images.githubusercontent.com/41123719/118996008-40e34f00-b990-11eb-86ac-e82c3c99b61d.gif\" atl=\"Noor Dark Mode\" width=\"200\"/\u003e     \n\u003c/p\u003e\n\n## How to run\n\n_Note: the assets were replaced by placeholders, so the version you will run locally is different in look than the version in stores._\n\n### 1. Firebase Setup\n\nIt's important to put your own Firebase service file in order to run the app, as it uses Remote Config and Firebase Messaging.\n\n1. Create a [new Firebase project](https://console.firebase.google.com/).\n2. Add a new Android or iOS app, depending on which device you want to use, and follow the configuration steps to connect Noor to your Firebase project. This could help: https://firebase.google.com/docs/flutter/setup\n3. Go to Remote Config page.\n4. Add a new parameter with name `noorThker`, with any value of your choice.\n5. Go to Cloud Messaging page, and enable it for your project.\n6. To setup the cloud function that trigger a notification each time the Remote Config variable changes on the console, find the code in [this repo](https://github.com/Maryom/Noor_RemoteConfig).\n\n\u003e **NOTE:** You can't really run the app without it, so make sure to set it up.\n\u003e\n\u003e The app needs some files generated the `flutterfire_cli`, specifically `lib/firebase_options.dart`, `android/app/google-services.json`, and `ios/Runner/GoogleService-Info.plist`.\n\u003e\n\u003e So make sure to follow the link in **step 2** if you haven't already.\n\n### 2. (optional) FVM Setup\n\nFVM is used to make sure everyone working on the project uses the same version. It is also easier to maintain since the `.fvmrc` file has the config you need to get started quickly.\n\nIt also makes it easy for **Noor** to stay on an older version without needing to do lots of upgrades and downgrades, since developers usually work on projects with different versions.\n\n\u003e FVM website: [https://fvm.app/](https://fvm.app/)\n\nOnce FVM is installed, run the following command to get things ready:\n\n```\nfvm use 3.22.1\n```\n\n\u003e Be sure to check `.fvmrc` for the correct version this project uses, in case the version above is old.\n\n### 3. Run\n\n1. Clone the project:\n\n```bash\ngit clone https://github.com/pr-Mais/noor.git\n```\n\n2. Get packages:\n\n```bash\nflutter pub get\n```\n\n3. (for android only) Edit the `android/app/build.gradle`:\n\nThis will allow you to sign the app with the debug keystore, no need to make a keystore just for development :D\n\n```diff\n- // signingConfig signingConfigs.debug\n- signingConfig signingConfigs.release\n+ signingConfig signingConfigs.debug\n+ // signingConfig signingConfigs.release\n```\n\n1. Run:\n\n```bash\nflutter run\n```\n\n## Want to contribute?\n\nIf you encounter any bug while using the apps in store, or running it locally, please file an issue.\n\u003cbr /\u003e Contribution for enhancments are also welcome! just create a PR, and describe precisly what is your contribution.\n\nFor features request, contact us on [noorathkarapplication@gmail.com](mailto:noorathkarapplication@gmail.com?subject=%D8%A7%D9%82%D8%AA%D8%B1%D8%A7%D8%AD\u0026body=%D8%A7%D9%84%D8%B3%D9%84%D8%A7%D9%85%20%D8%B9%D9%84%D9%8A%D9%83%D9%85%D8%8C)\n\n## Credits\n\nShout out to the amazing designer [Shaikha Alqahtani](https://twitter.com/Ishaiookh).\n\u003cbr/\u003e The iOS version from Noor was made with native Swift by [Maryam Aljamea](https://twitter.com/0_1Mary).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpr-mais%2Fnoor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpr-mais%2Fnoor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpr-mais%2Fnoor/lists"}