# Arch Tsdown

> TypeScript library starter using tsdown. Use when scaffolding or maintaining a TS/ESM library with tsdown, pnpm, Vitest, and npm Trusted Publisher.

- Skill: `hairyf-skills/arch-tsdown` (Agent Skill, multi-file: 15 files)
- Install (CLI): `npx skillmds@latest add hairyf-skills/arch-tsdown`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hairyf-skills/arch-tsdown/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hairyf (https://skillmd.com/u/hairyf-skills)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/hairyf-skills/arch-tsdown

---


arch-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 `dts` and `exports` in 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](references/core-overview.md) |
| tsdown Config | entry, dts, exports, publint | [core-tsdown-config](references/core-tsdown-config.md) |
| Scripts & Release | build, dev, start, release, npm Trusted Publisher | [core-scripts](references/core-scripts.md) |
| Package Exports | dist output, types, exports, sideEffects | [core-package-exports](references/core-package-exports.md) |
| pnpm Workspace | catalogs, version management, workspace | [core-pnpm-workspace](references/core-pnpm-workspace.md) |
| Tooling | ESLint, TypeScript, Vitest config | [core-tooling](references/core-tooling.md) |
| Git Hooks | simple-git-hooks, lint-staged, pre-commit | [core-git-hooks](references/core-git-hooks.md) |
| CI | GitHub Actions — lint, typecheck, test matrix | [core-ci](references/core-ci.md) |
| Release | Tag push, sxzz/workflows, npm Trusted Publisher | [core-release](references/core-release.md) |
| Testing | Vitest, vitest-package-exports, export snapshots | [core-testing](references/core-testing.md) |

## Best Practices

| Topic | Description | Reference |
|-------|-------------|-----------|
| tsdown & Package | ESM, dts, exports, tooling alignment | [best-practices-tsdown](references/best-practices-tsdown.md) |