corp-v1-3darch-skills-code-agent/development-monorepo-pnpm-3darch

Files

T

root-at-skicandClaude Opus 5 ff69bcca2f development-monorepo-pnpm skill: initial import

Full-stack pnpm + Turborepo monorepo skill, independent of the separate
backend and frontend monorepo skills it draws on.

Repository shape is split four ways at the top level: applications-backend,
applications-frontend, packages-backend, packages-frontend — so a path
states which runtime a file ends up in.

Defaults: NestJS for backend services, React with IBM Carbon Design for
browser applications; the project's stated architecture overrides both.

Covers workspace globs, the Turborepo pipeline, filtered validation,
blast-radius checks, Module Federation, turbo prune image builds, and Helm.
Documents one sanctioned cross-boundary dependency: API contract types owned
by the backend, imported type-only by the frontend.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-12 23:49:02 +03:00

2.1 KiB

Raw Permalink Blame History

example-shared-package — `@ca/example-utils`

Complete minimal shared TypeScript package for a pnpm + Turborepo monorepo. Copy it as the starting point for a new package and rename the scope to match your repository.

It goes under packages-backend/ or packages-frontend/ depending on who consumes it — the root matches the consumers, never the author. See references/packages.md §1.

The package itself is environment-neutral: no Node built-ins, no DOM APIs. That is what makes it a safe template for either root. Adding fs, path, or crypto makes it backend-only; adding DOM APIs makes it frontend-only.

Structure

packages-backend/example-utils/        # or packages-frontend/example-utils/
├── .eslintrc.cjs
├── package.json
├── tsconfig.json
└── src/
    ├── index.ts           # Public barrel — re-exports types and utils
    ├── types.ts           # Shared TypeScript types
    └── example-utils.ts   # Utility functions

Key conventions

"type": "module" with ESM output under dist/.
exports maps the package root to dist/index.js and dist/index.d.ts.
tsconfig.json extends the shared typescript-config preset — only outDir and rootDir are local.
.eslintrc.cjs extends the shared eslint-config preset.
Internal imports carry the .js extension — required for ESM TypeScript.
files: ["dist"] keeps sources out of the published payload.
Workspace dependencies use workspace:*.
src/index.ts is the entire public API; nothing else is importable by consumers.
Script names (build, check-types, lint) match the tasks in turbo.json, or Turborepo skips the workspace silently.

Contract packages

A package that shares API types across the front/back boundary is a variant of this template: name it <domain>-contracts, place it under packages-backend/, export types only, and keep it free of runtime dependencies. Frontend consumers import it with import type.

Validation commands

pnpm check-types --filter="@ca/example-utils"
pnpm lint        --filter="@ca/example-utils"
pnpm build       --filter="@ca/example-utils"

2.1 KiB Raw Permalink Blame History

example-shared-package — @ca/example-utils