# 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`
Built with