---
id: hairyf/skills/arch-tsdown
version: "c3705c54"
license: MIT
install: manual
updated: 2026-06-10
---

# arch-tsdown — Set up a modern TypeScript library project using tsdown, a streamlined build tool for ESM packages. This skill automates project scaffolding with sensible defaults, letting you focus on writing code rather than configuration. Perfect for developers building reusable TypeScript modules.

Publisher: hairyf · Stars: 24 · Updated: 2026-06-10

Install (manual): `git clone https://github.com/hairyf/skills`

## SKILL.md

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) |


[View on SkillFed](https://skillfed.io/hairyf/skills/arch-tsdown) · [View on GitHub](https://github.com/hairyf/skills)