Skip to main content

Local Dev Setup

:::info Source Sourced from services/catalog-service/LOCAL_DEV_SETUP.md in the documentation repo. :::

1. Prerequisites​

Node 20, pnpm 9, Docker 24.

2. Quick Start​

cd services/catalog-service
cp .env.example .env.local
pnpm install
docker compose -f docker-compose.dev.yml up -d
pnpm db:migrate
pnpm seed
pnpm dev                  # :3070

3. Dependencies​

postgres, redis, nats.

4. Environment​

PORT=3070
DATABASE_URL=postgres://catalog:catalog@localhost:5432/catalog
REDIS_URL=redis://localhost:6379/70
NATS_URL=nats://localhost:4222
NATS_STREAM=CATALOG

5. Seed​

  • 10 published courses (2 tenants).
  • Taxonomy tree (5 categories, 20 tags).
  • 2 withdrawn courses for test.

6. Commands​

pnpm dev
pnpm test
pnpm test:integration
pnpm taxonomy:validate
pnpm course:publish-sim <draftId>