# create-modern-react

Create production-ready React + TypeScript + Tailwind applications in seconds.

One command. Full stack. Zero config. Stop wasting hours setting up boilerplate — start building in 15 seconds.

```bash

npx create-modern-react my-app

```

---

## What It Does

- Scaffolds a complete, production-ready React project with a single command

- Interactive CLI lets you pick your stack — choose only what you need

- Ships with pre-configured tooling so you skip the setup and jump straight to building

---

## Core Stack (Always Included)

- React 19 — Latest with Actions, `use()` hook, and concurrent features

- TypeScript 5.9 — Strict mode with full type safety out of the box

- Vite + SWC — 20x faster builds than Babel

- Tailwind CSS 4 — Utility-first styling with CSS-first config

- Shadcn/ui — Beautiful, accessible UI components (Button, Input, Card, Skeleton, etc.)

- Wouter — Lightweight 2KB router (vs 28KB React Router)

- Axios — Pre-configured HTTP client with interceptors and cancellation

- ESLint 9 + Prettier — 25+ lint rules + auto-formatting with Tailwind plugin

- Dark Mode — System preference detection + localStorage persistence

- Error Boundary — Graceful error handling UI built-in

- Toast Notifications — react-hot-toast integrated and ready to use

- Path Aliases — Clean `~/components` imports instead of `../../../`

---

## Optional Features (Pick What You Need)

- Redux Toolkit + Redux Persist — Global state management with typed hooks and session persistence

- React Hook Form + Zod — Type-safe form validation with custom `useZodForm` hook

- Ant Design v5 — Enterprise UI alternative that replaces Shadcn/ui

- Husky + lint-staged — Pre-commit hooks for automatic code quality checks

---

## Build Optimizations (Production-Grade)

- SWC Compiler — 20x faster than Babel

- Gzip Compression — Pre-compressed `.gz` bundles for smaller payloads

- Chunk Splitting — Separate vendor + router bundles for better caching

- Tree Shaking — Dead code automatically eliminated

- Console Removal — `console.log` stripped in production builds

- SVG as Components — Import SVGs directly as React components

---

## Custom Hooks Included

- `useLoader()` — Loading state management

- `useDebounce()` — Value debouncing (300ms default)

- `useCancelToken()` — Axios request cancellation on unmount

- `useTheme()` — Dark/light theme toggling

---

## Type-Safe API Layer

- Pre-built `getApi`, `postApi`, `patchApi`, `deleteApi` helpers

- Axios instance with interceptors for auth tokens and error handling

- Full TypeScript generics support for request/response types

---

## AI-Powered Development

- Ships with 8 pre-configured Claude Code AI skills for every project

- Includes React best practices, UI design patterns, browser testing, and more

- AI-assisted development from day one

---

## Why Choose This Over Alternatives?

- vs Vite CLI — Vite gives you a blank canvas. This gives you a furnished house.

- vs Create React App — CRA is deprecated. This is modern, fast, and maintained.

- vs Manual Setup — Save 1-2 hours of boilerplate configuration every single time.

- 15 seconds to a full project vs hours of piecing together configs

---

## Built With This

- ResumeFreePro.com — AI-powered resume builder

- HealthMug.com — Online pharmacy platform

- Hop Wellness - AI-powered revenue orchestration platform for wellness businesses (gyms, salons, spas, medical practices) that handles bookings, scheduling, payments.

---

## Quick Stats

- 3.0.0 — Active development, latest React ecosystem

- MIT Licensed — Free and open source

- npm, yarn, pnpm — Works with any package manager

- Node 20+ — Modern runtime support

## Tags / Keywords

`react` `typescript` `vite` `tailwindcss` `cli` `scaffold` `boilerplate` `shadcn-ui` `react-starter` `vite-template` `npx` `frontend` `antd` `redux` `developer-tools` `starter-kit`