Skip to content

HoshangDEV/NextJS-Quran-App

Repository files navigation

Quran Application

Welcome to the Quran Application, a beautifully crafted web application built using Next.js and TypeScript. This application allows users to explore and read the Surahs of the Quran in a simple and intuitive interface, now with audio for each Ayah.

Quran Application Screenshot

Features

  • Browse Surahs: Users can view a list of all Surahs and select any to read in detail.
  • Read Surahs: Each Surah can be read in a beautifully formatted text that enhances the reading experience.
  • Listen to Ayahs: Experience the Quran audibly by listening to the recitation of each Ayah.

Technology Stack

  • Next.js: A powerful React framework that enables functionality such as server-side rendering and generating static websites.
  • TypeScript: A superset of JavaScript that adds static types to the language, enhancing code quality and readability.
  • Shadcn UI: A modern UI library used to design the beautiful and responsive user interface of this application. Learn more about Shadcn UI at Shadcn UI.

API Usage

This application uses the Al-Quran Cloud API exclusively for all data, including Quran text, audio recitations, and tafseer (interpretations) in Kurdish, Arabic, and English.

For a full list of available editions (translations, tafseer, etc.), see: https://api.alquran.cloud/v1/edition

Getting Started

To run this application locally, you need to have Node.js installed on your machine. Follow these steps:

  1. Clone the repository:
    git clone https://github.com/HoshangDEV/NextJS-Quran-App.git
  2. Navigate to the project directory:
    cd quran-app
  3. Install dependencies:
    npm install
  4. Run the development server:
    npm run dev
    Open http://localhost:3000 with your browser to see the result.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

HoshangDEV - HoshangDEV - contact@hoshang.dev

Project Link: https://github.com/HoshangDEV/NextJS-Quran-App

Acknowledgements

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages