Leave Localhost logoLeave LocalhostDocs
Reference

Scripts

The root package.json scripts for developing, validating, building, and deploying the monorepo with Bun and Turborepo.

Run these from the repo root with bun run <script>. They orchestrate the workspaces through Turborepo. Use Bun, not npm/pnpm/yarn.

Develop

ScriptWhat it does
devRun every app and the Convex backend together.
dev:appRun the product app (apps/app, port 3000) only.
dev:marketingRun the marketing site (apps/marketing, port 3002) only.
dev:docsRun this documentation site (apps/docs, port 3004) only.
dev:convexRun the Convex backend dev server only.
dev:emailRun the React Email preview server.

Build and run

ScriptWhat it does
buildRun check-env, then build every workspace.
start:app / start:marketing / start:docsStart a built app in production mode.

Validate

ScriptWhat it does
check-env (alias setup:doctor)Run the environment doctor across workspaces.
release:checkRun launch env validation, lint, typecheck, tests, and build in release-gate order.
typecheckTypeScript checks across all workspaces.
lintBiome lint across workspaces, then repo-level sherif and Turborepo boundary checks.
lint:boundariesRun Turborepo boundary checks for source packages.
lint:repo / lint:repo:fixRun (or autofix) the sherif workspace-consistency lint.
formatFormat the repo with Biome.
testRun all workspace tests and the env-doctor tests.

Maintenance

ScriptWhat it does
cleanRemove the root node_modules.
clean:workspacesRun each workspace's clean (build artifacts, caches).

Individual workspaces expose their own scripts; run them with bun --cwd <workspace> run <script> (for example bun --cwd apps/app run typecheck).

On this page