██████╗  ██████╗ ██╗██╗     ███████╗██████╗ 
      ██╔══██╗██╔═══██╗██║██║     ██╔════╝██╔══██╗
      ██████╔╝██║   ██║██║██║     █████╗  ██████╔╝
      ██╔══██╗██║   ██║██║██║     ██╔══╝  ██╔══██╗
      ██████╔╝╚██████╔╝██║███████╗███████╗██║  ██║
      ╚═════╝  ╚═════╝ ╚═╝╚══════╝╚══════╝╚═╝  ╚═╝

Boiler

A lightning-fast CLI tool for kickstarting projects

Installation • Usage • Templates • Features • Contributing

✨ Highlights

• 🎨 Beautiful UI — Sleek animations, shimmer effects & modern design
• ⚡ Lightning Fast — Scaffold projects in seconds
• 📦 Curated Templates — Handpicked production-ready boilerplates
• 🛠️ Dev Tools — ESLint, Prettier, Husky pre-configured
• 🔧 Zero Config — Auto git init & dependency installation
• 🌐 Universal — Works with npm, yarn, pnpm, bun & deno

📦 Installation

Using npm

# Install globally
npm install -g @mugunth140/boiler

# Or run directly with npx
npx @mugunth140/boiler

Using yarn

# Install globally
yarn global add @mugunth140/boiler

# Or run directly
yarn dlx @mugunth140/boiler

Using pnpm

# Install globally
pnpm add -g @mugunth140/boiler

# Or run directly
pnpm dlx @mugunth140/boiler

Using bun

# Install globally
bun add -g @mugunth140/boiler

# Or run directly
bunx @mugunth140/boiler

Using deno

# Run directly
deno run -A npm:@mugunth140/boiler

🚀 Usage

Simply run the command and follow the interactive prompts:

boiler

Interactive Flow

1. Select template    →  Choose from curated boilerplates
2. Name your project  →  Enter project name (or "." for current dir)
3. Add features       →  Select optional dev tools
4. Auto setup         →  Git init + dependency install

Quick Start Example

$ boiler

      ██████╗  ██████╗ ██╗██╗     ███████╗██████╗ 
      ██╔══██╗██╔═══██╗██║██║     ██╔════╝██╔══██╗
      ██████╔╝██║   ██║██║██║     █████╗  ██████╔╝
      ██╔══██╗██║   ██║██║██║     ██╔══╝  ██╔══██╗
      ██████╔╝╚██████╔╝██║███████╗███████╗██║  ██║
      ╚═════╝  ╚═════╝ ╚═╝╚══════╝╚══════╝╚═╝  ╚═╝

   A lightning-fast CLI tool for kickstarting projects

   › Select template
   › express-typescript

   › Project name
   › my-awesome-api

   📦 Add features
   › ESLint, Prettier

   🚀 Setting up...
   ✓ Repository cloned successfully!
   ✓ Git initialized!
   ✓ Dependencies installed!
   ✓ Features configured!

   ✨ Project ready!

   cd my-awesome-api
   npm run dev

📋 Templates

React / Next.js

| Template | Description | |:---------|:------------| | next-enterprise | Enterprise-grade Next.js with TypeScript, Tailwind, testing, CI/CD | | nextjs-starter | Next.js 14+ with App Router, TypeScript, ESLint, Prettier, Tailwind | | bulletproof-react | Scalable and powerful React application architecture | | create-t3-app | Full-stack typesafe Next.js with tRPC, Prisma, and more | | taxonomy | Next.js 13 app with Radix UI, Tailwind, and shadcn/ui |

Vue / Nuxt

| Template | Description | |:---------|:------------| | vitesse | Vite + Vue starter with file-based routing, UnoCSS, and SSG | | vue-vben-admin | Vue 3 admin template with TypeScript, Vite, Pinia, Ant Design | | nuxt3-starter | Nuxt 3 with Tailwind, HeadlessUI, and ESLint |

Node.js / Backend

| Template | Description | |:---------|:------------| | express-typescript | Express TypeScript 2025 – production-ready backend starter | | nestjs-boilerplate | NestJS with Auth, TypeORM, Postgres, MongoDB, Docker, I18N | | node-typescript | Minimalistic Node.js TypeScript with ESLint and Vitest | | fastify-starter | Fastify DX full-stack with Vue, React, and Solid support |

Mobile

| Template | Description | |:---------|:------------| | react-native-obytes | Expo, TypeScript, TailwindCSS, Husky, EAS, GitHub Actions | | ignite | Infinite Red's battle-tested React Native with MobX-State-Tree |

Full Stack / SaaS

| Template | Description | |:---------|:------------| | saas-starter | Next.js SaaS starter with authentication and billing |

Desktop

| Template | Description | |:---------|:------------| | electron-vite | Next-gen Electron build tooling with Vite | | electron-react | Electron + React + Redux + Hot Reloading |

Python

| Template | Description | |:---------|:------------| | fastapi-template | Full stack FastAPI with PostgreSQL, Docker, React frontend | | django-cookiecutter | Production-ready Django with Docker and Celery |

Go

| Template | Description | |:---------|:------------| | go-clean-arch | Go Clean Architecture with REST API |

Other Frameworks

| Template | Description | |:---------|:------------| | turborepo-starter | High-performance monorepo build system from Vercel | | astro-starter | Web framework for content-driven websites | | sveltekit-starter | SvelteKit with SSR, routing, and more | | typescript-cli | CLI helper library for Node.js |

💡 Want to add your own template? Contribute to the repo!

🛠️ Features

Optional development tools you can add to any project:

| Feature | Description | |:--------|:------------| | .env | Environment variables template | | .gitignore | Comprehensive ignore patterns | | ESLint ★ | JavaScript/TypeScript linting | | Prettier ★ | Code formatting | | Husky | Git hooks + lint-staged |

★ Recommended for all projects

🔧 Requirements

• Node.js 18.0.0 or higher
• Git installed and accessible from command line
• Package Manager — npm, yarn, pnpm, bun, or deno

🤝 Contributing

Contributions are welcome! Here's how you can help:

Adding a Template

1. Fork the repository
2. Add your template to data.js:

{
  id: 7,
  name: "your-template-name",
  url: "https://github.com/username/repo.git",
  category: "category",
  description: "Short description of your template"
}

3. Submit a Pull Request

Development

# Clone the repo
git clone https://github.com/mugunth140/boiler-cli.git
cd boiler-cli

# Install dependencies
npm install

# Run locally
npm run dev

📄 License

MIT © Mugunth

Made with ♥ by Mugunth

GitHub • npm