Local development

Prerequisites

• Node.js (LTS)
• pnpm
• Docker (for Postgres and MinIO)

Quick setup

From the repository root:

pnpm setup

This creates .env, installs dependencies, starts Docker services, pushes the schema, and optionally seeds demo data.

Run the app

In one terminal:

pnpm dev

In another terminal (required for collaborative Docs):

pnpm collab:dev

Open http://localhost:5173.

Environment

Copy variables from .env.example. At minimum you need:

• DATABASE_URL
• BETTER_AUTH_SECRET
• S3_* values for MinIO
• PUBLIC_COLLAB_WS_URL=ws://localhost:1234 for Docs editing

Useful commands

Command	Description
pnpm db:start	Start Postgres + MinIO
pnpm db:push	Sync schema locally
pnpm db:seed	Load demo data
pnpm check	Type-check the app

Next steps

• Docker Compose (dev services)
• Production deployment