mcpField
A
arch-tsdown-monorepo

arch-tsdown-monorepo

github.com/hairyfDevelopment26582 installsUpdated 2w ago
Repository

About arch-tsdown-monorepo

A skill describing a pnpm monorepo starter for TypeScript libraries, with tsdown builds and shared development tooling. It documents workspace structure, testing, CI, package exports, and release practices.

Key features

  1. 01Uses pnpm catalogs and workspace dependencies
  2. 02Builds packages with tsdown
  3. 03Shares ESLint, Vitest, and TypeScript tooling
  4. 04Documents CI and release workflows
  5. 05Includes package export snapshots and add-package guidance

Use cases

  1. 01Starting a TypeScript library monorepo
  2. 02Adding packages to a pnpm workspace
  3. 03Setting up shared tests and type checks
  4. 04Preparing CI-based npm releases

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hairyf/skills --skill arch-tsdown-monorepo

After installing, type/arch-tsdown-monorepoin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

GENERATION.md
assets/
ci.yml
release.yml
references/
best-practices-monorepo.md
core-ci.md
core-git-hooks.md
core-overview.md
core-package-exports.md
core-packages.md
core-release.md
core-scripts.md
core-testing.md
core-tooling.md
core-tsdown-per-package.md
core-workspace.md
features-add-package.md
features-exports-snapshot.md

Details

From the project README

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

TopicDescriptionReference
OverviewMonorepo purpose, structure, when to usecore-overview
Workspacepnpm workspace, catalogs, workspace:* depscore-workspace
PackagesPackage layout, exports, inter-package depscore-packages
Package ExportsDual exports (dev vs publish), main/module/types, files, sideEffectscore-package-exports
tsdown (per package)entry, dts, exports, publintcore-tsdown-per-package
ScriptsRoot and package scripts — build, dev, typecheck, test, releasecore-scripts
TestingVitest projects — root + packages/*core-testing
ToolingESLint, TypeScript, .gitignore, .vscodecore-tooling
CIGitHub Actions — lint, typecheck, test matrixcore-ci
Releasenpm Trusted Publisher, bumpp, release workflowcore-release
Git Hookssimple-git-hooks, lint-staged, pre-commitcore-git-hooks

Features

TopicDescriptionReference
Exports SnapshotPer-package export snapshot tests (vitest-package-exports, runIf(IS_READY))features-exports-snapshot
Add PackageStep-by-step adding a new workspace packagefeatures-add-package

Best Practices

TopicDescriptionReference
MonorepoCatalogs, workspace deps, release, build orderbest-practices-monorepo

Comments

Markdown supported