A modern, user-friendly web application designed to help Muslims manage and organize their charitable giving, with special features for Ramadan donations.
- Quick overview of all donation categories
- Real-time donation tracking
- Easy navigation to all features
- 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)
- Multiple charitable causes:
- Feed the Hungry
- Education Fund
- Masjid Construction
- Medical Aid
- Progress tracking for each cause
- Transparent fundraising goals
- Easy donation process
- 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
- Node.js (v14.0.0 or higher)
- npm (v6.0.0 or higher)
- Clone the repository:
git clone https://github.com/your-username/donation-organizer-ui.git
cd donation-organizer-ui
- Install dependencies:
npm install
- Add required images:
Place the following images in the
public
folder:
- food.jpg
- education.jpg
- masjid_construction.jpg
- medical_aid.jpg
Start the development server:
npm start
The application will be available at http://localhost:3000
Create a production build:
npm run build
This will create an optimized build in the build
folder.
Run the test suite:
npm test
- React 18
- Material-UI (MUI)
- React Router v7
- TypeScript
- Modern CSS-in-JS
The application includes authentic Islamic references:
-
Zakat Calculation:
- Based on the Nisab value equivalent to 87.48 grams of gold
- 2.5% of wealth above Nisab
-
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."
-
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.
Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
This project is licensed under the MIT License - see the LICENSE.md file for details.
- 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
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...]
The following features are planned for future releases to enhance the application's functionality and user experience:
- User registration and login system
- Personal donation history tracking
- Zakat due date reminders
- Custom donation goals
- Recurring donation setup
- Automatic gold/silver price updates
- Multiple currency support
- Downloadable Zakat reports
- Zakat payment scheduling
- Historical calculations archive
- Business Zakat calculator
- 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
- 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
- South African payment gateway integration
- EFT payment support
- Mobile money integration
- Automated payment receipts
- Tax certificates generation
- Local masjid directory
- Community donation needs board
- Donation request verification system
- Success stories sharing
- Beneficiary testimonials
- Comprehensive Zakat knowledge base
- Fiqh of donations section
- Video tutorials
- Detailed FAQ section
- Scholar Q&A archive
- Donation disbursement tracking
- Beneficiary database management
- Project progress monitoring
- Financial reporting tools
- Audit trail system
- Offline functionality
- Push notifications
- Email reminder system
- Mobile app version
- Data export capabilities
- Multi-language support (Arabic, English, local languages)
- SSL encryption implementation
- POPI Act compliance measures
- Secure payment handling
- Data privacy controls
- Regular security audit system
- Personal donation analytics
- Community impact metrics
- Donation trend analysis
- Project success rate tracking
- Financial transparency reports
- 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.