Development Workflow

A repo-aligned day-to-day workflow for building features.

Start the app

pnpm compose:dev:up
pnpm dev

Organize feature code

Typical feature layout:

apps/web/app/[locale]/(internal)/feature/
├── page.tsx
├── _components/
└── _lib/

Common naming:

  • loaders: *-page.loader.ts
  • actions: *-server-actions.ts
  • schemas: *.schema.ts

When to create a package

Create a shared workspace package only if the code needs a stable boundary or will be reused across apps/packages. Put it under packages/ or an existing grouped family like packages/account/ or packages/organization/.

Suggested flow

  1. create or update validation schema
  2. update database code if needed
  3. add loader or action
  4. build UI
  5. verify with repo checks

Checks

pnpm typecheck
pnpm lint:fix
pnpm format:fix
pnpm test:unit

pnpm healthcheck is useful too, but it does not replace pnpm test:unit.

Next: Adding Features →