Islamic Donation Organizer

A modern, user-friendly web application designed to help Muslims manage and organize their charitable giving, with special features for Ramadan donations.

Features

1. Dashboard

  • Quick overview of all donation categories
  • Real-time donation tracking
  • Easy navigation to all features

2. Zakat Calculator

  • Comprehensive wealth calculation
  • Automatic Nisab checking
  • Support for various asset types:
    • Cash and bank balances
    • Gold and silver
    • Stocks and shares
    • Property for trade
    • Other investments
  • Liabilities tracking
  • Instant Zakat calculation in South African Rand (ZAR)

3. Sadaqah (Voluntary Charity)

  • Multiple charitable causes:
    • Feed the Hungry
    • Education Fund
    • Masjid Construction
    • Medical Aid
  • Progress tracking for each cause
  • Transparent fundraising goals
  • Easy donation process

4. Ramadan Special Features

  • Zakat al-Fitr calculator
  • Iftar sponsorship options:
    • Single person (R100)
    • Family (R500)
    • Masjid iftar (R2,500)
  • Ramadan-specific donation tracking
  • Special rewards reminder based on authentic hadith

Getting Started

Prerequisites

  • Node.js (v14.0.0 or higher)
  • npm (v6.0.0 or higher)

Installation

  1. Clone the repository:
git clone https://github.com/your-username/donation-organizer-ui.git
cd donation-organizer-ui
  1. Install dependencies:
npm install
  1. Add required images: Place the following images in the public folder:
  • food.jpg
  • education.jpg
  • masjid_construction.jpg
  • medical_aid.jpg

Development

Start the development server:

npm start

The application will be available at http://localhost:3000

Production Build

Create a production build:

npm run build

This will create an optimized build in the build folder.

Testing

Run the test suite:

npm test

Technology Stack

  • React 18
  • Material-UI (MUI)
  • React Router v7
  • TypeScript
  • Modern CSS-in-JS

Islamic References

The application includes authentic Islamic references:

  1. Zakat Calculation:

    • Based on the Nisab value equivalent to 87.48 grams of gold
    • 2.5% of wealth above Nisab
  2. Sadaqah:

    • Based on the verse from Surah Al-Baqarah (2:261):

    "The example of those who spend their wealth in the cause of Allah is that of a grain that sprouts into seven ears, each bearing one hundred grains. And Allah multiplies ˹the reward even more˺ to whoever He wills. For Allah is All-Bountiful, All-Knowing."

  3. Ramadan:

    • Based on the hadith from Al-Bukhari and Muslim:

    Ibn `Abbas (May Allah be pleased with them) reported: The Messenger of Allah (sallallaahu alayhi wa sallam) was the most generous of the men; and he was the most generous during the month of Ramadan when Jibril visited him every night and recited the Qur'an to him. During this period, the generosity of Messenger of Allah (sallallaahu alayhi wa sallam) waxed faster than the rain bearing wind.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

License

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

Acknowledgments

  • All monetary values are in South African Rand (ZAR)
  • Zakat calculations should be verified with local scholars
  • Donation amounts and categories can be customized based on local needs

Islamic Donation Organizer

A modern, user-friendly web application designed to help Muslims manage and organize their charitable giving, with special features for Ramadan donations.

[Previous content remains unchanged...]

Roadmap: Suggested Improvements

The following features are planned for future releases to enhance the application's functionality and user experience:

Authentication & User Profiles

  • User registration and login system
  • Personal donation history tracking
  • Zakat due date reminders
  • Custom donation goals
  • Recurring donation setup

Enhanced Zakat Features

  • Automatic gold/silver price updates
  • Multiple currency support
  • Downloadable Zakat reports
  • Zakat payment scheduling
  • Historical calculations archive
  • Business Zakat calculator

Ramadan-Specific Enhancements

  • Hijri calendar integration
  • Automatic Zakat al-Fitr due date calculation
  • Ramadan donation planner
  • Daily sadaqah tracker
  • Last 10 nights special donation reminders
  • Iftar donation location mapping

Sadaqah Improvements

  • QR code generation for quick donations
  • Social media sharing integration
  • Monthly donation subscriptions
  • Project updates and impact reports
  • Donor recognition wall (with optional anonymity)
  • Emergency relief campaigns

Payment Integration

  • South African payment gateway integration
  • EFT payment support
  • Mobile money integration
  • Automated payment receipts
  • Tax certificates generation

Community Features

  • Local masjid directory
  • Community donation needs board
  • Donation request verification system
  • Success stories sharing
  • Beneficiary testimonials

Educational Content

  • Comprehensive Zakat knowledge base
  • Fiqh of donations section
  • Video tutorials
  • Detailed FAQ section
  • Scholar Q&A archive

Administrative Features

  • Donation disbursement tracking
  • Beneficiary database management
  • Project progress monitoring
  • Financial reporting tools
  • Audit trail system

Technical Improvements

  • Offline functionality
  • Push notifications
  • Email reminder system
  • Mobile app version
  • Data export capabilities
  • Multi-language support (Arabic, English, local languages)

Security & Compliance

  • SSL encryption implementation
  • POPI Act compliance measures
  • Secure payment handling
  • Data privacy controls
  • Regular security audit system

Analytics & Reporting

  • Personal donation analytics
  • Community impact metrics
  • Donation trend analysis
  • Project success rate tracking
  • Financial transparency reports

Integration Features

  • Calendar integration (Google, Outlook)
  • Contact import for group donations
  • WhatsApp sharing functionality
  • SMS notification system
  • Bank account linking

These improvements aim to enhance user experience, increase functionality, and provide better service to the Muslim community. Implementation priority will be based on user feedback and community needs.