🏛️ BuidlLand is a comprehensive decentralized platform for creating and managing DAOs (Decentralized Autonomous Organizations) with advanced governance, task management, and reputation systems.
⚙️ Built using NextJS, RainbowKit, Foundry, Wagmi, Viem, TypeScript, and the Diamond Standard (ERC-2535).
- 🏗️ Advanced DAO Creation: Create DAOs with custom governance parameters and token economics
- 🗳️ Sophisticated Governance: Proposal creation, voting, and execution with timelock mechanisms
- 📋 Task Management: Comprehensive bounty system with task lifecycle management
- 🎯 Dynamic Reputation: Governance Points (GP) system based on activity, staking, and time factors
- � Diamond Architecture: Modular and upgradeable smart contracts using ERC-2535
- 🔗 Full-Stack Integration: Seamless frontend-backend-blockchain integration
BuidlLand/
├── packages/
│ ├── foundry/ # Smart contracts (Solidity + Foundry)
│ │ ├── contracts/ # Diamond facets and core contracts
│ │ ├── script/ # Deployment scripts
│ │ └── test/ # Comprehensive test suite
│ └── nextjs/ # Frontend application (Next.js + TypeScript)
│ ├── app/ # Next.js 13+ app directory
│ ├── components/ # React components
│ ├── hooks/ # Custom React hooks
│ └── lib/ # Utilities and configurations
Before you begin, you need to install the following tools:
- Node.js (>= v18)
- npm (comes with Node.js)
- Foundry for smart contract development
- PostgreSQL for off-chain data storage
- Git
# Clone the repository
git clone https://github.com/your-org/buidlland.git
cd buidlland
# Install Foundry dependencies
cd packages/foundry
forge install
# Install frontend dependencies
cd ../nextjs
npm install# Copy environment templates
cp packages/nextjs/.env.example packages/nextjs/.env.local
cp packages/foundry/.env.example packages/foundry/.env
# Set up PostgreSQL database
createdb buidlland
# Run database migrations
cd packages/nextjs
npx prisma migrate dev
# Seed the database with initial data (optional)
npm run seed:dev# Terminal 1: Start local blockchain
cd packages/foundry
make chain
# Terminal 2: Deploy contracts
make deploy-quick
# Terminal 3: Start frontend
cd packages/nextjs
npm run dev- Frontend: http://localhost:3000
- Database Studio:
npx prisma studio(from packages/nextjs) - Local Blockchain: http://127.0.0.1:8545
cd packages/foundry
# Run all tests
make test
# Run specific test suites
make test-dao # DAO Management tests
make test-governance # Governance tests
make test-gp # GP Management tests
make test-task # Task Management tests
# Run with coverage
make test-coveragecd packages/nextjs
# Run unit tests
npm test
# Run integration tests
npm run test:integration- User Guide - How to use BuidlLand
- DAO Discovery Guide - Discover and join new DAOs
- Personal Dashboard Guide - Your personal hub for DAO activity
- DAO Creation Guide - Step-by-step DAO setup
- Governance Guide - Understanding proposals and voting
- Development Setup - Detailed development environment setup
- Smart Contract Architecture - Contract design and implementation
- API Documentation - Backend API reference
- Frontend Architecture - React components and hooks
We welcome contributions to BuidlLand! Please see our Contributing Guide for details on:
- Code of Conduct
- Development Process
- Pull Request Process
- Issue Reporting
- Feature Requests
This project is licensed under the MIT License - see the LICENSE file for details.
- Scaffold-ETH 2: Foundation for the development framework
- Diamond Standard: ERC-2535 for upgradeable contracts
- OpenZeppelin: Security-focused contract libraries
- Foundry: Modern Ethereum development toolchain
Built with ❤️ by the BuidlLand team