Local development
Run the marketing site, console, and docs side by side from the monorepo root.
Install
cd /path/to/web
npm install
Commands
| Command | Port | App |
|---|---|---|
npm run dev | 3000 | Next.js marketing |
npm run dev:console-app | 5174 | Constellation OS console |
npm run dev:docs | 3001 | Docusaurus docs |
Console setup
cp apps/console-app/.env.local.example apps/console-app/.env.local
Optional: point at a local OS API:
VITE_CONSTELLATION_API_URL=http://localhost:8000
CONSTELLATION_API_URL=http://localhost:8000
The Vite plugin osApiProxy.ts forwards /app/api/os/* to that backend.
Docs setup
npm run dev:docs
# http://localhost:3001
Sample scenarios (optional)
Generate training scenarios for workshops:
npm run generate:oneweb -w constellation-os-app
Production programs use live topology and telemetry from the API—not bundled samples.
Fleet agent (local)
export CONSTELLATION_API_TOKEN=cos_dev_...
node packages/fleet-agent/bin/fleet-agent.mjs configure --config-dir ~/.constellation
node packages/fleet-agent/bin/fleet-agent.mjs topology pull --out /tmp/topology.json
Typecheck & lint
npm run typecheck
npm run lint
npm run build:docs
npm run build:console-app