Registry / devops / create-butterfly-app-v2

create-butterfly-app-v2

library2.1.4jsnpmunverified

A CLI tool that scaffolds full-stack boilerplate projects using Node.js + React + Tailwind + MySQL. Current version 2.1.4. It provides interactive project creation with three templates (Hotel, Parking, Student Management), JWT authentication, full CRUD, auto-database creation, and seeded sample data. Differentiators include an all-in-one setup with no manual SQL, protected/guest routes, and a random project picker. Primarily for educational or rapid prototyping purposes.

devops

npm install create-butterfly-app-v2

package ↗

INSTALL

IMPORT

SIG · CREATE-BUTTERFLY-A

create-butterfly-app-v2

devopsjavascriptv2.1.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

create-butterfly-app-v2

✓ npx create-butterfly-app-v2

✗ npm install -g create-butterfly-app-v2 && create-butterfly-app-v2

Use npx to avoid global install. The CLI will prompt for project type and name.

Scaffolds a full-stack project with interactive prompts for template selection and project name.

npx create-butterfly-app-v2

Debug

Known issues

gotchaRequires MySQL server running (e.g., XAMPP) with default credentials (root, no password).

fix

Start XAMPP or your MySQL service before running the dev server.

affects: >=2.0.0

gotchaThe CLI will generate a new directory; do not run inside an existing project folder unless you intend to overwrite.

fix

Run npx create-butterfly-app-v2 in an empty directory or a parent directory where a new folder can be created.

affects: >=2.0.0

gotchaThe auto-generated database name may conflict with existing databases if not unique.

fix

Check MySQL for existing databases with similar names before running, or manually edit backend/db/schema.sql.

affects: >=2.0.0

gotchaHot reload may not work if edits are made outside the src directory structure.

fix

Ensure you modify files inside the project's src/ and backend/ directories for Vite hot reload to apply.

affects: >=2.0.0

Errors

Common errors & fixes

Error: connect ECONNREFUSED 127.0.0.1:3306

MySQL server is not running or not accessible at localhost:3306.

fix

Start your MySQL service (e.g., via XAMPP) and ensure it's listening on the default port.

ERR_PNPM_RECURSIVE_RUN_FIRST_FAILED Command failed with exit code 1

Missing dependencies or conflicting versions in the generated project.

fix

Delete the generated project folder and rerun npx create-butterfly-app-v2, ensuring you have Node >=14 and npm >=6.

Error: Cannot find module 'react-router-dom'

Dependencies not installed properly due to network issues during scaffold.

fix

Run npm install inside the generated project folder before starting the dev server.

Upgrade

Version history

2.1.4latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

12 hits · last 30 days

node

Resources

packagecreate-butterfly-app-v2 ↗