Quick Start

git clone https://github.com/learnwayxyz/learnway-backend.git
cd learnway-backend

npm install

cp config/env/.env.example config/env/.env

# Core
NODE_ENV=dev
PORT=3000

# Database
DB_HOST=localhost
DB_PORT=5432
DB_USERNAME=postgres
DB_PASSWORD=your_password
DB_NAME=learnway

# Redis
REDIS_URL=redis://localhost:6379

# JWT
JWT_SECRET=change_me_to_a_long_random_string

# ImageKit (required — get a free account at imagekit.io)
IMAGEKIT_PUBLIC_KEY=your_public_key
IMAGEKIT_PRIVATE_KEY=your_private_key
IMAGEKIT_URL_ENDPOINT=https://ik.imagekit.io/your_id

# Blockchain (Lisk testnet for dev)
BLOCKCHAIN_RPC_URL=https://rpc.api.lisk.com
CHAIN_ID=1135
LEARNWAY_MANAGER_CONTRACT_ADDRESS=0x...
BADGES_NFT_CONTRACT_ADDRESS=0x...
GEM_CONTRACT_ADDRESS=0x...
XP_CONTRACT_ADDRESS=0x...
PRIVATE_KEY=0x...

# Fonbnk Payments
FONBNK_CLIENT_ID=your_client_id
FONBNK_CLIENT_SECRET=your_base64_secret
FONBNK_WEBHOOK_SECRET=your_webhook_secret

# Misc — required by schema validation
UNSUBSCRIBE_TOKEN_SECRET=change_me
CMC_API_KEY=your_coinmarketcap_key

CREATE DATABASE learnway;

npm run migration:run:dev

npm run seed:admin:dev

npm run start:dev

# Create the shared network
docker network create learnway-network

# Start PostgreSQL
docker run -d \
  --name learnway-db \
  --network learnway-network \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=your_password \
  -e POSTGRES_DB=learnway \
  -p 5432:5432 \
  postgres:15

# Start Redis
docker run -d \
  --name learnway-redis \
  --network learnway-network \
  -p 6379:6379 \
  redis:7

# Build and run the API
docker build -t learnway-backend .
docker run -d \
  --name learnway-api \
  --network learnway-network \
  -p 3000:3000 \
  --env-file config/env/.env \
  learnway-backend