Skip to main content
Use Node.js 24 and the repository’s workspace lockfile. The API workspace pins Bun for its runtime and scripts.

​
Repository map

Console and Auth are HTTP frontends. Business and identity services now live in apps/api; older historical documents may refer to their former location in the frontends.

​
Install

Configure only the local environment variables required by the workspace you run. Follow its checked-in examples and scripts. Do not copy production database URLs or provider credentials into a test environment.

​
Start a workspace

Run the relevant command in its own terminal after preparing its local configuration:
Console uses port 3120 and the Auth UI uses port 3125. Running the frontend alone does not provision a backend or establish account access.

​
Verify changes

The API fixture creates labeled disposable local PostgreSQL infrastructure and ignored test environment files. It requires Docker. Use the root workspace scripts:
Run the relevant frontend or shared-package checks for your change. Use npm run test:teardown -w @webdock/api to remove the owned fixture after testing. Follow the fixture output for its actual local target; never point test setup at production. Read repository AGENTS.md files before contributing. For Next.js changes, consult the documentation shipped with the installed version.