Random Ayah Generator

Introduction

The Random Ayah Generator is a web-based application that dynamically displays a random Ayah (verse) from the Quran. This application includes text translations, audio recitations, and navigation features that enhance the user's interaction with the content. AI was used in the development to improve functionality, optimize user experience, and automate certain features.

Features

• Random Ayah Display: Generates a random Ayah along with its Surah name, Chapter number, Ayah(verse) number, and translation.
• Audio Recitation: Plays the audio recitation of the displayed Ayah.
• Smooth Navigation: Provides a smooth scroll feature to view the Ayah seamlessly.
• Interactive Buttons:
  • Copy to Clipboard: Allows users to copy the Ayah text.
  • Audio Control: Users can play or stop the Ayah recitation.
  • External Link: Directs to a comprehensive Quran resource.
• Responsive Design: Adapts to different screen sizes for optimal viewing.

Technologies Used

• HTML5
• CSS3
• JavaScript
• External APIs:
  • AlQuran.cloud API for fetching Ayahs and audio files.
• SweetAlert2 for user-friendly alert messages.
• AI Integration: AI was employed to enhance the development process by automating content generation, improving randomization algorithms, and ensuring a more seamless user experience.

Setup

To run this application locally, follow these steps:

Clone the Repository

git clone https://github.com/MONNK-CODE/Instant-Ayah.git

Dependencies
Ensure you have internet access to fetch Ayahs from the AlQuran.cloud API and load necessary scripts and stylesheets (FontAwesome, SweetAlert2, Google Fonts).

Usage

• Generate a New Ayah: Click on the "New Ayah" button to load a random Ayah along with its audio.
• Play Audio: Click the speaker icon to hear the recitation of the displayed Ayah.
• Stop Audio: Click the mute icon to stop the audio playback.
• Copy Ayah: Click the copy icon to copy the Ayah text to your clipboard.
• Navigate: Click the downward arrow on the intro page to scroll to the Ayah display section.

Contributing

Contributions to this project are welcome. Please fork the repository and submit a pull request.