Who is this for? Frontend developers who want a clean, opinionated starting point for Vite + React projects — without spending time wiring up the same tools every time.

✨ Why gml-react?

gml-react is not just another Vite wrapper. It's an intelligent scaffolding tool that:

• ⚡ Sets up your full stack instantly
• 🏗️ Builds a clean, scalable folder structure
• 🎨 Injects a ready-to-use landing page UI
• 🧹 Removes all boilerplate automatically

👀 Preview

(Screenshot or GIF of the CLI in action goes here)

$ npx create-gml-react@latest

✔ Project name: my-app
✔ Language: JavaScript
✔ Setup type: ⚡ Quick Mode

Installing dependencies...
✔ Done! Your project is ready.

🚀 Features

⚡ Quick Mode

Just hit Enter and get a full stack instantly:

| Tool | Purpose | | ------------ | ----------------- | | Vite + React | Build tooling | | Tailwind v4 | Styling | | React Router | Routing | | Zustand | State management | | DaisyUI | Component library | | React Icons | Icon set | | Axios | HTTP client |

🛠 Custom Mode

Pick exactly what you need:

| Option | Choices | | ------------ | --------------------------------- | | Language | JavaScript / TypeScript | | CSS | Tailwind v4 / Bootstrap / None | | Icons | React Icons / Lucide / Huge Icons | | State | Zustand / Redux Toolkit | | UI | DaisyUI / Shadcn UI | | Routing | React Router |

🧠 Smart Automation

Folder structure — generated automatically:

src/
├── components/
├── pages/
├── layout/
├── hooks/
└── store/

Cleanup — runs on every scaffold:

• Removes StrictMode wrapper
• Deletes App.css
• Clears default index.css styles

UI injection — replaces the default Vite landing page with a modern, animated starter UI.

📦 Quick Start

Prerequisites

• Node.js >= 18.x
• npm, pnpm

Installation

# npx
npx create-gml-react@latest

# npm
npm create gml-react@latest

# pnpm
pnpm dlx create-gml-react@latest

📁 Project Structure

my-app/
├── public/
│   └── favicon.ico
├── src/
│   ├── assets/
│   │   └── logo.png
│   ├── components/
│   ├── hooks/
│   ├── layout/
│   ├── pages/
│   ├── store/
│   ├── App.jsx          # or App.tsx
│   ├── index.css
│   └── main.jsx         # or main.tsx
├── vite.config.js       # or vite.config.ts
└── package.json

▶️ Run Your Project

cd my-app
npm run dev

🔧 Troubleshooting

npx uses an old cached version

npx create-gml-react@latest --force

Dependencies fail to install
Make sure you're on Node.js >= 18. Run node -v to check.

Shadcn UI setup prompts appear
This is expected — Shadcn requires a brief manual config step after scaffolding. Follow the on-screen instructions.

🤝 Contributing

Got ideas? Found a bug? Contributions are welcome.

1. Fork the repo
2. Create a branch: git checkout -b feat/my-feature
3. Push and open a pull request

📜 License

MIT License © 2026
Built with ❤️ for developers who love clean code.