INSTALLATION.md

Installation

This guide explains how to set up the CeloHT development environment.

---

System Requirements

Minimum:

• Git
• Node.js 20+
• npm or pnpm
• VS Code (recommended)

Recommended:

• Ubuntu 24.04 LTS or newer
• macOS
• Windows 11 with WSL2

---

Clone the Repository

git clone https://github.com/Celo-HT/CeloHT.git
cd CeloHT

---

Install Dependencies

Using npm:

npm install

Or using pnpm:

pnpm install

---

Configure Environment Variables

Create a .env.local file.

Example:

NEXT_PUBLIC_NETWORK=alfajores
NEXT_PUBLIC_RPC_URL=https://alfajores-forno.celo-testnet.org
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=YOUR_PROJECT_ID

Never commit your private keys or secrets.

---

Start the Development Server

npm run dev

or

pnpm dev

Open your browser:

http://localhost:3000

---

Build for Production

npm run build

---

Start Production

npm start

---

Run Tests

npm test

---

Run Linter

npm run lint

---

Project Structure

CeloHT/
├── app/
├── components/
├── public/
├── docs/
├── contracts/
├── scripts/
├── lib/
├── styles/
├── package.json
└── README.md

---

Troubleshooting

Dependencies fail to install

Try:

rm -rf node_modules
rm package-lock.json
npm install

---

Development server won't start

Check:

• Node.js version
• Environment variables
• Internet connection
• Port 3000 availability

---

Wallet connection issues

Verify:

• Valora is installed.
• The correct Celo network is selected.
• Your internet connection is stable.

---

Keeping Your Installation Updated

git pull origin main
npm install

---

Need Help?

If you encounter an issue:

• Search existing GitHub Issues.
• Open a new issue with detailed information.
• Join the community discussions.

---

Thank you for contributing to CeloHT and helping build an open, transparent, and inclusive Web3 ecosystem.