SadaqahShare-Repo
🕌 SadaqahShare
Turning charitable giving into community impact.
SadaqahShare is a community-driven platform that connects donors with local mosques and their real-time needs.
Instead of simply donating money and wondering where it goes, SadaqahShare allows donors to see what their local mosque actually needs, pledge items or funds, earn community tokens, and use those tokens to participate in decisions that affect the mosque.
Give. Contribute. Participate.
💡 The Problem
Charitable giving is powerful, but donors often face a lack of visibility into what their local communities actually need.
At the same time, mosques and community organizations may struggle to:
- Communicate their current needs to their community
- Organize donations
- Coordinate physical and monetary contributions
- Engage donors beyond a one-time donation
- Give their community a meaningful voice in local decisions
SadaqahShare brings both sides together in one platform.
✨ What SadaqahShare Does
🤲 For Donors
Donors can:
- Browse participating mosques
- Search for mosques by name or city
- View specific community needs
- Pledge items or monetary donations
- Choose between shipping and drop-off for physical donations
- Track their donations and fulfillment status
- Earn SadaqahShare Tokens from their contributions
- Use tokens to vote in mosque community polls
- View their impact across different mosques
Donor dashboards provide an overview of pledged items, earned tokens, total pledges, active polls, and donation history.
🕌 For Mosques
Mosques can use SadaqahShare to:
- Create and publish community needs
- Track incoming pledges
- Manage donation fulfillment
- Create community polls
- Give donors a voice in mosque decisions
- Monitor community participation
The application includes dedicated mosque authentication and dashboard experiences alongside the donor workflow.
🗳️ Community Governance
One of SadaqahShare's core ideas is that donating isn't the end of participation.
Donors earn tokens through their contributions. Those tokens can then be spent on active community polls.
This creates a feedback loop:
Donate → Earn Tokens → Participate → Influence Community Decisions
Tokens are tracked per mosque, meaning participation is tied to the communities donors actually support.
🚀 Key Features
| Feature | Description |
|---|---|
| 🕌 Mosque Discovery | Search and browse participating mosques |
| 📋 Community Needs | See what each mosque currently needs |
| 🤲 Donation Pledges | Pledge money or physical items |
| 🚚 Flexible Delivery | Ship donations or drop them off |
| 🪙 Community Tokens | Earn tokens through contributions |
| 🗳️ Community Polls | Spend tokens to vote on mosque decisions |
| 📊 Donor Dashboard | Track contributions, tokens, and impact |
| 🏛️ Mosque Dashboard | Manage needs, pledges, and community activity |
| 🔐 Role-Based Experience | Separate donor and mosque workflows |
| 📱 Responsive UI | Designed for desktop and mobile screens |
| 🌙 Dark Mode | Full light/dark interface support |
🛠️ Tech Stack
Frontend
- React 18
- TypeScript
- Vite
- Tailwind CSS
- Lucide React
Backend & Database
Supabase
- PostgreSQL database
- Authentication
- Real-time application data
Development
- ESLint
- PostCSS
- TypeScript
- Vite development server
The project's package configuration currently uses React 18, TypeScript 5.5, Vite 5, Tailwind CSS 3, and @supabase/supabase-js.
🔄 How It Works
1. Find a Mosque
A donor can browse available mosques and search by name or city.
2. Discover Community Needs
Each mosque can publish specific needs so donors can see where their contributions can have the greatest impact.
3. Make a Contribution
A donor can pledge:
- 💵 Money
- 📦 Physical items
Physical donations can be designated for shipping or drop-off.
4. Earn Community Tokens
Contributions generate SadaqahShare Tokens associated with the mosque receiving the contribution.
5. Participate in Decisions
Mosques can create polls for their communities.
Donors can spend their mosque-specific tokens to vote on active polls.
6. Track Your Impact
The donor dashboard keeps track of:
- Items pledged
- Tokens earned
- Total pledges
- Donation status
- Active community polls
🎯 Why We Built It
SadaqahShare was created around a simple idea:
Charity should connect people to their communities, not just transactions.
Traditional donation platforms often focus on moving money from one person to another.
SadaqahShare aims to create something more community-oriented — a platform where giving creates participation and create community engagement.
The goal is to make charitable contributions more transparent, organized, and engaging while helping mosques communicate their needs directly to the people who support them.
📄 License
This project was created as a hackathon project.
Add your preferred open-source license here if you decide to release SadaqahShare under one.
This was created using Bolt AI
❤️ SadaqahShare
Give with purpose. Participate with purpose. Build stronger communities.
Made with ❤️ for the community.
Built With
- eslint
- lucide-react
- postcss
- react18
- supabase
- tailwind-css
- typescript
- vite
Log in or sign up for Devpost to join the conversation.