create-bundler

0.4.8 verified Sat Apr 25 auth: no javascript

A scaffolding tool that creates pre-configured projects with zero-config support for ES6+, TypeScript, Less/Sass/CSS Modules, Tailwind CSS, file-system routing, and bundling for web and plugins. Current stable version is 0.4.8. It simplifies project initialization by providing an out-of-the-box build setup, similar to create-react-app but more opinionated for Chinese developers (Chinese documentation). Primarily used via pnpm.

Common errors

error Error: Cannot find module 'create-bundler' ↓

cause Running npm create bundler instead of pnpm create bundler.

fix

Use pnpm create bundler or install globally: pnpm add -g create-bundler then run create-bundler

error SyntaxError: Unexpected token 'export' ↓

cause Using require() on an ESM-only package.

fix

Change to import syntax or downgrade to version <0.4.0.

error ERR! pnpm create bundler failed: spawn pnpm ENOENT ↓

cause pnpm is not installed or not in PATH.

fix

Install pnpm: npm install -g pnpm

error TypeError: createBundler is not a function ↓

cause Using wrong import or call signature.

fix

Check the documentation: import { createBundler } from 'create-bundler' and call it correctly.

Warnings

gotcha Requires pnpm as the package manager. npm or yarn may not work correctly. ↓

fix Install pnpm globally: npm install -g pnpm

breaking ESM-only since version 0.4.0. CommonJS require will fail. ↓

fix Use import syntax. If using CommonJS, stick to version <0.4.0.

deprecated Legacy API (if any) removed in v0.4.0. ↓

fix Update imports to match the new API.

gotcha Chinese-only documentation. English users may find it hard to troubleshoot. ↓

fix Consider using a translation tool or alternative scaffolding tool like create-vite.

Install

npm install create-bundler

yarn add create-bundler

pnpm add create-bundler

Imports

create-bundler
wrong
```
npm create bundler
```
correct
```
pnpm create bundler
```
The tool is designed to be run via pnpm create, not npm or yarn. Using npm create may fail or install a different package.
project structure
wrong
```
cd <project-name> && npm start
```
correct
```
cd <project-name> && pnpm install && pnpm start
```
After scaffolding, use pnpm to install dependencies and start the dev server, not npm.

bundler API

wrong

const createBundler = require('create-bundler');

correct

import { createBundler } from 'create-bundler';

The package is ESM-only since v0.4.0. CommonJS require will not work.

Quickstart

Scaffold a new project with create-bundler, install dependencies, and start the development server.

# Ensure pnpm is installed: npm install -g pnpm
pnpm create bundler my-project
cd my-project
pnpm install
pnpm start
# Dev server at http://localhost:3000