A decentralized platform empowering direct aid distribution through crypto, built on Base Network with transparent tracking and proof-of-use verification.
Aidly enables direct aid distribution through:
- Category-based USDC donation pools (Food, Medicine, Education, Emergency)
- Transparent on-chain fund tracking
- Admin-verified aid distribution
- Proof-of-use requirements and task-based incentives
- Frontend: Next.js, RainbowKit, wagmi, TailwindCSS
- Backend: Go (Gin), PostgreSQL
- Smart Contracts: Solidity (Base Network)
- Wallet Support: MetaMask, Coinbase Wallet, WalletConnect
- Node.js 18+
- Go 1.20+
- PostgreSQL
- Foundry
- Clone the repository:
git clone https://github.com/yourusername/aidly.git
cd aidly- Install frontend dependencies:
cd frontend
npm install- Install backend dependencies:
cd ../backend
go mod tidy- Install and build smart contracts:
cd ../contracts
forge install
forge build- Create
.envfiles in each directory:
# Root .env
POSTGRES_URL=your_postgres_url
ADMIN_WALLETS=comma,separated,addresses
# Frontend .env.local
NEXT_PUBLIC_BACKEND_URL=http://localhost:8080
NEXT_PUBLIC_CONTRACT_ADDRESS=your_contract_address
# Backend .env
DATABASE_URL=your_postgres_url
JWT_SECRET=your_jwt_secret- Start the frontend:
cd frontend
npm run dev- Start the backend:
cd backend
go run cmd/main.go/
├── contracts/ # Foundry smart contracts
├── frontend/ # Next.js frontend
└── backend/ # Go backend
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Open a Pull Request
MIT