https://github.com/farithadnan/solatku
Prayer times for Malaysia sourced from JAKIM, fetched using the api-waktusolat API.
https://github.com/farithadnan/solatku
angular islam malaysia malaysia-prayer-time prayer-times-app taiga waktu-solat-app waktu-solat-jakim waktu-solat-malaysia
Last synced: about 1 year ago
JSON representation
Prayer times for Malaysia sourced from JAKIM, fetched using the api-waktusolat API.
- Host: GitHub
- URL: https://github.com/farithadnan/solatku
- Owner: farithadnan
- License: mit
- Created: 2024-03-27T06:54:11.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-10-30T04:35:14.000Z (over 1 year ago)
- Last Synced: 2024-10-30T07:22:26.758Z (over 1 year ago)
- Topics: angular, islam, malaysia, malaysia-prayer-time, prayer-times-app, taiga, waktu-solat-app, waktu-solat-jakim, waktu-solat-malaysia
- Language: TypeScript
- Homepage: https://solatku.vercel.app
- Size: 688 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Solatku
Solatku is a web application designed to help Malaysian users know the prayer times of the day. Users can choose their location, and the app will fetch the accurate prayer times based on JAKIM's data using api-waktusolat API.
## 🔥 Motivation
The motivation behind creating **Solatku** was to improve my Angular skills, learn how to use [Taiga UI](https://taiga-ui.dev/getting-started), understand how to dockerize an Angular app, and learn how to enhance performance by using **Nginx** and **Gzip** for handling static files.
## ✨ Features
- Accurate prayer times based on **JAKIM**'s data
- Location-based prayer time fetching
- User-friendly & responsive interface using Taiga UI.
## 📋 Prerequisites
- Node.js and npm
- Angular CLI
- Docker (for running the app using Docker)
- Git
## 🚀 Run using development server
Git clone the repository:
```sh
git clone https://github.com/farithadnan/solatku.git
```
Open the project directory using your IDE, and then run the command below to install dependencies:
```sh
npm install
```
Next, start the development server by running these command:
```sh
npm start
```
## 🐳 Run using Docker
To run the app using **multi-stage Docker**, simply run either the `update.bat` or `update.sh` script, you can find these script in the root directory of the project's folder.
On Windows:
```sh
update.bat
```
On Linux/Mac:
```sh
./update.sh
```
**Ensure Docker is installed and running** on your machine before executing these scripts.
## 📜 License
This project is licensed under the **MIT License** - see the [LICENSE](/LICENSE) file for details.
## 🙏Acknowledgements
Article, API and resources that help me throughout the development:
- [api-waktusolat](https://github.com/mptwaktusolat/api-waktusolat) - is used for fetching prayer times data.
- [Taiga Ui](https://taiga-ui.dev/getting-started) - is used as the UI framework for the app.
- [Nginx Cache for Dockerized Angular App](https://zakimohammed.medium.com/nginx-cache-config-for-dockerized-angular-app-ngdocker-58e58f965c7).
- [Improve performance with Gzip](https://codeomelet.com/posts/gzip-dockerized-angular-app-with-nginx-ngdocker).
- [How to dockerize Angular's app](https://wkrzywiec.medium.com/build-and-run-angular-application-in-a-docker-container-b65dbbc50be8).
- [Multi-stage Docker](https://docs.docker.com/build/building/multi-stage/).
- [Adding PWA to Angular app](https://dev.to/rodrigokamada/adding-the-progressive-web-application-pwa-to-an-angular-application-4g1e).
- [How to deploy an Angular app with Vercel](https://medium.com/@lara.delrio333/deploy-an-angular-project-in-vercel-with-secret-environment-variables-74323925712d).