Concourse is a pnpm and Turborepo workspace for organization-based web applications. It contains shared authentication, database, email, interface, and configuration packages.
Install the required local tools. Then run these commands from the repository root:
pnpm install
pnpm dev:setup
pnpm verify
pnpm devpnpm dev:setup creates the local SQLite database, applies migrations, adds seed data, and creates the first system administrator.
Open these services after pnpm dev starts:
| Service | URL |
|---|---|
| Application | http://localhost:3000 |
| Repository Documentation | http://localhost:3001 |
| Tredis Documentation | http://localhost:3002 |
| Drizzle Studio | https://local.drizzle.studio |
| Maildev | http://localhost:1080 |
Press Ctrl+C when you finish. This stops the applications, Drizzle Studio, and Maildev.
The workspace has two types of top-level directory:
apps/ contains deployable Next.js applications.packages/ contains shared libraries and development tools.The main applications are:
| Workspace | Purpose |
|---|---|
@concourse/concourse | The web application and system administration interface |
@concourse/docs.concourse | The repository documentation |
@concourse/docs.tredis | The documentation for the next version of Tredis |
pnpm installs workspace dependencies and enforces the package graph. Turborepo schedules tasks, tracks inputs, and restores safe cached results.
The repository commits safe local defaults. Put personal overrides and local secrets in the ignored .env.local file.
Use these guides for local work:
Run pnpm verify before you submit a change. This command runs every merge gate, including the complete acceptance lifecycle.
The Concourse application deploys from main to the existing concourse Vercel project. Local
development and CI use SQLite files. Production uses Turso. Trusted pull requests use one isolated
Turso database per pull request. Resend uses the verified mail.tredis.dev sending domain and
sends only to the configured test recipient until the allowlist is deliberately removed.
Follow the deployment bootstrap runbook to configure Turso, Resend, Vercel, GitHub secrets, preview databases, production migrations, and recovery checks.
The documents in docs/concourse/rackspace/ describe the future Rackspace schema boundary for
the @concourse/rsdb package. They do not add Rackspace features to the deployed application.
The shared packages have specialized guides:
The tredis.dev name remains in application and domain identifiers where the product contract requires it.
Concourse is a pnpm and Turborepo workspace for organization-based web applications. It contains shared authentication, database, email, interface, and configuration packages.
Install the required local tools. Then run these commands from the repository root:
pnpm install
pnpm dev:setup
pnpm verify
pnpm devpnpm dev:setup creates the local SQLite database, applies migrations, adds seed data, and creates the first system administrator.
Open these services after pnpm dev starts:
| Service | URL |
|---|---|
| Application | http://localhost:3000 |
| Repository Documentation | http://localhost:3001 |
| Tredis Documentation | http://localhost:3002 |
| Drizzle Studio | https://local.drizzle.studio |
| Maildev | http://localhost:1080 |
Press Ctrl+C when you finish. This stops the applications, Drizzle Studio, and Maildev.
The workspace has two types of top-level directory:
apps/ contains deployable Next.js applications.packages/ contains shared libraries and development tools.The main applications are:
| Workspace | Purpose |
|---|---|
@concourse/concourse | The web application and system administration interface |
@concourse/docs.concourse | The repository documentation |
@concourse/docs.tredis | The documentation for the next version of Tredis |
pnpm installs workspace dependencies and enforces the package graph. Turborepo schedules tasks, tracks inputs, and restores safe cached results.
The repository commits safe local defaults. Put personal overrides and local secrets in the ignored .env.local file.
Use these guides for local work:
Run pnpm verify before you submit a change. This command runs every merge gate, including the complete acceptance lifecycle.
The Concourse application deploys from main to the existing concourse Vercel project. Local
development and CI use SQLite files. Production uses Turso. Trusted pull requests use one isolated
Turso database per pull request. Resend uses the verified mail.tredis.dev sending domain and
sends only to the configured test recipient until the allowlist is deliberately removed.
Follow the deployment bootstrap runbook to configure Turso, Resend, Vercel, GitHub secrets, preview databases, production migrations, and recovery checks.
The documents in docs/concourse/rackspace/ describe the future Rackspace schema boundary for
the @concourse/rsdb package. They do not add Rackspace features to the deployed application.
The shared packages have specialized guides:
The tredis.dev name remains in application and domain identifiers where the product contract requires it.