Tailwind-Init CLI πŸš€πŸŽ¨

October 1, 2025 Β· View on GitHub

NPM Version License Downloads

Tailwind-Init CLI is a blazing-fast 🏎️ one-command setup tool for Tailwind CSS in Angular, React, or Next.js projects!
No more manual installs or editing CSS filesβ€”Tailwind-Init automates everything 🎯 so you can focus on designing stunning UIs 🌈✨.


🌟 Features

  • ⚑ One-command setup for Angular, React, Next.js
  • πŸ“¦ Automatically installs dependencies:
    • tailwindcss
    • postcss
    • autoprefixer
    • @tailwindcss/postcss (Angular / Next.js)
  • πŸ“ Generates PostCSS config files:
    • Angular β†’ .postcssrc.json
    • React β†’ postcss.config.cjs
    • Next.js β†’ postcss.config.mjs
  • 🎨 Prepends Tailwind CSS imports to main CSS (styles.css, index.css, globals.css) without removing existing content
  • ❌ Throws errors for unsupported frameworks
  • πŸ”§ Supports --force to overwrite PostCSS config files

πŸ’Ύ Installation

Global Install

npm install tailwind-init-cli

Run via npx (no install needed)

npx tailwind-init

πŸ›  Usage

FrameworkCommandDescription
Angular (default)tailwind-initSets up Tailwind in Angular project
Reacttailwind-init --reactSets up Tailwind in React (CRA / Vite)
Next.jstailwind-init --nextjsSets up Tailwind in Next.js (App Router)

Overwrite PostCSS Config

tailwind-init --react --force

πŸ“‚ PostCSS Config Details

FrameworkFile NameFormat
Angular.postcssrc.jsonJSON
Reactpostcss.config.cjsCommonJS
Next.jspostcss.config.mjsES Module

🎯 Why Tailwind-Init?

Tailwind-Init saves you minutes of setup, prevents errors, and ensures Tailwind CSS is correctly configured.
Perfect for fast prototyping, personal projects, or team projects. πŸŽ¨πŸ’»


πŸ”₯ Quick Start Example

# Angular (default)
tailwind-init

# React
tailwind-init --react

# Next.js
tailwind-init --nextjs

🀝 Contributing

Contributions are welcome! Open an issue or submit a pull request.
Let's make Tailwind-Init even faster, smarter, and more fun! πŸŽ‰βœ¨


πŸ“œ License

MIT License Β© 2025 Arian Esmaeilzadeh


πŸ’₯ Tailwind-Init CLI = Fast ⚑ + Fun 🎨 + Productive πŸš€. Start building beautiful interfaces in seconds! 🌈✨