fitrahive/dua-dhikr

:kaaba: Authentic Sunnah Dua & Dhikr RESTful API.

Dua & Dhikr

A free RESTful API server that provides Duas and Dhikr following the Sunnah of the Prophet Muhammad (peace be upon him)

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

Bahasa Indonesia

Requirements

• Node.js >= 20.x
• npm

Getting Started

1. Clone this repository

   git clone https://github.com/fitrahive/dua-dhikr.git

2. Move to the repository directory

   cd dua-dhikr

3. Install dependencies

   npm ci

4. Run locally

   • Development mode

     npm run dev

   • Production mode

     1. Build first

        npm run build

     2. Start app

        npm run start

One-click Deployment

The fastest way to use it privately on PaaS available

Basic Usage

Base URL : http://localhost:3000

Endpoint	Description	Method
/languages	Retrieve a list of supported languages	GET
/categories	Retrieve a list of dua & dhikr categories	GET
/categories/:slug	Retrieve a list of dua & dhikr based on a category	GET
/categories/:slug/:id	Retrieve details of a dua & dhikr based on category and id	GET

Important

To retrieve data in supported language, use the Accept-Language header. By default, it will use id (Indonesian).

Warning

Currently, only Indonesian is ready to be served! For English and other languages, translation is in progress. Please wait, or help us to translate into other languages (except English, which is currently under development).

Showcase

List of awesome projects (اللّٰهُمَّ بَارِكْ) powered by this API

• Kaaba
  Authentic sunnah dua & dhikr app (web based) by @sooluh

Ready to use!

List of server APIs ready to use publicly

• https://dua-dhikr.vercel.app
• https://dua-dhikr.onrender.com

Contribute

Complete or add Duas and Dhikr data according to the authentic Sunnah that you know, ensure the data is authentic!

Warning

Fear Allah! Your contributions will be accounted for in the Hereafter!

1. Fork this repository
2. Open data/dua-dhikr and select an available category
3. Open the JSON file in the desired language, or add a new one with the ISO 639 code
4. Make changes carefully!
5. Commit the change using the command npm run commit.
6. Submit a pull-request
7. Wait for us to perform the merge

Columns description

• title contains the title of the Dua/Dhikr.
• arabic contains the Dua/Dhikr in Arabic script.
• latin contains the transliteration from Arabic script to Latin characters.
• translation contains the translation in the desired language.
• notes contains notes (e.g., Recite 3x).
• fawaid contains the benefits or virtues of this Dua/Dhikr.
• source contains the reference to the authentic Hadith used.

License

This project is licensed under MIT License.

جزاكما الله خيرا كثيرا

dua-dhikr's Issues

Rewriting Endpoints

Bismillah,
To tidy up the endpoint routes, there's a bunch of tasks I gotta handle here.

• List of supported languages
• List of categories (use Accept-Language header for language specifics, default: ID)
• List of dua & dhikr content based on category param/slug (Accept-Language header for language specifics, default: ID)
• Dua & dhikr content/detail based on category & id (Accept-Language header for language specifics, default: ID)

Note

Perhaps I might need to restructure the code as well, you know, do some 'refactoring'.

Insha Allah.