sr_setup-cli

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.5.0 (2025-09-28) - Major Fixes and Improvements

Enhancements:

• Improved Localization: Fixed project language selection to properly display in Russian when Russian CLI language is chosen
• Better User Experience: Added colored status indicators for confirm prompts (green for Yes, red for No)
• Performance Warning: Added red warning label for Full preset indicating long installation time
• Automatic Port Selection: Removed fixed port 3000 from Vite config - now automatically selects available port
• Cleaner Output: Suppressed create-vite output during installation for cleaner CLI experience

Fixes:

• Husky Installation: Fixed Husky setup to properly install as dev dependency and configure git hooks
• Deprecated Packages: Updated deprecated react-testing-library to @testing-library/react
• Peer Dependency Warnings: Added --legacy-peer-deps flag to npm install commands to reduce warnings
• ReferenceError Fix: Fixed "result is not defined" error in project customization
• Version Reading: CLI now reads current version from package.json instead of hardcoded value

Other:

• Updated package descriptions and preset contents to reflect current library versions
• Improved error handling and logging throughout the CLI

Installation

Install globally via npm:

npm install -g sr_setup-cli

Or via npx:

npx sr_setup-cli

Usage

Run the CLI:

sr_setup-cli

Follow the interactive prompts to configure your project:

• Choose CLI language: English or Русский
• 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 (updated from deprecated react-testing-library)
• 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: Русский
# 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.

License

MIT License. See LICENSE for details.

Author

Oleg Litvinchuk