---

name: arch-tsdown-monorepo description: pnpm monorepo starter for TypeScript libraries with tsdown per package. Use when scaffolding or maintaining a multi-package TS/ESM repo with workspace deps and npm Trusted Publisher. metadata: author: hairy version: "2026.2.2" source: Generated from https://github.com/hairyf/starter-monorepo, scripts located at https://github.com/antfu/skills

arch-tsdown-monorepo is a pnpm monorepo starter for TypeScript libraries (based on hairyf/starter-monorepo). Each package uses tsdown for building. It provides shared tooling (ESLint, Vitest, TypeScript), pnpm catalogs for versions, workspace dependencies, and optional npm Trusted Publisher for CI-based releases.

The skill is based on hairyf/starter-monorepo, generated at 2026-02-02.

Recommended practices:

• Use pnpm catalogs for devDependency versions; reference with catalog:cli, catalog:testing, etc.
• Use workspace:* for inter-package dependencies; publish once manually, then use npm Trusted Publisher for CI releases.
• Run build/typecheck/test from root with pnpm -r run ... and a single Vitest config with projects (root + packages/*).

Core References

| Topic | Description | Reference | |-------|-------------|-----------| | Overview | Monorepo purpose, structure, when to use | core-overview | | Workspace | pnpm workspace, catalogs, workspace:* deps | core-workspace | | Packages | Package layout, exports, inter-package deps | core-packages | | Package Exports | Dual exports (dev vs publish), main/module/types, files, sideEffects | core-package-exports | | tsdown (per package) | entry, dts, exports, publint | core-tsdown-per-package | | Scripts | Root and package scripts — build, dev, typecheck, test, release | core-scripts | | Testing | Vitest projects — root + packages/* | core-testing | | Tooling | ESLint, TypeScript, .gitignore, .vscode | core-tooling | | CI | GitHub Actions — lint, typecheck, test matrix | core-ci | | Release | npm Trusted Publisher, bumpp, release workflow | core-release | | Git Hooks | simple-git-hooks, lint-staged, pre-commit | core-git-hooks |

Features

| Topic | Description | Reference | |-------|-------------|-----------| | Exports Snapshot | Per-package export snapshot tests (vitest-package-exports, runIf(IS_READY)) | features-exports-snapshot | | Add Package | Step-by-step adding a new workspace package | features-add-package |

Best Practices

| Topic | Description | Reference | |-------|-------------|-----------| | Monorepo | Catalogs, workspace deps, release, build order | best-practices-monorepo |