# Monorepo Tooling

> pnpm workspaces and Turborepo with Next.js apps - boundaries caching and shared packages

- Skill: `bh611627/monorepo-tooling` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bh611627/monorepo-tooling`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bh611627/monorepo-tooling/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: bh611627 (https://skillmd.com/u/bh611627)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/bh611627/monorepo-tooling

---


# 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.

## Output Rules

Commands use `pnpm` and `turbo` only; match user lockfile if mixed.

## Scope and boundaries

- **In scope:** workspace layout, turbo pipelines, Next consumption of local packages.
- **Out of scope:** Nx-specific generators, Bazel.

## Safety

- Read-only unless editing config files is explicitly requested.

## Troubleshooting

- **Module not found across workspace:** check `package.json` `exports` and TypeScript paths.
- **Turbo cache too aggressive:** `outputs` keys wrong for Next - fix globs.

## Related skills

- [`github-actions-ci`](../github-actions-ci/SKILL.md) - workspace CI graph
- [`container-local-dev`](../container-local-dev/SKILL.md) - Docker for packages
- [`dependency-migrations`](../dependency-migrations/SKILL.md) - coordinated bumps

**GitHub:** https://github.com/bh611627/skillcodex/tree/main/skills/monorepo-tooling/SKILL.md  
**npm:** https://www.npmjs.com/package/@skillcodex/skills