Information About Islam (Da'wah Website)
Explore the docs »

Report a Bug · Request a Feature . Ask a Question

Table of Contents

• About
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Roadmap
• Support
• Contributing
• Authors & contributors
• Acknowledgements

---

About

Information About Islam is a comprehensive website designed to provide accurate and accessible information about Islam to both Muslims and non-Muslims alike. The project aims to:

• Offer authentic Islamic knowledge based on the Quran and Sunnah
• Provide resources for new Muslims and those interested in learning about Islam
• Make Islamic educational materials accessible in multiple formats (text, audio, video)
• Present Islamic teachings in a clear, user-friendly interface

This website serves as a digital da'wah (invitation to Islam) platform, addressing common questions about Islamic beliefs, practices, and principles. It includes resources such as audiobooks, prayer guides, Quran recitations, and educational content about core Islamic concepts.

Built With

This project is built using the following technologies:

• HTML5, CSS3, and JavaScript for frontend development
• Bootstrap (v5.3.3) for responsive design and UI components
• Bulma (v1.0.2) CSS framework for additional styling
• SASS/SCSS for CSS preprocessing
• Custom JavaScript for audio players, modals, and interactive elements
• Google Analytics and Microsoft Clarity for website analytics

Getting Started

Prerequisites

To work with this project, you'll need:

• Git for version control
• Node.js and npm (Node Package Manager) for dependency management
• A modern web browser for testing
• Basic knowledge of HTML, CSS, and JavaScript

Installation

Follow these steps to set up a local development environment:

1. Clone the repository

   git clone https://github.com/mtwsnc/dawah.git
   cd dawah

2. Install dependencies

   npm install

3. Build CSS files (if needed)

   npm run build-bulma

4. Open the project in your browser

   • You can use a local development server or simply open the index.html file in your browser

Usage

This website is designed to be intuitive and user-friendly. Here's how to navigate and use the main features:

Exploring Islamic Content

• Homepage: The main page provides an overview of core Islamic concepts with interactive "Explore" buttons that open detailed modal windows.
• Navigation Menu: Use the navbar to access different sections of the website:
  • Audiobooks in English and Spanish
  • Instructional videos for Wudu (ablution) and Prayer
  • Audio resources including a guide for new Muslims and Quran recitations

Interactive Features

• Audio Player: Listen to the "A Glimpse into the Religion of Islam" audiobook directly on the site with playback controls.
• PDF Reader: Access the full text of books using the integrated PDF reader.
• Modal Windows: Click on "Explore" buttons to open detailed information about various Islamic topics.

For Developers

If you're working on the codebase:

• Modify HTML files to update content
• Edit CSS files in the assets/css directory or SCSS files in assets/scss for styling changes
• JavaScript files in assets/js control interactive elements like the audio player and modals

Roadmap

See the open issues for a list of proposed features (and known issues).

• Top Feature Requests (Add your votes using the 👍 reaction)
• Top Bugs (Add your votes using the 👍 reaction)
• Newest Bugs

Support

If you need assistance with the website or have questions about the project, you can reach out through the following channels:

• GitHub issues for technical issues or feature requests
• Contact options listed on the Markaz Tawheed Was-Sunnah GitHub profile

For questions about Islamic content, please consult with knowledgeable scholars or reliable Islamic resources.

Contributing

Please read our contribution guidelines, and thank you for being involved!

Authors & contributors

The original setup of this repository is by Markaz Tawheed was Sunnah.

For a full list of all authors and contributors, see the contributors page.

Acknowledgements

We would like to express our gratitude to:

• The authors whose works are featured on this website
• The open-source community for providing tools and frameworks that made this website possible
• All contributors who have helped improve this project
• Markaz Tawheed Was-Sunnah for initiating and maintaining this educational resource

This project is licensed under a Personal-Use & Non-Commercial License (PUNCL), which allows for personal use while restricting commercial applications without permission.