# Workspace scripts

Run the repository’s existing entry points from the workspace root.

| Command                                | Purpose                                             |
| -------------------------------------- | --------------------------------------------------- |
| `pnpm setup` / `pnpm doctor`           | Configure or diagnose the project                   |
| `pnpm dev`                             | Start workspace development tasks                   |
| `pnpm dev:web`                         | Start the web application                           |
| `pnpm build`                           | Build workspace targets                             |
| `pnpm check-types`                     | Run workspace type checks                           |
| `pnpm lint`                            | Repository source checks                            |
| `pnpm exec oxlint`                     | Oxlint, including import boundaries                 |
| `pnpm format:check` / `pnpm format`    | Check changed files / format                        |
| `pnpm test`                            | Unit suites across workspaces                       |
| `pnpm test:integration`                | Isolated local Postgres integration suite           |
| `pnpm db:generate` / `pnpm db:migrate` | Generate / apply reviewed migrations                |
| `pnpm db:studio`                       | Open database inspection tooling                    |
| `pnpm jobs:run`                        | Run scheduled work manually against configured data |
| `pnpm update:js`                       | Guarded JavaScript dependency updater               |
| `pnpm deploy`                          | Explicit deployment to the configured Worker        |

`db:push` deliberately refuses execution. Jobs and deployment commands can change configured remote state; use a disposable environment for experiments. See [testing](/docs/development/testing) for isolated commands.

Turborepo coordinates workspace tasks. Before changing its configuration, resolve the installed `turbo` package and read its bundled `docs/README.md` and relevant task documentation; behavior is version-dependent.

## Key files [#key-files]

- [`package.json`](https://github.com/CarlosZiegler/template-cloudflare/blob/main/package.json)
- [`turbo.json`](https://github.com/CarlosZiegler/template-cloudflare/blob/main/turbo.json)
- [`scripts/update-dependencies.mjs`](https://github.com/CarlosZiegler/template-cloudflare/blob/main/scripts/update-dependencies.mjs)

