Skip to content

GoodM4ven/NATIVE_TALL_muttasiq-dot-com

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

280 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

بسم الله الرحمن الرحيم

مُتَّسِق

تطبيق يهدف للاتساق مع الإسلام لله ربّ العالمين، خطوة بخطوة، وبيُسر وسهولة بإذن الله. تطبيق بترميز واحد لكل المنصات، مصنوع بتقنيات حديثة، ومصمم بواجهة جذابة؛ ولا حول ولا قوة إلا بالله...

screenshot of muttasiq app home and main menu buttons

المتصفح

لتجربة التطبيق الآن من أي متصفح:
https://muttasiq.com


The athkar app gate - light mode

The athkar app reader - light mode

الأندرويد

يتم الاختبار الآن من قبل متطوعين...


A notification message showing in athkar app gate - light mode    Athkar app reader - dark mode

الآي أو اس

يتم الاختبار الآن من قبل متطوعين...


(الصور قريبًا إن شاء الله)

المهام

لاقتراح أي فكرة أو مناقشة أي خاصيّة حالية للتطبيق، يُرجى طرحها -لا في قسم المشكلات التقنية- بل في قسم النقاشات، جزاكم الله خيرا، والسلام.

وهناك قسم متكامل لاستعراض المهمات التقنية قيد العمل، للمختصين، والذي يمكن من خلاله قياس حوية المشروع بشكل عام.

المحرك

  • ترميز واحد لتصدير تطبيق لجميع المنصات
  • حافظة محليّة لإنجازات وإعدادات المستخدم
  • اختبارات برمجية لتطبيق الويب (المتصفح)
  • اختبارات برمجية لتطبيقات المنصات (المحليّة)
  • قسم لاستعراض المهام والمتغيّرات بين النسخ
  • قسم لاستعراض وشرح الخواص الحالية في التطبيق
  • محرك للغة العربية، بحثًا وتحليلًا
  • إخفاء الحركات
  • القراءة بالعربية صوتيًّا
  • دعم اللغات الأجنبية بشكل مفتوح المصدر

الانطلاق

  • أذكار الصباح والمساء
  • إمكانية تعديل الأذكار وترتيبها

التحديث الأوّل

  • تذكير بأذكار الصباح والمساء
  • أذكار يوم الجمعة

التحديث الثاني

  • الصلوات وتذكيراتها
  • قضاء الصلوات أيّام ضلال المرء
  • سُنّة الاستهام

التحديث الثالث

  • صِلة
  • صحيح الأدعية، مُقسَّمَة بأنواع الاحتياجات

التحديث الرابع

  • القرآن الكريم
  • الوِرد اليومي من القرآن الكريم

التحديث الخامس

  • سنن اليوم والليلة
  • اصطياد كل السنن بآثارها، ولو مرّة في العمر

التحديث السادس

  • علم الحديث: إسناد ورواة ومتون
  • إمكانية جرد الآثار باتساق

الدعم

كما تعلم، بارك الله فيك، فجعل التطبيق متاحًا على المخدّمات، ومتوفّرًا في كافّة المنصات (بأنواع أجهزتها المختلفة) وبيُسر وسهولة، يحتاج إلى طاقة ومال وفيرين! وتطوير كل هذه الإمكانيات يأخذ تخطيطا بوقت كثير وبذل جهد كبير، وعلى حساب أيّ عمل أو صنعة أخرى... فلا تنسانا من الدعاء.

وكذلك تستطيع دعم تطوير وصيانة المشروع هذا عن طريق الاشتراك (بمبلغ شهري)، أو عن طريق التبرّع لمرّة واحدة، وذلك في المنصات التالية:

جيتهاب | Github
Github Sponsor
باتريون | Patreon
Patreon
باي مي كوفي | BuyMeCoffee
Buy Me a Coffee

وإن كنت مطوّرًا أو مصمّمًا، وتودّ دعم هذا المشروع، فقم بِتَفَقُّد القسم المخصص في الأسفل.

والله المستعان.

الداعمون


Development

