mern-cli-start 1.0.0

package/README.md

@@ -0,0 +1,113 @@
+# 🚀 Mern-Cli-Start
+
+This project was generated using **mern-cli-start** — a production-ready MERN stack starter.
+
+---
+
+## 📦 Tech Stack
+
+### Frontend
+- React (Vite)
+- Modern folder structure
+- Component-based architecture
+
+### Backend
+- Node.js
+- Express.js
+- MVC Architecture
+- REST API ready
+
+---
+
+## 📁 Project Structure
+
+```
+
+root/
+│
+├── backend/ # Node.js + Express API
+│ ├── src/
+│ │ ├── controllers/
+│ │ ├── models/
+│ │ ├── routes/
+│ │ ├── middleware/
+│ │ └── app.js
+│ └── server.js
+│
+├── frontend/ # React + Vite App
+│ ├── src/
+│ │ ├── components/
+│ │ ├── pages/
+│ │ └── App.jsx
+│ └── index.html
+│
+└── README.md
+
+```
+
+---
+
+## 🌐 Default Ports
+
+- Frontend → http://localhost:5173
+- Backend → http://localhost:8000
+
+---
+
+## 📌 Features
+
+- Clean folder structure
+- Scalable architecture
+- Easy to customize
+- Fast development setup
+- Auto dependency install
+
+---
+
+## 🛠️ Customization Guide
+
+Add new API route : ``` backend/src/routes/ ```
+
+Add new controller : ``` backend/src/controllers/ ```
+
+Add frontend page : ``` frontend/src/pages/ ```
+
+Add reusable components : ``` frontend/src/components/ ```
+
+---
+
+## 🔐 Environment Variables
+
+Create a .env file in backend/:
+```
+PORT=8000
+MONGO_URI=your_mongodb_connection
+JWT_SECRET=your_secret_key
+```
+
+---
+
+## 👨‍💻 Created By
+
+Adarsh Shaw
+
+- 💼 Developer | MERN Stack Enthusiast
+- 🚀 Passionate about building scalable and real-world applications
+- 🛠️ Creator of create-mern-pro
+- 🔗 Connect with me
+     - [GitHub](https://github.com/adarsh-279)
+     - [Linkedin](https://www.linkedin.com/in/adarsh-shaw279/)
+     - [Portfolio](https://adarshshaw.vercel.app)
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! 🎉
+Open issues, suggest features, or submit pull requests to make even better.
+
+---
+
+## ⭐ Support
+
+If you like this project, give it a ⭐ on GitHub!

package/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+import { createProject } from "./lib/createProject.js";
+
+const name = process.argv[2];
+
+if (!name) {
+  console.log("Please provide project name");
+  console.log("Example: npx mern-app myApp");
+  process.exit(1);
+}
+
+createProject(name);

package/lib/createProject.js

@@ -0,0 +1,33 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export function createProject(name) {
+  const templatePath = path.join(__dirname, "../templates/base");
+  const targetPath = path.join(process.cwd(), name);
+
+  if (fs.existsSync(targetPath)) {
+    console.log("Folder already exists");
+    process.exit(1);
+  }
+
+    fs.cpSync(templatePath, targetPath, { recursive: true });
+
+    console.log("📦 Installing backend dependencies...");
+    execSync("npm install", {
+      cwd: path.join(targetPath, "backend"),
+      stdio: "inherit",
+    });
+
+    console.log("📦 Installing frontend dependencies...");
+    execSync("npm install", {
+      cwd: path.join(targetPath, "frontend"),
+      stdio: "inherit",
+    });
+
+  console.log(`\n ${name} created successfully!\n`);
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "mern-cli-start",
+  "version": "1.0.0",
+  "description": "CLI to generate production-ready MERN apps",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adarsh-279/mern-start.git"
+  },
+  "keywords": [
+    "mern",
+    "cli",
+    "starter",
+    "boilerplate"
+  ],
+  "bin": {
+    "mern-start": "index.js"
+  },
+  "directories": {
+    "lib": "lib"
+  },
+  "files": [
+    "templates",
+    "index.js",
+    "lib"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "preferGlobal": true,
+  "author": "Adarsh Shaw",
+  "license": "MIT",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/adarsh-279/mern-start/issues"
+  },
+  "homepage": "https://github.com/adarsh-279/mern-start#readme"
+}

package/templates/base/README.md

@@ -0,0 +1,113 @@
+# 🚀 Mern-Cli-Start
+
+This project was generated using **mern-cli-start** — a production-ready MERN stack starter.
+
+---
+
+## 📦 Tech Stack
+
+### Frontend
+- React (Vite)
+- Modern folder structure
+- Component-based architecture
+
+### Backend
+- Node.js
+- Express.js
+- MVC Architecture
+- REST API ready
+
+---
+
+## 📁 Project Structure
+
+```
+
+root/
+│
+├── backend/ # Node.js + Express API
+│ ├── src/
+│ │ ├── controllers/
+│ │ ├── models/
+│ │ ├── routes/
+│ │ ├── middleware/
+│ │ └── app.js
+│ └── server.js
+│
+├── frontend/ # React + Vite App
+│ ├── src/
+│ │ ├── components/
+│ │ ├── pages/
+│ │ └── App.jsx
+│ └── index.html
+│
+└── README.md
+
+```
+
+---
+
+## 🌐 Default Ports
+
+- Frontend → http://localhost:5173
+- Backend → http://localhost:8000
+
+---
+
+## 📌 Features
+
+- Clean folder structure
+- Scalable architecture
+- Easy to customize
+- Fast development setup
+- Auto dependency install
+
+---
+
+## 🛠️ Customization Guide
+
+Add new API route : ``` backend/src/routes/ ```
+
+Add new controller : ``` backend/src/controllers/ ```
+
+Add frontend page : ``` frontend/src/pages/ ```
+
+Add reusable components : ``` frontend/src/components/ ```
+
+---
+
+## 🔐 Environment Variables
+
+Create a .env file in backend/:
+```
+PORT=8000
+MONGO_URI=your_mongodb_connection
+JWT_SECRET=your_secret_key
+```
+
+---
+
+## 👨‍💻 Created By
+
+Adarsh Shaw
+
+- 💼 Developer | MERN Stack Enthusiast
+- 🚀 Passionate about building scalable and real-world applications
+- 🛠️ Creator of create-mern-pro
+- 🔗 Connect with me
+     - [GitHub](https://github.com/adarsh-279)
+     - [Linkedin](https://www.linkedin.com/in/adarsh-shaw279/)
+     - [Portfolio](https://adarshshaw.vercel.app)
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! 🎉
+Open issues, suggest features, or submit pull requests to make even better.
+
+---
+
+## ⭐ Support
+
+If you like this project, give it a ⭐ on GitHub!

package/templates/base/backend/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "backend",
+  "version": "1.0.0",
+  "description": "",
+  "main": "server.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "dependencies": {
+    "bcryptjs": "^3.0.3",
+    "cookie-parser": "^1.4.7",
+    "cors": "^2.8.6",
+    "dotenv": "^17.4.2",
+    "express": "^5.2.1",
+    "jsonwebtoken": "^9.0.3",
+    "mongoose": "^9.4.1"
+  }
+}

package/templates/base/backend/server.js

@@ -0,0 +1,7 @@
+import dotenv from "dotenv";
+dotenv.config();
+
+import app from "./src/app.js";
+import connectDB from "./src/db/database.js";
+
+connectDB();

package/templates/base/backend/src/app.js

@@ -0,0 +1,19 @@
+import dotenv from "dotenv";
+dotenv.config();
+
+import express from "express";
+
+const app = express();
+
+app.use(express.json());
+app.use(cookieParser());
+
+app.get("/", (req, res) => {
+    res.send("Default Route");
+});
+
+app.listen(process.env.PORT, () => {
+    console.log(`Server is running on port: https://localhost:${process.env.PORT}`);
+});
+
+export default app;

package/templates/base/backend/src/db/database.js

@@ -0,0 +1,15 @@
+import mongoose from "mongoose";
+
+async function connectDB() {
+    return mongoose
+    .connect(process.env.MONGODB_URL)
+    .then(() => {
+        console.log("Connected to db");
+    })
+    .catch((err) => {
+        console.log("Not connected :", err);
+        throw err;
+    });
+}
+
+export default connectDB;

package/templates/base/frontend/README.md

@@ -0,0 +1,16 @@
+# React + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the [TS template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) for information on how to integrate TypeScript and [`typescript-eslint`](https://typescript-eslint.io) in your project.

package/templates/base/frontend/eslint.config.js

@@ -0,0 +1,29 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{js,jsx}'],
+    extends: [
+      js.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        ecmaFeatures: { jsx: true },
+        sourceType: 'module',
+      },
+    },
+    rules: {
+      'no-unused-vars': ['error', { varsIgnorePattern: '^[A-Z_]' }],
+    },
+  },
+])

