🌟 StellarAid

A blockchain-based web crowdfunding platform built on the Stellar Network for transparent, borderless, and secure fundraising.

StellarAid enables project creators to raise funds in XLM or any Stellar-based asset (USDC, NGNT, custom tokens), while donors can contribute with full on-chain transparency.

Folder structure

/src
  /assets               # static files (images, fonts, etc.)
  /components           # shared UI components
    /common
    /layout
  /features             # domain-oriented modules (recommended)
    /auth
      /components
      /pages
      /hooks
      /services
      index.ts
    /dashboard
      /components
      /pages
      index.ts
    /projects
      /components
      /pages
      index.ts
    /admin
      /components
      /pages
      index.ts
  /pages                # route-level pages (thin wrappers around features)
    /auth
      Login.tsx
      Register.tsx
    /dashboard
      DashboardHome.tsx
    /projects
      ProjectsList.tsx
      ProjectDetails.tsx
    /admin
      AdminHome.tsx
  /routes               # routing config
    AppRoutes.tsx
  /services
    api.ts
    stellar.ts
  /hooks
    useAuth.ts
    useFetch.ts
  /store
    index.ts
    auth.slice.ts
  /types
    api.d.ts
    user.d.ts
    project.d.ts
  /utils
    constants.ts
    helpers.ts
    validators.ts
  App.tsx
  main.tsx
  vite-env.d.ts

📌 Features

🎯 For Donors

Discover global fundraising campaigns
Donate in XLM or Stellar assets
Wallet integration (Freighter, Albedo, Lobstr)
On-chain transparency: verify all transactions

🎯 For Creators

Create social impact projects
Accept multi-asset contributions
Real-time donation tracking
Withdraw funds directly on-chain

🎯 For Admins

Campaign approval workflow
User & KYC management
Analytics dashboard

🏗️ Architecture Overview

StellarAid Frontend is built with:

Next.js 14
TailwindCSS
Stellar JavaScript SDK
Redux (state management)

📌 How to Contribute

1. Fork the Repository

Click the “Fork” button in the top‑right of the GitHub repo and clone your fork:

git clone https://github.com/YOUR_USERNAME/stellaraid.git
cd stellaraid

2. Create a Branch

git checkout -b feature/add-donation-flow

3. Commit Messages

Use conventional commits:

feat: add wallet connection modal
fix: resolve donation API error
docs: update project README
refactor: clean up project creation form

4. Submitting a Pull Request (PR)

Push your branch:

git push origin feature/add-donation-flow

Open a Pull Request from your fork back to the main branch.

📜 License

MIT License — free to use, modify, and distribute.

Cedarich/web-fox

README