Skip to content

iciso/iqra

Repository files navigation

IQRA - Islamic Quiz Rivalry App

IQRA is the first freeware open-source Islamic knowledge quiz app. Increase your knowledge of Islam by learning or playing quiz challenges. Our mission is to help Muslims and Arabic language enthusiasts develop a deeper connection with Islam and the Glorious Quran through interactive learning, quizz challenges, and gaming tools.

Features

  • Quiz challenges across 12 major subjects in Islam
  • Interactive lessons to test and reinforce learning
  • Vocabulary matching games
  • Progress tracking
  • Infographic examples from the Quran for context
  • Responsive design for desktop and mobile use
  • Word lists for organized learning
  • Root word explorer

Getting Started

Prerequisites

  • Node.js 18.0 or higher
  • npm or yarn

Installation

  1. Clone the repository ``` git clone https://github.com/iciso/iqra.git cd iqra ```

  2. Install dependencies ``` npm install

    or

    yarn install ```

  3. Run the development server ``` npm run dev

    or

    yarn dev ```

  4. Open http://localhost:3000 in your browser

Technology Stack

  • Next.js - React framework for server-rendered applications
  • TypeScript - For type safety and better developer experience
  • Tailwind CSS - For responsive and customizable styling
  • Vercel - For deployment and hosting

Contributing

We welcome contributions from developers, Arabic linguists, Quran scholars, and anyone passionate about making Quranic knowledge more accessible. See CONTRIBUTING.md for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • IQRA Codes Team - Rafique and Joy who taught Rafique during the COVID-19 years.
  • All contributors who have helped make this project better

Contact


وهي صدقة جارية لوجه الله تعالى

This is an ongoing charity for the sake of Allah ﷻ, The Entirely Generous.

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages