Welcome to the official Celo Europe front-end application — a Next.js-based dApp enabling users to connect their wallets, learn about Celo, and participate in the Nexus Program.
- 🔐 Secure Web3 Authentication: Wallet-based login with automatic JWT token refresh
- 🪪 Nexus Explorer Badge: NFT badge system for verifiable Celo Europe membership
- 📚 Educational Content: Comprehensive guide to help onboard users to the Celo ecosystem
- 📝 Community Platform: Blog and collaborative features (coming soon)
- 🛡️ Enterprise Security: Rate limiting, replay protection, and secure authentication
- Next.js (App Router) with TypeScript
- Tailwind CSS with custom theme system
- Wagmi & Viem for Web3 wallet connectivity
- RainbowKit for wallet UI components
- MongoDB for user data and authentication
- Custom JWT Authentication with automatic token refresh
- CELO blockchain (Alfajores/Testnet & Mainnet support)
# Install dependencies
pnpm install
# Configure environment variables
cp packages/web/.env.example packages/web/.env.local
# Edit packages/web/.env.local with your configuration:
# - Set NEXT_PUBLIC_IS_PROD=false for development (Alfajores testnet)
# - Set NEXT_PUBLIC_IS_PROD=true for production (Celo mainnet)
# - Configure separate MongoDB URIs for production and development
# - Add your JWT secret, REOWN project ID, and allowed origins
# Run the local dev server
pnpm devThe application uses environment-based configuration to support both development and production modes:
Development Mode (NEXT_PUBLIC_IS_PROD=false):
- Celo Alfajores testnet
- Development MongoDB database
- Testnet contract addresses
Production Mode (NEXT_PUBLIC_IS_PROD=true):
- Celo mainnet
- Production MongoDB database
- Mainnet contract addresses
See packages/web/.env.example for the complete environment variable template.
Comprehensive documentation is available in the packages/web/ directory:
- Authentication System - Complete authentication flow
- Token Refresh Guide - Automatic token management
- Security Implementation - Security features and best practices
- Refactoring Summary - Recent improvements
- Web App README - Detailed setup and usage guide
celo-eu/
├── packages/
│ ├── web/ # Next.js Web3 application
│ │ ├── app/ # App router pages and API routes
│ │ ├── components/# React components and auth system
│ │ ├── lib/ # Authentication and utility libraries
│ │ └── docs/ # Comprehensive documentation
│ └── hardhat/ # Smart contracts and deployment
└── README.md # This file
Created with 💛 by AXMC for Celo Europe using Celo Composer