realtouseef / qamar

An API that shows verses from the Qur'an based on emotions.

Home Page:https://qamar.up.railway.app/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

‘Qamar’ (qa-mar) / moon 🌕

An API that shows verses from the Qur'an based on emotions.

The duas.json has duas picked from either Qur'an or Hadith. And emotionBasedVerses.json has verses picked from Qur'an only.

Available Duas / Verses

  • Qamar has 27 verses in emotionBasedVerses.json
  • And 28 duas in duas.json

Endpoint

  1. /verses returns all of the verses that are present.

  2. /verses/:id returns a verse based on the id.

  3. /duas returns all the duas that are present.

  4. /duas/:duaid returns a dua based on the id.

Returned Data

For Verses

{
  "id": 2,
  "title": "Angry",
  "sub_title": "Extinguish",
  "arabic": "ٱلَّذِينَ يُنفِقُونَ فِى ٱلسَّرَّآءِ وَٱلضَّرَّآءِ وَٱلْكَـٰظِمِينَ ٱلْغَيْظَ وَٱلْعَافِينَ عَنِ ٱلنَّاسِ ۗ وَٱللَّهُ يُحِبُّ ٱلْمُحْسِنِينَ",
  "urdu_translation": "جو آسودگی اور تنگی میں (اپنا مال خدا کی راہ میں) خرچ کرتےہیں اور غصے کو روکتے اور لوگوں کے قصور معاف کرتے ہیں اور خدا نیکو کاروں کو دوست رکھتا ہے",
  "english_translation": "Who spend [in the cause of Allah] during ease and hardship and who restrain anger and who pardon the people - and Allah loves the doers of good",
  "reference": ""
}

For Duas

{
  "id": 1,
  "title": "For Forgiveness",
  "arabic": " رَبِّ إِنِّى ظَلَمْتُ نَفْسِى فَٱغْفِرْ لِى",
  "urdu_translation": " اے پروردگار میں نے اپنے آپ پر ظلم کیا تو مجھے بخش دے",
  "english_translation": "My Lord! I have definitely wronged my soul, so forgive me.",
  "reference": ""
}

PS: Some of the translation is not present for now, but will be soon added. If you're interested in making a contribution, please do so.

For Contribution

Please clone this repo by pasting the below code in the terminal

  git clone https://github.com/realtouseef/qamar.git

  # then

  cd qamar
  yarn

  # to start the server
  yarn start

If you wanna add more duas or verses, please follow this pattern:

Pattern for Verses

{
  "id": "",
  "title": "",
  "sub_tite": "",
  "arabic": "",
  "urdu_translation": "",
  "english_translation": "",
  "reference": ""
}

Pattern for Duas

{
  "id": ,
  "title": "",
  "arabic": "",
  "urdu_translation": "",
  "english_translation": "",
  "reference": ""
}

About

An API that shows verses from the Qur'an based on emotions.

https://qamar.up.railway.app/


Languages

Language:JavaScript 100.0%