Instructions

When to Use

• Use for pnpm workspaces + Turborepo with Next apps.
• Prefer github-actions-ci to wire the pipelines into Actions.
• Prefer container-local-dev for Dockerized local stacks.

Structure pnpm workspaces + Turborepo for one or more Next.js apps and shared packages.

1. Define pnpm-workspace.yaml globs; separate apps/* and packages/*.
2. turbo.json pipelines: build depends on ^build; cache outputs for Next .next and dist folders.
3. Internal packages: TypeScript project references or transpilePackages in Next when consuming local UI libs.
4. Env: root vs app .env; never duplicate secrets in git.
5. Versioning: single lockfile; align Node engine field.

Outcomes

• Folder tree + turbo.json task outline + pnpm filter examples.