⚡ Vite-Spark

Lightning-fast Full-Stack project generator — Frontend + Backend in seconds!


> Vite Spark is a zero-config CLI that scaffolds production-ready React frontends and Node.js backends with authentication, TypeScript/JavaScript support, and optional Tailwind CSS — all in one command.

---

✨ Features

- ⚡ Blazing Fast — Built on Vite for instant HMR and optimized builds
- 🌐 Full-Stack Support — Create frontend, backend, or both together
- 🎯 Production-Ready Templates — Minimal or auth-ready setups
- 🔷 TypeScript or JavaScript — Full support for both
- 🎨 Optional Tailwind CSS — Integrated and configured automatically
- 🔐 Secure Authentication — HttpOnly cookies, JWT, bcrypt, RBAC
- 🔧 Node.js Backend — Express + MongoDB with middleware & error handling
- 📦 Monorepo Support — Run frontend + backend with one command
- 📝 Smart Git Integration — Initialize in root or separate folders
- 🎭 Non-Interactive by Default — Fast defaults, interactive when needed
- 🛡️ Safe Overwrites — Always prompts before replacing existing files

---

🚀 Quick Start

$3

``bash

Frontend only (default)

npx vite-spark my-app

Full-stack (frontend + backend)

npx vite-spark my-app --with-backend

Backend only

npx vite-spark my-api --backend-only

Interactive mode (asks questions)

npx vite-spark -q

TypeScript full-stack with Tailwind

npx vite-spark my-saas --with-backend -l ts --twd -i
`

$3

`bash

Install once

npm install -g vite-spark

Use anywhere

vite-spark my-app
vite-spark my-api --backend-only
vite-spark my-project --with-backend
`

---

📋 What Can You Create?

$3

`bash
npx vite-spark my-app
`

Creates:
`
my-app/
├── src/
│ ├── context/ # Auth & Theme contexts
│ ├── App.jsx
│ └── main.jsx
├── package.json
└── vite.config.js
`

---

$3

`bash
npx vite-spark my-api --backend-only
`

Creates:
`
my-api/
├── Controllers/ # Admin, Auth, Factory, Error, User
├── Models/ # User model with soft-delete
├── Routes/ # Auth & Admin routes
├── Utils/ # APIFeatures, AppError, CatchAsync, etc.
├── plugins/ # Soft-delete plugin
├── App.js
└── config.js
`

Backend Features:
- ✅ Express.js + MongoDB + Mongoose
- ✅ JWT authentication with HttpOnly cookies
- ✅ Role-Based Access Control (Admin/User)
- ✅ Soft-delete functionality
- ✅ Factory pattern CRUD operations
- ✅ Email service (Nodemailer)
- ✅ File upload (Multer)
- ✅ Security (Helmet, Rate limiting, CORS)
- ✅ Error handling middleware

---

$3

`bash
npx vite-spark my-project --with-backend
`

Creates:
`
my-project/
├── frontend/ # React app
├── backend/ # Node.js API
├── package.json # Root (monorepo scripts)
└── README.md # Setup instructions
`

Monorepo Features:
- ✅ Run both servers with npm run dev
- ✅ Install all deps with npm run install:all
- ✅ Shared Git repository (optional)
- ✅ Coordinated development workflow

---

🎨 CLI Options

$3

`bash

Frontend with TypeScript + Tailwind

npx vite-spark my-app -l ts --twd -i

Backend only

npx vite-spark my-api --backend-only -i

Full-stack with everything

npx vite-spark my-saas --with-backend -l ts --twd -i

Interactive mode

npx vite-spark -q

Minimal (just files)

npx vite-spark my-app -n
`

$3

#### Project Type
| Flag | Description | Example |
|------|-------------|---------|
| --with-backend | Create full-stack (frontend + backend) | --with-backend |
| --backend-only | Create backend only | --backend-only |
| (none) | Frontend only (default) | - |

#### Frontend Options
| Flag | Description | Default | Example |
|------|-------------|---------|---------|
| -l, --lang | Language (JavaScript/TypeScript) | js | -l ts |
| -t, --template | Template preset | Auth | -t basic |
| --twd, --tailwind | Add Tailwind CSS | false | --twd |

#### Backend Options
| Flag | Description | Default | Example |
|------|-------------|---------|---------|
| -b, --backend-template