About arch-tsdown
arch-tsdown is a TypeScript library starter and guidance skill based on starter-ts, for developers setting up and releasing packages with tsdown. It documents an ESM-focused build and testing toolchain.
Key features
- 01tsdown build configuration
- 02Automatic .d.ts generation
- 03pnpm workspace setup
- 04Vitest and ESLint tooling
- 05CI and release guidance
Use cases
- 01Starting a TypeScript library
- 02Configuring package exports and types
- 03Setting up tests and CI releases
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ hairyf/ skills --skill arch-tsdownAfter installing, type/arch-tsdownin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
GENERATION.mdassets/ci.ymlrelease.ymlreferences/best-practices-tsdown.mdcore-ci.mdcore-git-hooks.mdcore-overview.mdcore-package-exports.mdcore-pnpm-workspace.mdcore-release.mdcore-scripts.mdcore-testing.mdcore-tooling.mdcore-tsdown-config.mdDetails
From the project READMEarch-tsdown is a TypeScript library starter (based on antfu/starter-ts) that uses tsdown for building. It provides a minimal, opinionated setup: ESM-only output, automatic .d.ts generation, pnpm, Vitest, ESLint, and optional npm Trusted Publisher for CI-based releases.
The skill is based on starter-ts (arch-tsdown source), generated at 2026-01-30.
Recommended practices:
- Build pure ESM; enable
dtsandexportsin tsdown config - Use npm Trusted Publisher for releases
- Run publint (via tsdown’s
publint: true) before publishing
Core References
| Topic | Description | Reference |
|---|---|---|
| Overview | Project purpose, structure, when to use | core-overview |
| tsdown Config | entry, dts, exports, publint | core-tsdown-config |
| Scripts & Release | build, dev, start, release, npm Trusted Publisher | core-scripts |
| Package Exports | dist output, types, exports, sideEffects | core-package-exports |
| pnpm Workspace | catalogs, version management, workspace | core-pnpm-workspace |
| Tooling | ESLint, TypeScript, Vitest config | core-tooling |
| Git Hooks | simple-git-hooks, lint-staged, pre-commit | core-git-hooks |
| CI | GitHub Actions — lint, typecheck, test matrix | core-ci |
| Release | Tag push, sxzz/workflows, npm Trusted Publisher | core-release |
| Testing | Vitest, vitest-package-exports, export snapshots | core-testing |
Best Practices
| Topic | Description | Reference |
|---|---|---|
| tsdown & Package | ESM, dts, exports, tooling alignment | best-practices-tsdown |
Comments
Markdown supported