GitHub Tests Action Status Coverage Status

The web app is built using one of the most standard and well-documented web technology stacks, known as the TALL stack. Get a grip over the general concepts in the docs as soon as possible - after considering the tip below:

The native apps, are built using NativePHP. And with their new mobile builder, all platforms are covered. It relies on a wide ecosystem of technologies — without requiring YOU to directly interact with them.

  • Check out their desktop AND mobile documentation please.
  • If you have experience with Kotlin or Swift, ElectronJS is communicating with them under the hood in NativePHP. You can implement those changes as PHP plugins of course, and even make them paid to support yourself!

Tip

You can also start learning about ALL of these technologies by using Laravel Boost, which does almost everything for you if you give the AI agent well-engineered commands — including writing feature tests. I set it up in this project for Anthropic Claude and Codex CLI, but it can work with pretty much anything else.

Coding

Rules

  1. Focus on the main missions detailed in discussions and assigned in the project view. So unless it's a bug fix, do not work on any new feature without having an issue and being assigned to.
  2. Use and maintain the bash scripts found in [./.scripts] directory, providing utilities to run and watch all available platform applications, etc.
  3. Since any change to the main branch is going to directly update the web app, PRs are NOT going to be directed to main branch, please, but rather to dev branch instead.
  4. Use the composer green command before you do the PR in the first place. It will do the standard code formatting, linting, and testing altogether. Please trace what it does in composer.json.
    • The process runs PestPHP browser tests in --compact mode only (not --parallel) due to current bugs in the Playwright and PestPHP integration, including direct mobile emulation support—this may make tests slower locally, though they work reliably (this limitation does not apply to CI, I think, since it’s ephemeral).
  5. We have muttasiq-patches NativePHP plugin that overrides the original NativePHP engine a bit. Make sure you account for what it does in mind, where (the PR you're going to do there) its modifications do not conflict with one another when patching the same file and correctly patch the files they're targetting from the NativePHP version specified in composer.json over here.
    • Keep in mind that there is a Bash switching script for when you have the package locally and test its changes locally before the PR. Check it out.

Setup

  1. We recommend Ubuntu (LTS) for stable and upgradable development environment.
  2. Setting up your development environment could be easier using this lara-stacker CLI Bash scripts, which utilizes Docker to setup the main services, and leaving you to only care about few tools that are essential for PHP development.
    • We recommend using git clone into lara-stacker's apps-root directory and then using lara-stacker's "rewire" command on this project.
    • Running composer setup command at the beginning, as for any Laravel of course.
  3. We strongly advocate for using VSCodium, especially for those who are new to the development world.
  4. Check out all of our VSC configurations set in this TALL-STANDARDS wikipedia, which also contains a decent bit of tips for dealing with the tall-stack and some other related tools and technologies. (The project isn't complete)
  5. And whatever we advised to do for quick learning about this stack, please make sure you read the development section up top.

Tools and Guides

Design

If you're a designer, or perhaps you don't know much about coding, feel free to post in discussions any contributions to how you think visuals can be improved; supported by photos and videos, of course.

  • The icon is set to be a 1024x1024 pixels PNG:

    The application icon
  • As for the splash screen, it has to be a portrait 1080x1920 pixels PNG:

    The application splash screen

Note

There is light and dark themed splash screen feature, but I'm not currently utilizing it because of the current poor brand anyway...

  • As for the meta OpenGraph image, it should be a 1200x630 pixels JPG:

    The open-graph meta picture

The assets used for the app so far can be found in this online Penpot draft (request needed), which you preview quickly from here or edit it freely using this [design.penpot] file.

Resources

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

You may redistribute and/or modify this program under the terms of the AGPL v3. See the full license text in LICENSE.

Copyright (C) 2026 Muttasiq Contributors.

Credits

Contributors

Assets

احذر
ذوات
الأرواح

Technologies


والحمد لله ربّ العالمين

About

تطبيق يعين على الإسلام والالتزام باتساق ويسر بإذن الله

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Sponsor this project

  •  

Contributors