Pulled ALL skills from 15 source repositories: - anthropics/skills: 16 (docs, design, MCP, testing) - obra/superpowers: 14 (TDD, debugging, agents, planning) - coreyhaines31/marketingskills: 25 (marketing, CRO, SEO, growth) - better-auth/skills: 5 (auth patterns) - vercel-labs/agent-skills: 5 (React, design, Vercel) - antfu/skills: 16 (Vue, Vite, Vitest, pnpm, Turborepo) - Plus 13 individual skills from various repos Mosaic Stack is not limited to coding — the Orchestrator and subagents serve coding, business, design, marketing, writing, logistics, analysis, and more. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2.6 KiB
2.6 KiB
Getting Started
Quick guide to installing and using tsdown for the first time.
Installation
Install tsdown as a development dependency:
pnpm add -D tsdown
# Optionally install TypeScript if not using isolatedDeclarations
pnpm add -D typescript
Requirements:
- Node.js 20.19 or higher
- Experimental support for Deno and Bun
Quick Start Templates
Use create-tsdown CLI for instant setup:
pnpm create tsdown@latest
Provides templates for:
- Pure TypeScript libraries
- React component libraries
- Vue component libraries
- Ready-to-use configurations
First Bundle
1. Create Source Files
// src/index.ts
import { hello } from './hello.ts'
hello()
// src/hello.ts
export function hello() {
console.log('Hello tsdown!')
}
2. Create Config File
// tsdown.config.ts
import { defineConfig } from 'tsdown'
export default defineConfig({
entry: ['./src/index.ts'],
})
3. Run Build
./node_modules/.bin/tsdown
Output: dist/index.mjs
4. Test Output
node dist/index.mjs
# Output: Hello tsdown!
Add to npm Scripts
{
"scripts": {
"build": "tsdown"
}
}
Run with:
pnpm build
CLI Commands
# Check version
tsdown --version
# View help
tsdown --help
# Build with watch mode
tsdown --watch
# Build with specific format
tsdown --format esm,cjs
# Generate type declarations
tsdown --dts
Basic Configurations
TypeScript Library (ESM + CJS)
export default defineConfig({
entry: ['src/index.ts'],
format: ['esm', 'cjs'],
dts: true,
clean: true,
})
Browser Library (IIFE)
export default defineConfig({
entry: ['src/index.ts'],
format: ['iife'],
globalName: 'MyLib',
platform: 'browser',
minify: true,
})
Multiple Entry Points
export default defineConfig({
entry: {
index: 'src/index.ts',
utils: 'src/utils.ts',
cli: 'src/cli.ts',
},
format: ['esm', 'cjs'],
dts: true,
})
Using Plugins
Add Rolldown, Rollup, or Unplugin plugins:
import SomePlugin from 'some-plugin'
export default defineConfig({
entry: ['src/index.ts'],
plugins: [SomePlugin()],
})
Watch Mode
Enable automatic rebuilds on file changes:
tsdown --watch
# or
tsdown -w
Next Steps
- Configure entry points with glob patterns
- Set up multiple output formats
- Enable type declaration generation
- Explore plugins for extended functionality
- Read migration guide if coming from tsup