Getting Started

Prerequisites: Node.js 18+, DFX 0.15.0+, and 10GB free disk space

Quick Start (5 minutes)

1. Clone the Repository

git clone https://github.com/tojo04/DAO_launcher_kit.git
cd DAO_launcher_kit

2. Install Dependencies

npm install
cd src/dao_frontend && npm install && cd ../..

3. Start Local IC Replica

dfx start --clean --background

4. Deploy All Canisters

./deploy.sh

This script deploys all 9 canisters in the correct order with proper initialization. It takes about 2-3 minutes to complete.

5. Start Frontend

cd src/dao_frontend
npm run dev

Open http://localhost:5173 in your browser.

What Gets Deployed

Core Canisters

  • ✅ dao_backend - Main coordinator (user management, admin)
  • ✅ governance - Voting and proposal management
  • ✅ staking - Token staking and rewards
  • ✅ treasury - Multi-sig financial operations

Support Canisters

  • ✅ dao_registry - Global DAO discovery
  • ✅ dao_analytics - Platform metrics
  • ✅ proposals - Proposal templates
  • ✅ assets - File storage
  • ✅ icrc1_ledger - Token standard

Next Steps

Create Your First DAO →

Step-by-step guide to launching your first DAO

Explore the API →

Learn about available canister methods

Understand Architecture →

Deep dive into the canister architecture

Governance Guide →

Learn about proposal creation and voting

Troubleshooting

Port Already in Use

If port 4943 or 5173 is already in use:

dfx stop
pkill dfx
./deploy.sh

Canister Initialization Failed

Clean deployment and start fresh:

dfx stop
rm -rf .dfx
dfx start --clean --background
./deploy.sh

Frontend Build Errors

Clear cache and rebuild:

cd src/dao_frontend
npm run clean:cache
npm install
npm run dev