Decentralized crowdfunding platform combining Web3 blockchain transparency with Web2 fiat usability and Apple-grade UI.

Fundloom bridges the gap between traditional crowdfunding and decentralized finance. Campaign creators can raise funds using crypto (USDC) or fiat, while backers benefit from blockchain-verified transparency and milestone-based escrow protection.

• Multi-Rail Funding — Accept both crypto (USDC on Base Sepolia) and fiat payments
• Milestone-Based Escrow — Funds released progressively as campaign goals are achieved
• Gas Abstraction — Zero gas fees for users; gas costs are abstracted away
• Embedded Wallets — Auto-generated wallets for seamless onboarding without browser extensions

• Email-Only Authentication — Simple login with just email (powered by Privy)
• Apple-Grade UI — Premium, polished interface built with Tailwind CSS and Framer Motion
• Real-Time Progress — Live funding updates and campaign status tracking
• Social Virality — ShareRow component for easy campaign promotion

• On-Chain Transparency — Every transaction verifiable on Base Sepolia blockchain
• Fraud Detection — AI-powered system to identify and flag suspicious campaigns
• Verified Badges — Trust indicators for verified campaign creators

• Dispute Creation — Campaign creators can initiate disputes for withdrawals or milestone releases
• Token-Weighted Voting — DAO token holders vote on dispute outcomes (currently using 1 vote per address for PoC)
• Appeal System — Multi-tier appeal process with higher fees and different voting parameters
• Quorum Requirements — Minimum participation thresholds for valid votes (4% for disputes, 10% for appeals)
• Automatic Execution — Smart contract automatically executes dispute outcomes after voting period ends

• Node.js 18+
• Bun (recommended) or npm
• Supabase account
• Privy account
• Foundry (for smart contract development)

# Clone the repository
git clone https://github.com/Mosss-OS/fundloom.git
cd fundloom

# Install dependencies
bun install

# Set up environment variables
cp .env.example .env
# Edit .env with your Supabase and Privy credentials

# Start development server
bun dev

# Supabase (provided)
VITE_SUPABASE_URL=https://xoaminsmueojehukspae.supabase.co
VITE_SUPABASE_PUBLISHABLE_KEY=your_publishable_key

# Privy (get from dashboard.privy.io)
VITE_PRIVY_APP_ID=your_privy_app_id

# Smart Contract (after deployment)
VITE_FUNDLOOM_FACTORY_ADDRESS=0x...

The FundloomFactory smart contract is ready for deployment to Base Sepolia.

1. Fund the deployment wallet with Base Sepolia ETH:

   • Wallet: 0x3E78Cfe4f3FEb28F8F1C56BABbF53a898b5F76DA
   • Faucets: https://www.coinbase.com/faucets/base-sepolia-faucet

2. Deploy the contract:

   source .env
   forge script script/DeployFundloomFactory.s.sol \
     --rpc-url base-sepolia \
     --private-key $DEPLOYER_PRIVATE_KEY \
     --broadcast \
     --verify

3. Add contract address to .env:

   VITE_FUNDLOOM_FACTORY_ADDRESS=0x...
   

See DEPLOY.md for detailed instructions.

fundloom/
├── src/
│   ├── components/       # Reusable UI components
│   ├── routes/           # Page routes (TanStack Router)
│   ├── server/           # Server functions
│   ├── integrations/     # Third-party integrations
│   │   └── supabase/     # Supabase client & types
│   │   └── contract.ts   # Smart contract integration
│   ├── auth/            # Authentication (Privy)
│   ├── lib/             # Utilities and helpers
│   └── styles.css       # Global styles
├── contracts/            # Smart contracts (Foundry)
│   ├── src/             # Solidity contracts
│   ├── script/          # Deployment scripts
│   └── out/             # Compiled contracts
├── supabase/
│   └── migrations/       # Database migrations
└── public/              # Static assets

# Install Vercel CLI
npm install -g vercel

# Login and deploy
vercel login
vercel --prod

1. Sign Up — Login with just your email (wallet auto-created)
2. Create Campaign — Set funding goal, milestones, and campaign details
3. Receive Funding — Accept USDC or fiat contributions
4. Withdraw Funds — Release milestone funds to your wallet

1. Discover Campaigns — Browse verified campaigns on the explore page
2. Contribute — Fund campaigns using USDC or fiat
3. Track Progress — Monitor milestone completion in real-time
4. Verify Impact — All transactions visible on-chain

• Mainnet deployment with USDC
• Smart contract implementation for escrow
• Mobile app (React Native)
• Fiat on-ramp integration (Stripe/Flutterwave)
• Social features (comments, updates)
• DAO governance for disputes

Contributions are welcome! Please read our development guidelines before submitting PRs.

# After cloning, install dev dependencies
bun install

# Run linting
bun lint

# Type check
bun typecheck

MIT License — see LICENSE for details.

• Live App: https://fundloom.vercel.app
• GitHub: https://github.com/Mosss-OS/fundloom
• Issues: https://github.com/Mosss-OS/fundloom/issues

Built with 🔗 by Mosss-OS

Foundry is a blazing fast, portable and modular toolkit for Ethereum application development written in Rust.

Foundry consists of:

• Forge: Ethereum testing framework (like Truffle, Hardhat and DappTools).
• Cast: Swiss army knife for interacting with EVM smart contracts, sending transactions and getting chain data.
• Anvil: Local Ethereum node, akin to Ganache, Hardhat Network.
• Chisel: Fast, utilitarian, and verbose solidity REPL.

https://book.getfoundry.sh/

# Build contracts
forge build

# Run tests
forge test

# Format code
forge fmt

# Start local node
anvil