LanceFlow

Structured performance ecosystem — Where Strong Action Meets Seamless Flow.

Quick start

Prerequisites: Node.js 20+, pnpm 9 (npm install -g pnpm or corepack enable)

cd d:\Projects\LanceFlow
pnpm install
pnpm dev

Open http://localhost:3000 · Health API: http://localhost:3000/api/health

pnpm build      # production build (all packages)
pnpm typecheck
pnpm lint

Copy .env.example → .env before database migrations.

Local database

Windows / docker not found? See LOCAL_DEV_WINDOWS.md (install Docker or use Neon without Docker).

With Docker: Docker Desktop

docker compose up -d              # Postgres :5432, Redis :6379
docker compose --profile storage up -d   # + MinIO :9000 (API), :9001 (console)
docker compose down               # stop; add -v to remove volumes

Then run migrations:

pnpm db:migrate:deploy   # requires DATABASE_URL in .env (matches .env.example)

Documentation

Audience	Document
Current status (clients)	documents/docs/PROJECT_STATUS.md
Project board	GITHUB_PROJECT_BOARD.md
DevOps (GitHub, deploy)	documents/docs/DEVOPS_GUIDE.md
Observability	documents/docs/OBSERVABILITY.md
Auth	documents/docs/AUTH.md
Local dev (Windows)	documents/docs/LOCAL_DEV_WINDOWS.md
Active stories	documents/stories/
Architecture	documents/docs/MODULAR_ARCHITECTURE.md

Repo layout

apps/web              → Next.js app
packages/core/types   → shared types
packages/core/database → Prisma (PostgreSQL)
packages/modules/     → domain modules (added per story)
documents/            → planning & story prompts