FundWaveSL is Sierra Leone’s first dedicated crowdfunding platform, built to help individuals, communities, and organizations raise funds easily and securely. With local mobile money integration, zero platform fees, and bank-level security, FundWaveSL makes it simple to launch campaigns, receive donations, and withdraw funds. Trusted by thousands of users and supporting both local and international payments, the platform is tailored to Sierra Leone’s unique needs—empowering people to turn ideas and causes into real impact.

👩‍💻Currently in active development. We welcome contributions and feedback from the community!

• Easy Campaign Creation – Launch fundraising campaigns quickly with images, descriptions, and funding goals.
• Local & International Payments – Accept donations via mobile money, bank transfers, and international channels.
• Secure & Transparent – Bank-level security, KYC verification, and real-time tracking of donations.
• Multi-Channel Notifications – Stay updated via SMS, email, or WhatsApp(comming soon...).
• Inclusive & Localized – Designed for Sierra Leone, supporting local languages and payment infrastructure.
• Campaign Management – Edit campaigns, track progress, and withdraw funds safely.

• Next.js – React framework for server-side rendering and static site generation.
• React – UI library for building interactive interfaces.
• TailwindCSS: Utility-first CSS framework with custom design system
• Shadcn/ui: Modern UI component.
• Typescripts - Ui component library.

• PostgreSQL: Robust relational database for data persistence
• Node.js: Server-side JavaScript runtime environment
• Drizzle – ORM for database modeling and queries.

• Monime – Payment processing.
• Vercel – Hosting, CDN, and deployment.

• Prettier: Code formatting for consistent style
• ESLint: Code linting for quality assurance
• GitHub Actions: Continuous integration and deployment

fundwave/
    ├── .gitignore
    ├── LICENSE
    ├── README.md
    ├── app
    |  ├── about
    |  |  ├── page.tsx
    |  ├── api
    |  |  ├── campaigns
    |  |  |  ├── [id]
    |  |  |  |  ├── cash-out
    |  |  |  |  |  ├── route.ts
    |  |  |  |  ├── comments
    |  |  |  |  |  ├── [commentId]
    |  |  |  |  |  |  ├── route.ts
    |  |  |  |  |  ├── route.ts
    |  |  |  |  ├── payments
    |  |  |  |  |  ├── route.ts
    |  |  |  |  ├── report
    |  |  |  |  |  ├── route.ts
    |  |  |  |  ├── route.ts
    |  |  |  ├── user-created
    |  |  |  |  ├── route.ts
    |  |  |  ├── user-deleted
    |  |  ├── page.tsx
    |  ├── dashboard
    |  |  ├── page.tsx
    |  ├── error.tsx
    |  ├── favicon.ico
    |  ├── globals.css
    |  ├── help
    ├── assets
    |  ├── assets.ts
    |  ├── logo.png
    |  ├── nema.jpg
    |  ├── swaray.jpg
    |  ├── tjalloh.jpg
    |  ├── walon.jpg
    ├── components
    |  ├── ClientLayoutWrapper.tsx
    |  ├── campaign-card.tsx
    |  ├── cashout-modal.tsx
    |  ├── ui
    |  |  ├── accordion.tsx
    |  |  ├── alert-dialog.tsx
    |  |  ├── alert.tsx
    |  |  ├── aspect-ratio.tsx
    |  |  ├── avatar.tsx
    |  |  ├── badge.tsx
    |  |  ├── breadcrumb.tsx
    |  |  ├── button.tsx
    |  |  ├── calendar.tsx
    |  |  ├── card.tsx
    |  |  ├── carousel.tsx
    |  |  ├── checkbox.tsx
    |  |  ├── collapsible.tsx
    |  |  ├── command.tsx
    |  |  ├── context-menu.tsx
    |  |  ├── dialog.tsx
    |  |  ├── drawer.tsx
    |  |  ├── dropdown-menu.tsx
    |  |  ├── form.tsx
    |  |  ├── hover-card.tsx
    ├── components.json
    ├── db
    |  ├── drizzle
    |  |  ├── 0000_heavy_mother_askani.sql
    |  |  |  ├── 0005_snapshot.json
    |  ├── drizzle.ts
    |  ├── schema.ts
    ├── drizzle.config.ts
    ├── eslint.config.mjs
    ├── lib
    |  ├── ai.ts
    |  ├── api
    |  |  ├── api.ts
    |  ├── logger.ts
    |  ├── monime.ts
    |  ├── nodeMailer.ts
    |  ├── notification.ts
    |  ├── supabase.ts
    |  ├── utils.ts
    ├── middleware.ts
    ├── next-env.d.ts
    ├── next.config.ts
    ├── package.json
    ├── pnpm-lock.yaml
    ├── postcss.config.mjs
    ├── public
    |  ├── robots.txt
    ├── styles
    |  ├── globals.css
    ├── tailwind.config.ts
    ├── tsconfig.json
    ├── types
    |  ├── api.ts
    |  ├── monimeTypes.ts
    ├── validations
    |  ├── campaign.ts
    |  ├── comment.ts
    |  ├── payment.ts
    |  ├── update.ts
    |  ├── user.ts
    |  ├── withdrawal.ts

Ensure you have the following installed on your development machine:

• Node.js (v20.12.0 or higher) - Download
• npm (comes with Node.js) or yarn as package manager
• Git for version control
• Vercel CLI (optional, for deployment) - Install Guide

1. Clone the Repository

   git clone https://github.com/Walon-Foundation/fundwave.git
   cd fundwave

2. Install Dependencies

   npm install

3. Environment Configuration

   cp .env.example .env

   Then configure your .env file with the following variables:

   # Supabase Configuration
   SUPABASE_URL=your_supabase_project_url
   SUPABASE_ANON_KEY=your_supabase_anon_key
   
   # clerk Configuration
   CLERK_SECRET_KEY=*******
   NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=*****
   WEBHOOK_SECRET=**********
   
   # Database Configuration
   DATABASE_BASE_URL=***************
   
   # Monime Configuration
   MONIME_SPACE_ID=************
   MONIME_ACCESS_TOKEN=**********
   MONIME_MAIN_ACCOUNT_ID_PROD=******************
   
   # SMTP Configuration
   GOOGLE_SMTP_EMAIL=***********
   GOOGLE_SMTP_PASSWORD=*****************
   
   NODE_ENV=********************

4. Start Development Server

   npm run dev

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

# Development server with hot reload
npm run dev

# Production build
npm run build

# Preview production build
npm run start

# Lint
npm run lint

What did you learn while building this project? What challenges did you face and how did you overcome them?

We welcome contributions from developers, designers, and DPG enthusiasts! Here's how you can get involved:

1. Fork the repository on GitHub
2. Clone your fork locally
3. Create a feature branch from main
4. Make your changes following our coding conventions
5. Test your changes thoroughly
6. Submit a pull request with a clear description

• Follow the existing code style and conventions
• Write meaningful commit messages
• Include tests for new features
• Update documentation when necessary
• Keep PRs focused and manageable in size

For detailed contribution guidelines, see CONTRIBUTING.md.

We are committed to providing a welcoming and inclusive environment for all contributors. Please read and follow our Code of Conduct.

• Issues: Report bugs and request features on GitHub Issues
• Discussions: Join community discussions on GitHub Discussions
• Documentation: Comprehensive guides in the /docs directory

• Watch the repository for updates
• Star the project if you find it useful
• Follow @Walon-Foundation for announcements

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

• Walon-Foundation for project sponsorship and support
• Open Source Community for the amazing tools and libraries that make this project possible
• Contributors who help improve and maintain this platform