sr_setup-cli

Simple React CLI

🎉 Thank you for using Simple React CLI! 🎉

   __________  ______  __   ____  ___  _______  ___________  _______   ____
  / __/  _/  |/  / _ \/ /  / __/ / _ \/ __/ _ |/ ___/_  __/ / ___/ /  /  _/
 _\ \_/ // /|_/ / ___/ /__/ _/  / , _/ _// __ / /__  / /   / /__/ /___/ /  
/___/___/_/  /_/_/  /____/___/ /_/|_/___/_/ |_\___/ /_/    \___/____/___/  
                                                                           

A modern CLI tool for creating React projects with multiple frameworks (Vite, Next.js, Remix, Gatsby), Tailwind CSS v4, optional libraries, and a clean setup. Perfect for developers who want to skip boilerplate and start coding immediately! Supports both English and Russian interfaces.

⚠️ Note: This CLI may contain some bugs and issues. Subsequent patches will address and fix all identified problems. If you encounter any issues, please report them for faster resolution.

Changelog

v2.8.10 (2025-10-03) - Enhanced User Experience & Visual Improvements

🎨 Visual & UX Enhancements:

• Consistent Progress Display: All presets (Minimal, Full, Testing, Custom) now show detailed installation progress
• Enhanced Status Messages: Added clear status message for React installation with consistent green styling
• Restored Version Check Indicator: Orange "Checking for updates..." message restored for better UX
• Improved Preset Information: Minimal preset now shows informative message about included dependencies
• Better Testing Preset: Fixed @testing-library/react placement and added @testing-library/jest-dom

🔧 Technical Improvements:

• Universal Progress Reporting: All installation types now use the same detailed progress system
• Fixed Vitest Configuration: Proper vite.config.js updates with test configuration
• Improved Commitlint Setup: Updated to use modern Husky syntax (no more deprecated commands)
• Consistent Color Coding: All success messages now use uniform green styling

📊 Enhanced Progress Examples:

Checking for updates...
✔ Project scaffolded successfully
✔ Dependencies installed
✔ React installed
✔ Tailwind CSS v4 installed

📦 Installing 2 libraries (Testing preset):
✔ [1/2] ✅ @testing-library/react installed (2.8s)
✔ [2/2] ✅ @testing-library/jest-dom installed (4.2s)
📊 Library installation summary: ✅ 2 successful, ❌ 0 errors

🔧 Setting up 5 development tools...
✔ [1/5] ✅ eslint configured (15.0s)
✔ [5/5] ✅ lint-staged configured (5.1s)
📊 Tools installation summary: ✅ 5/5 ⏱️ Total time: 36.8s

Installation

Quick Install:

npm i -g sr_setup-cli

Alternative methods:

# Global installation (recommended)
npm install -g sr_setup-cli

# Or run without installing
npx sr_setup-cli

Usage

Simply run the CLI:

sr_setup-cli

You'll see an interactive menu where you can choose:

• 🚀 Start project setup - Begin interactive installation
• 📦 Show version - Display CLI version
• ❓ Show help - View detailed help information
• 🚪 Exit - Close the CLI

Navigate with arrow keys (↑/↓) and press Enter to select.

After selecting "Start project setup", follow the interactive prompts to configure your project:

• Choose CLI language: English or Russian
• Enter project name
• Enter app title (for browser tab)
• Choose framework: React (Vite), Next.js, Remix, or Gatsby
• Choose installation preset: Minimal, Full, Testing, or Custom
• Create project structure, setup .env files, create .gitignore (optional)

For the library and tool selection, use:

• <space> to select
• <a> to toggle all
• <i> to invert selection
• <enter> to proceed

Installation Presets

Choose from pre-configured installation presets:

• Minimal: React + Vite + Tailwind CSS only (fastest setup)
• Full: Router + State + Forms + UI + Testing + Tools (complete development setup) ⚠️ Takes very long time to install
• Testing: Tests + Base Tools (for existing projects)
• Custom: Manual selection of libraries and tools

Preset Contents

Full Preset Includes:

• Libraries: Lucide React, Framer Motion, React Router DOM, Zustand, React Hook Form, Axios
• Tools: ESLint, Prettier, Husky, Lint-Staged, Vitest

Testing Preset Includes:

• Tools: ESLint, Prettier, Husky, Lint-Staged, Vitest, @testing-library/react

Libraries & Tools

• Lucide React: Beautiful, customizable icons
• Framer Motion: Powerful animation library
• React Router: Client-side routing for SPAs
• Zustand: Lightweight state management
• React Hook Form: Performant form handling
• Axios: Promise-based HTTP client
• @testing-library/react: React testing utilities
• ESLint: Code linting for better code quality
• Prettier: Code formatting for consistent style
• Husky: Git hooks for automated checks

Example

sr_setup-cli
# CLI language: English
# Project name: my-awesome-app
# App title: Awesome App
# Framework: React (Vite)
# Preset: Full
# Create structure: Yes
# Setup .env: Yes
# Create .gitignore: Yes

This creates a clean project ready for development with your chosen configuration.

Requirements

• Node.js >= 18.0.0
• npm, yarn, or pnpm

License

MIT License. See LICENSE for details.

Author

Oleg Litvinchuk
Portfolio: https://litvinchuk-resume.netlify.app/