package/templates/base/frontend/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Mern Start</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>

package/templates/base/frontend/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "frontend",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@tailwindcss/vite": "^4.2.2",
+    "axios": "^1.15.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-router-dom": "^7.14.0",
+    "tailwindcss": "^4.2.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "eslint": "^9.39.4",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.4.0",
+    "vite": "^8.0.4"
+  }
+}

package/templates/base/frontend/src/App.jsx

@@ -0,0 +1,12 @@
+import React from 'react'
+import Routing from './routes/Routing'
+
+const App = () => {
+  return (
+    <>
+      <Routing />
+    </>
+  )
+}
+
+export default App

package/templates/base/frontend/src/index.css

@@ -0,0 +1 @@
+@import "tailwindcss";

package/templates/base/frontend/src/main.jsx

@@ -0,0 +1,10 @@
+import { createRoot } from 'react-dom/client'
+import './index.css'
+import App from './App.jsx'
+import { BrowserRouter } from 'react-router-dom'
+
+createRoot(document.getElementById('root')).render(
+  <BrowserRouter>
+    <App />
+  </BrowserRouter>,
+)

package/templates/base/frontend/src/pages/Home.jsx

@@ -0,0 +1,27 @@
+import React from 'react'
+
+const Home = () => {
+  return (
+    <div className="min-h-screen flex flex-col items-center justify-center p-6">
+      <h1 className="text-4xl font-bold mb-2">MERN Pro App</h1>
+      <p className="text-lg mb-6 text-gray-600">
+        Project created successfully using create-mern-pro
+      </p>
+
+      <div className="bg-gray-100 p-4 rounded-lg w-full max-w-md mb-4">
+        <h2 className="font-semibold mb-2">Project Structure</h2>
+        <ul className="list-disc ml-5">
+          <li>Backend (Node + Express)</li>
+          <li>Frontend (React + Vite)</li>
+        </ul>
+      </div>
+
+      <div className="bg-gray-100 p-4 rounded-lg w-full max-w-md">
+        <h2 className="font-semibold mb-2">Start</h2>
+        <p>Run: npm run dev</p>
+      </div>
+    </div>
+  );
+};
+
+export default Home

package/templates/base/frontend/src/routes/Routing.jsx

@@ -0,0 +1,13 @@
+import React from 'react'
+import {Route, Routes} from "react-router-dom"
+import Home from '../pages/Home'
+
+const Routing = () => {
+  return (
+    <Routes>
+      <Route path="/" element={<Home />} />
+    </Routes>
+  )
+}
+
+export default Routing

package/templates/base/frontend/vite.config.js

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import tailwindcss from "@tailwindcss/vite";
+
+// https://vite.dev/config/
+export default defineConfig({
+  plugins: [react(), tailwindcss()],
+})