SadaqahShare-Repo

Open in Bolt

🕌 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
Share this project:

Updates

Submission history