Cursor rule

1---
2description: Infrastructure setup, Docker services, and environment configuration
3globs:
4  - "docker/**/*"
5  - "*.env*"
6  - ".env*"
7  - "**/docker-compose*"
8alwaysApply: false
9---
10 
11## Infrastructure
12 
13**Start all services:** `docker compose -f docker/local/docker-compose.yml up -d`
14 
15**Agent environments** use a separate compose file — restart after a reboot with:
16`docker compose -f docker/local/docker-compose.agent.yml up -d`
17 
18| Service | Port | Purpose |
19|---------|------|---------|
20| MongoDB | 27017 | Primary database |
21| Redis | 6379 | Caching + Bull queues |
22| ClickHouse | 8123 (HTTP) / 9000 (native) | Analytics, activity feed, traces |
23| LocalStack | 4566 | S3 emulation (optional) |
24 
25**Services needed per task:**
26- Dashboard UI only: nothing (user has it running on port 4201)
27- API endpoints: `pnpm start:api:dev`
28- Notification flows: API + `pnpm start:worker`
29- Real-time features: API + Worker + `pnpm start:ws`
30- Full stack: `docker compose` + all of the above
31 
32Run `pnpm build` before starting services only if changes were made to `libs/`, `packages/`, or `enterprise/`. Cloud agent install/update uses `pnpm build:agents`, which skips full app builds but still runs `@novu/api-service:build:metadata` (apps otherwise build when their dev servers start).