cFund - Modular Crowdfunding Platform

A modern, feature-rich crowdfunding platform built with React, TypeScript, and Supabase.

🏗️ Project Structure

This project follows a modular architecture for better maintainability and token efficiency:

src/
├── modules/
│   ├── auth/           # Authentication & user management
│   ├── funds/          # Campaign/fund management
│   ├── wallet/         # Financial transactions
│   ├── referrals/      # Referral system & earnings
│   ├── ai/             # AI-powered features
│   ├── settings/       # User preferences
│   └── core/           # Shared components & utilities
├── lib/                # Shared libraries (Supabase, Stripe, etc.)
└── components/         # Legacy shared components (being migrated)

📦 Modules

🔐 Auth Module (src/modules/auth/)

• User authentication (sign up, sign in, password reset)
• Profile management
• Password strength validation
• Session handling

💰 Funds Module (src/modules/funds/)

• Campaign creation and management
• Fund discovery and browsing
• Donation processing
• Campaign analytics

💳 Wallet Module (src/modules/wallet/)

• Digital wallet functionality
• Add funds via Stripe
• Withdraw funds
• Transaction history

🎯 Referrals Module (src/modules/referrals/)

• Referral code generation
• Earnings tracking
• Fee distribution system
• Campaign referral attribution

🤖 AI Module (src/modules/ai/)

• AI-powered campaign content generation
• Campaign optimization suggestions
• Smart categorization

⚙️ Settings Module (src/modules/settings/)

• Account preferences
• Notification settings
• Security settings
• Appearance customization

🏠 Core Module (src/modules/core/)

• Shared UI components
• Layout components
• Common pages (Home, About, etc.)
• Utility functions

🚀 Features

• Modern UI/UX: Beautiful, responsive design with Tailwind CSS
• Real-time Updates: Live campaign progress and notifications
• Secure Payments: Stripe integration for secure transactions
• AI-Powered: Smart campaign content generation
• Referral System: Earn rewards for bringing new users
• Mobile-First: Optimized for all device sizes
• Type-Safe: Full TypeScript implementation

🛠️ Tech Stack

• Frontend: React 18, TypeScript, Tailwind CSS
• Backend: Supabase (PostgreSQL, Auth, Real-time)
• Payments: Stripe
• AI: Google Gemini, OpenRouter
• Deployment: Netlify
• Icons: Lucide React

📱 Key Pages

• Home: Landing page with featured campaigns
• Explore: Browse all active campaigns
• Create Fund: AI-assisted campaign creation
• My Funds: Manage your campaigns
• Wallet: Financial dashboard
• Referrals: Earnings and referral management
• Settings: Account and preferences

🔧 Development

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

🌟 Benefits of Modular Architecture

1. Token Efficiency: Work on specific features without loading entire codebase
2. Maintainability: Clear separation of concerns
3. Scalability: Easy to add new features as modules
4. Team Collaboration: Multiple developers can work on different modules
5. Code Reusability: Modules can be reused across projects
6. Testing: Easier to test individual modules

📄 License

MIT License - see LICENSE file for details.