Say goodbye to manually configuring Webpack, Babel, Express, and MongoDB connections over and over again. create-new-mern provides a beautifully styled, zero-configuration setup for full-stack developers in seconds.

✨ Features

• ⚡️ Instant Setup: Generate a full-stack MERN application with a single command.
• 🎨 Modern Frontend: React powered by Vite for blazing fast HMR, styled with Tailwind CSS v4.
• 🛠️ Robust Backend: Node.js & Express pre-configured with Mongoose, CORS, and Dotenv.
• 📦 Auto-Install: Automatically installs dependencies for both client and server during scaffolding.
• 🔐 Pre-configured Environments: Automatically generates .env files for seamless local development.

🚀 Quick Start

You don't need to install or configure anything globally. Just run the npx command and follow the interactive prompt:

npx create-new-mern

Alternatively, you can provide the project name directly:

npx create-new-mern my-awesome-app

🏗️ What's Included?

When you generate a project, the CLI automatically builds the following workspace structure:

my-awesome-app/
├── client/                     # Frontend Workspace
│   ├── .env                    # Contains VITE_API_URL
│   ├── package.json
│   ├── vite.config.js          # Configured with @tailwindcss/vite
│   ├── src/
│   │   ├── index.css           # Tailwind v4 import
│   │   └── App.jsx             # Beautifully styled starting page
│   └── ...
├── server/                     # Backend Workspace
│   ├── .env                    # PORT, MONGO_URI, JWT_SECRET
│   ├── package.json            # ES Modules ("type": "module") & Nodemon
│   ├── server.js               # Express app & Basic routing
│   ├── config/
│   │   └── db.js               # MongoDB connection logic
│   ├── models/
│   ├── routes/
│   └── controllers/
├── CHANGES.md                  # 🚨 Your Deployment Checklist
└── README.md                   # Instructions to run the apps

💻 Development

Once your project is generated, running it is incredibly simple.

1. Start the Backend API

cd my-awesome-app/server
npm run dev

Your backend will start on http://localhost:5000

2. Start the Frontend Application

Open a new terminal window:

cd my-awesome-app/client
npm run dev

Your frontend will start on http://localhost:5173

🌐 Preparing for Production

Before you deploy your application to a hosting provider (like Vercel, Render, or Heroku), make sure to read the generated CHANGES.md file in the root of your new project. It provides a quick checklist of variables (like MONGO_URI and JWT_SECRET) that you must update for security and functionality.

📄 License

This project is licensed under the MIT License - feel free to fork, modify, and use it in your own projects!