Synaro docs

Local development

Run the full stack with Docker Compose and environment variables.

Prerequisites

Node.js 20+
Docker Desktop (for environment-service socket access)
PostgreSQL clients optional (migrations via Prisma)

Start infrastructure

From repository root

docker compose up -d postgresql postgresql-env
cd app && npm install && npm run db:migrate:local
docker compose up project-service environment-service ai-orchestration-service execution-manager
cd app && npm run dev

Environment files

Copy env examples into app/.env.local (DATABASE_URL, NEXTAUTH_SECRET, NEXTAUTH_URL, GitHub OAuth if used). Set KIMI_API_KEY for AI features. environment-service reads app/.env.local via docker-compose env_file.

After changing Prisma schemas, run migrate/generate in the relevant package before restarting services.