Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/phanatagama/suji

πŸ•Œ Suji is a Muslim application for reading the Quran and prayer reminders.
https://github.com/phanatagama/suji

dart flutter getx quran

Last synced: 1 day ago
JSON representation

πŸ•Œ Suji is a Muslim application for reading the Quran and prayer reminders.

Awesome Lists containing this project

README

        

[![codecov](https://codecov.io/gh/phanatagama/suji/branch/main/graph/badge.svg?token=F777RVVH55)](https://codecov.io/gh/phanatagama/suji)
![Suji](https://socialify.git.ci/phanatagama/suji/image?description=1&font=Rokkitt&forks=1&issues=1&language=1&name=1&pulls=1&stargazers=1&theme=Auto)







Suji is a Muslim application for reading the Quran and prayer reminders.


Download App
Β·
Report Bug
Β·
Request Features

## πŸ’‘ Background

The background of this project focusing on Quran recitation, Quran audio playback, and prayer schedule reminders reflects a very meaningful effort in bringing technology in support of Muslims' religious practices and spirituality. The project aims to provide easy and practical access for Muslims to connect with the sacred text of the Quran and perform prayers on time.

In the ever-evolving digital age, technologies such as Android apps have opened up new opportunities to enhance religious experiences. The Suji app attempts to combine traditional values with the ease of accessibility offered by technology.

It is important to mention that this project can also help users in understanding and following the prayer schedule, which is often a mandatory part of Muslims' daily lives. By using the Suji app, users can focus more on their religious practices without worrying about missing prayer times.

We wish your project success in benefiting the Muslim community and making it easier for them to worship and connect with the Quran.

## ♻️ Project Goals

This application is made to facilitate Muslim brothers who want to recite the Quran through smartphone devices and create prayer schedule reminders.

## 🀯 Challenges we faced

it's been quite a while since I last worked with flutter about 1 year ago. I'm trying to learn again good app development with the flutter framework and integration of some libraries and good documentation. Fetching data from different api sources and caching is quite challenging for me.

## 🧐 How we built our project

This project is built with Getx as state management and data derived from [Quran API](https://api.quran.gading.dev) and [Prayer Schedule API](https://aladhan.com). A caching method with IsarDB is applied to reduce the load of requests to the API. I used alarm_manager_plus and flutter_local_notification libraries for the prayer schedule reminder feature.

## πŸ› οΈ Tech Stack Used

| Dart | Flutter |
| --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| | |

## πŸ§‘β€πŸŽ“ What we learned

From this project I learnt how to cache data from api sources and do scheduled notifications on background services. I also tried to understand the use of Hive as a key-value pair based storage and IsarDB as a NoSQL database.

## 🐾 Conventional Commit

β€ŽIn this project, I endeavoured to follow the [commit convention](https://www.conventionalcommits.org/en/v1.0.0/) so that the commit messages are cleaner and more readable. I think it's awesome and makes it practically easy for me to be able to backtrack through each commit deployment.

## πŸ‘οΈ Preview/Screenshots

| ![Home](https://github.com/phanatagama/Suji/assets/48324618/571cb7ab-19a1-41a5-aa2a-7ab00cc41fba) | ![Search](https://github.com/phanatagama/Suji/assets/48324618/bd90dc69-fda8-452e-80dd-7285a9cc1d26) | ![Surah](https://github.com/phanatagama/Suji/assets/48324618/ed52e5c4-54aa-45fd-b79f-94da4f8b3ea6) | ![Prayer Time](https://github.com/phanatagama/Suji/assets/48324618/d4671cd9-1b16-4eef-acc0-73317d4616e0) |
| :-----------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------: |
| **Home Page** | **Search Page** | **Surah/Ayat** | **Prayer Time** |