create-rolldown 🔧

⚡️ Scaffolding tool for Rolldown library projects - a fast JavaScript bundler written in Rust, with TypeScript support and multiple framework templates

[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![bundle][bundle-src]][bundle-href]
[![License][license-src]][license-href]

Features

- 🚀 Fast Setup - Create a new Rolldown project in seconds
- 🎨 TypeScript First - All templates use TypeScript by default
- 📦 Library Development Focus - Templates designed for building and publishing JavaScript/TypeScript libraries, component libraries, and utility packages
- 🎮 Playground Included - Framework templates include a Vite-powered playground for development and testing
- 🔧 Interactive & Non-Interactive Modes - Flexible usage for both manual and automated workflows
- 📦 Smart Package Manager Detection - Automatically detects and uses your preferred package manager (npm, pnpm, yarn, bun)
- ⚡ Immediate Start - Optional flag to install dependencies and start playground immediately

Installation

``bash
npm create rolldown@latest


or

pnpm create rolldown

or

yarn create rolldown

or

bun create rolldown
`

Quick Start

$3

Simply run the command and follow the prompts:

`bash
npm create rolldown@latest
`

You'll be prompted to:

1. Enter a project name
2. Choose a framework (Vanilla, React, Vue, Solid, or Svelte)
3. Optionally install dependencies and start the playground immediately

$3

For automated workflows or CI/CD pipelines:

`bash


Create a project with all options specified

npm create rolldown@latest my-lib -- --template react --no-interactive

With immediate install and start

npm create rolldown@latest my-lib -- --template vue --immediate --no-interactive

Overwrite existing directory

npm create rolldown@latest my-lib -- --template solid --overwrite --no-interactive
`

Supported Templates

| Template | Description | Use Cases | Playground |
| --------- | -------------------------------- | ---------------------------------- | ---------- |
| vanilla | Vanilla TypeScript library | Utility libraries, tools, helpers | ❌ |
| react | React library with TypeScript | React components, hooks, utilities | ✅ Vite |
| vue | Vue 3 library with TypeScript | Vue components, composables | ✅ Vite |
| solid | SolidJS library with TypeScript | Solid components, primitives | ✅ Vite |
| svelte | Svelte 5 library with TypeScript | Svelte components, actions | ✅ Vite |

Command Line Options

`
Usage: create-rolldown [project-name] [options]

Options:
-t, --template