Running locally

From the generated project root (or a clone of vinicunca/taman).

1. Postgres

docker compose up -d

This starts postgres:18 as taman-postgres (or <name>-postgres after generate):

• User / password: postgres / postgres
• Database: taman_db (or the snake_case project name)
• Host port: 5437 → container 5432
• Healthcheck: pg_isready -U postgres -d taman_db

2. Schema

pnpm db-pg:migrate:dev

That runs drizzle-kit push against packages/server/db-pg/.env. There is no migrations/ directory in the repo yet — local dev uses push, not migrate. UAT/prod nx targets run drizzle-kit migrate and expect generated SQL under packages/server/db-pg/migrations.

3. Seed a dev admin (optional)

pnpm nx run api:seed

Creates or updates:

The todo pages need that membership: the admin role alone does not pass the service's organization check. If you were signed in before seeding, sign out and back in so the session picks up the organization.

Dev and e2e only. Do not use these credentials in production.

Todos:

pnpm nx run api:seed:todos

That uses tsx, not Bun. It fills the oldest organization (the seeded demo on a fresh database); set SEED_ORG_SLUG to choose another.

4. Dev servers

Two terminals:

pnpm dev:api    # Nitro on http://localhost:8788
pnpm dev:web    # Vite on http://localhost:5556

pnpm dev:api is nx run api:dev (nitro dev, NODE_OPTIONS=--no-deprecation). pnpm dev:web is nx run web:dev (vite --mode development).

Open http://localhost:5556. Sign in with the seeded admin. The app home is /todos/manage (overridden in apps/web/src/preferences.ts). taman-core's published default home is still /dashboard, which has no page in this template.

Ports

Health

curl http://localhost:8788/healthz    # { "status": "ok" } — process is up
curl http://localhost:8788/readyz     # database reachable

Studio

pnpm dev:db-pg:studio

Opens Drizzle Studio using packages/server/db-pg/.env.