neatnode 3.1.7 → 3.3.0

package/README.md

@@ -1,131 +1,135 @@
-<div align="center">
-  <img src="https://i.postimg.cc/9Fvw7p3q/1762540009103.png" width="120" alt="NeatNode Logo" />
-  <h1>NeatNode</h1>
-  <p><strong>Instantly scaffold production-ready Node.js backends with one command.</strong></p>
-
-  <img src="https://i.postimg.cc/59sw6LN6/1762540161048.png" alt="NeatNode Banner" />
-</div>
-
----
-
-## Overview
-
-**NeatNode** is a plug-and-play CLI that scaffolds clean, production-ready **Node.js backends** in seconds.  
-It comes with pre-built templates, optional CRUD modules, and a modern developer workflow — so you can start coding instead of configuring.
-
----
-
-## Features
-
-- Multiple templates: **Basic API**, **REST API**, and **Socket API**
-- Clean MVC folder structure
-- Optional CRUD scaffolding (User or Todo)
-- Integrated logging (Winston + Morgan)
-- Security middleware (Helmet, Rate Limiter)
-- Dynamic CLI with file removal & template customization
-- Ready for ESM, Redis, and future TypeScript support
-
----
-
-## Installation
-
-```bash
-npm install -g neatnode
-````
-
-or run directly with:
-
-```bash
-npx neatnode
-```
-
----
-
-## Usage
-
-```bash
-npx neatnode
-```
-
-* Enter your **project name**
-* Choose a **template** (Basic / REST / Socket)
-* Select whether to include **CRUD** examples
-* Install dependencies and start your project:
-
-```bash
-cd my-app
-npm install
-npm run dev
-```
-
----
-
-## Templates
-
-### Basic API
-
-Minimal Express setup with optional Todo CRUD.
-Perfect for small projects or quick prototypes.
-
-### REST API
-
-Full architecture with controllers, services, models, routes, error handling, validation, and logging.
-Ideal for scalable, production-grade APIs.
-
-### Socket API
-
-Express + Socket.io integration with logging and CORS setup.
-Best for chat apps or real-time systems.
-
----
-
-## Example Project Structure
-
-```
-src/
- ├── controllers/
- ├── models/
- ├── routes/
- ├── services/
- ├── utils/
- └── app.js
-```
-
----
-
-## Built With
-
-* Node.js & Express
-* Inquirer (CLI interaction)
-* fs-extra & path (file system automation)
-* Morgan & Winston (logging)
-* Joi (validation)
-* Helmet, Rate Limiter (security)
-
----
-
-## Project Screenshots
-
-### Frontend Website
-
-> Official landing page for NeatNode <img src="https://i.postimg.cc/85QVd7pn/Untitled-design.png" alt="NeatNode Landing Page" />
-
----
-
-### Documentation Website
-
-> Comprehensive docs built with Nextra <img src="https://i.postimg.cc/QNY0vR5r/Untitled-design-1.png" alt="NeatNode Docs" />
-
----
-
-## Author
-
-**Aakash Gupta**
-· [GitHub](https://github.com/aakash-gupta02) · [Email](mailto:aakashgupta052004@gmail.com) ·
-[Website](https://neatnode.vercel.app) · [Docs](https://neatnodee-docs.vercel.app)
-
----
-
-## License
-
-MIT © Aakash Gupta
+<div align="center">
+  <img src="https://i.postimg.cc/9Fvw7p3q/1762540009103.png" width="120" alt="NeatNode Logo" />
+  <h1>NeatNode</h1>
+  <p><strong>Instantly scaffold production-ready Node.js backends with one command.</strong></p>
+
+  <img src="https://i.postimg.cc/59sw6LN6/1762540161048.png" alt="NeatNode Banner" />
+</div>
+
+## Overview
+
+**NeatNode** is a plug-and-play **CLI tool** that scaffolds clean, production-ready **Node.js backend projects** (JavaScript & TypeScript) in seconds.  
+It comes with pre-built templates, MVC or Modular architecture choices, optional CRUD modules, and a modern developer workflow - so you can **start coding instead of configuring.**
+
+## Features
+
+-  **Instant project setup** - generate a complete Node.js project structure instantly  
+-  **JavaScript & TypeScript support** - choose your preferred language  
+-  **Pre-configured templates** - Basic Express, REST API, and Socket.IO  
+-  **Flexible Architecture** - pick between classic MVC or Modular architectures for REST APIs  
+-  **Dynamic template logic** - easily include or exclude example CRUD modules (User, Todo, Auth)
+-  **Scalable architecture** - prebuilt folder layouts  
+-  **Security-first setup** - Helmet, Rate Limiter, and CORS integrated  
+-  **Built-in error handling & logging** - Winston + Morgan setup (depending on template)  
+-  **Production-ready** - clean, validated, and deployment-ready output  
+
+## Installation
+
+```bash
+# Install globally
+npm install -g neatnode
+```
+
+or run it directly using `npx`:
+
+```bash
+npx neatnode
+```
+
+## Usage
+
+1. Run the CLI:
+
+   ```bash
+   npx neatnode
+   ```
+2. Enter project folder name (default: `my-app`).
+3. Select Language:
+   * **JavaScript**
+   * **TypeScript**
+4. Choose your template (options depend on language).
+5. (Optional) For REST API in JavaScript, choose your architecture (MVC or Modular).
+6. (Optional) Incorporate example CRUD modules, like Todo, User, or Auth.
+7. Navigate and start building:
+
+   ```bash
+   cd <project_name>
+   npm install
+   npm run dev
+   ```
+
+## Available Templates
+
+### **JavaScript**
+| Template     | Description                                                                      |
+| ------------ | -------------------------------------------------------------------------------- |
+| **Basic Express** | Minimal structure with .env, nodemon, and clean folder setup (Optional Todo CRUD) |
+| **REST API** | Express.js REST API with controllers, routes, and MongoDB config. Supports **MVC** or **Modular** architecture. (Optional User CRUD) |
+| **Socket.IO**| Socket.io server setup for real-time apps |
+
+### **TypeScript**
+| Template     | Description                                                                      |
+| ------------ | -------------------------------------------------------------------------------- |
+| **Basic Express** | Minimal TS structure for Node.js (Optional Todo CRUD) |
+| **REST API** | Express.js REST API boilerplate with TS. (Modular architectural setup with Optional Auth CRUD) |
+
+## Example CLI Output
+
+```
+$ npx neatnode
+🚀 Welcome to NeatNode CLI!
+
+? Enter project folder name: api-server
+? Select language: TypeScript
+? Choose a template: REST API (TS)
+? Include example Auth CRUD? Yes
+
+✅ Project "api-server" created successfully using "REST API (TS)".
+
+Next steps:
+  cd api-server
+  npm install
+  npm run dev
+
+🎉 Happy Coding!
+```
+
+## Previews
+
+### **Frontend Website**
+
+> Official landing page for NeatNode
+>
+> <img width="1426" height="781" alt="NeatNode Landing Page" src="https://github.com/user-attachments/assets/cf7e3ae3-8830-44a3-bce2-74064545b2e5" />
+
+### **Documentation Website**
+
+> Comprehensive docs built with Nextra
+>
+> <img width="1429" height="781" alt="NeatNode Docs" src="https://github.com/user-attachments/assets/59b1708f-d81c-405c-9bf7-3e8ee40bed85" />
+
+## Build With
+
+* Node.js
+* Inquirer (CLI prompts)
+* Degit (repository fetching)
+* Chalk & Ora
+
+## Learn More
+
+* 📄 [Documentation](https://docs.neatnode.codes)
+* 💻 [Website](https://neatnode.codes)
+* 🧰 [NPM Package](https://www.npmjs.com/package/neatnode)
+
+## Author
+
+**Aakash Gupta**  
+[GitHub](https://github.com/aakash-gupta02) • [Portfolio](https://aakashgupta.app)
+
+## License
+
+This project is licensed under the **MIT License** — feel free to use, modify, and distribute.
+
+<div align="center">
+  <sub>Built with ❤️ by Aakash Gupta | NeatNode © 2026</sub>
+</div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neatnode",
-  "version": "3.1.7",
+  "version": "3.3.0",
   "description": "Plug & Play Node.js backend starter templates — build REST APIs, socket servers, and more in seconds.",
   "bin": {
     "neatnode": "bin/index.js"
@@ -38,10 +38,20 @@
   "homepage": "https://github.com/aakash-gupta02/NeatNode#readme",
   "license": "ISC",
   "type": "module",
+  "scripts": {
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "node --test"
+  },
   "dependencies": {
     "axios": "^1.13.2",
     "extract-zip": "^2.0.1",
     "fs-extra": "^11.3.2",
     "inquirer": "^12.10.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "eslint": "^9.0.0",
+    "globals": "^15.0.0"
   }
-}
+}

package/src/actions/addEnv.js

@@ -0,0 +1,20 @@
+import fs from "fs";
+import path from "path";
+
+export async function addEnv({ targetPath }) {
+  try {
+    const envExamplePath = path.join(targetPath, ".env.example");
+    const envPath = path.join(targetPath, ".env");
+
+    if (
+      fs.existsSync(envExamplePath) &&
+      !fs.existsSync(envPath)
+    ) {
+      const envContent = fs.readFileSync(envExamplePath, "utf8");
+
+      fs.writeFileSync(envPath, envContent, "utf8");
+    }
+  } catch (error) {
+    console.error("Error adding .env file:", error);
+  }
+}

package/src/actions/createProject.js

@@ -1,57 +1,76 @@
-import fs from "fs";
-import path from "path";
-import os from "os";
-import { fileURLToPath } from "url";
-import { copyTemplate } from "../utils/copyTemplate.js";
-import { removeCrud, removeCrudModule, removeCrudReferences } from "./removeCRUD.js";
-import { downloadTemplate } from "../utils/downloadRepoTemplate.js";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-export async function createProject({ projectName, repoPath, includeCrud, crudName, langKey, isModular }) {
-  try {
-    const targetPath = projectName === "."
-      ? process.cwd()
-      : path.join(process.cwd(), projectName);
-
-    if (fs.existsSync(targetPath) && projectName !== ".") {
-      console.error(`❌ Folder "${projectName}" already exists.`);
-      process.exit(1);
-    }
-
-    if (projectName !== ".") {
-      console.log("Creating project folder...");
-      fs.mkdirSync(targetPath);
-    }
-
-    console.log("Downloading template...");
-    const localTemplatePath = await downloadTemplate(repoPath);
-
-    await copyTemplate(localTemplatePath, targetPath, {
-      "project-name": projectName === "." ? path.basename(process.cwd()) : projectName,
-      "author": os.userInfo().username || "author",
-    });
-
-    if (!includeCrud && crudName) {
-      console.log("🗑 Removing CRUD files...");
-
-      if (isModular) {
-        removeCrudModule(targetPath, crudName);
-        removeCrudReferences(path.join(targetPath, "src", `routes/index.route.${langKey}`));
-
-      }
-
-      removeCrud(targetPath, crudName, langKey);
-      removeCrudReferences(path.join(targetPath, "src", `app.${langKey}`));
-    }
-
-    console.log(`\n✅ Project "${projectName}" created successfully!\n`);
-
-  } catch (err) {
-    console.error("❌ Failed to create project:", err);
-    process.exit(1);
-  }
-}
-
-
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { fileURLToPath } from "url";
+import { copyTemplate } from "../utils/copyTemplate.js";
+import { cleanupTemplateMarkers, removeCrud, removeCrudModule, removeCrudReferences } from "./removeCRUD.js";
+import { downloadTemplate } from "../utils/downloadRepoTemplateByVersionTags.js";
+import { addEnv } from "./addEnv.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export async function createProject({ projectName, repoPath, includeCrud, crudName, langKey, isModular }) {
+  try {
+    const targetPath = projectName === "."
+      ? process.cwd()
+      : path.join(process.cwd(), projectName);
+
+    if (fs.existsSync(targetPath) && projectName !== ".") {
+      console.error(`❌ Folder "${projectName}" already exists.`);
+      process.exit(1);
+    }
+
+    if (projectName !== ".") {
+      console.log("Creating project folder...");
+      fs.mkdirSync(targetPath);
+    }
+
+    console.log("Downloading template...");
+    const localTemplatePath = await downloadTemplate(repoPath);
+
+    await copyTemplate(localTemplatePath, targetPath, {
+      "project-name": projectName === "." ? path.basename(process.cwd()) : projectName,
+      "author": os.userInfo().username || "author",
+    });
+
+    await addEnv({ targetPath });
+
+    if (!includeCrud && crudName) {
+      console.log("🗑 Removing CRUD files...");
+
+      if (isModular) {
+        removeCrudModule(targetPath, crudName);
+
+        removeCrudReferences(
+          path.join(targetPath, "src", `routes/index.route.${langKey}`)
+        );
+      }
+
+      removeCrud(targetPath, crudName, langKey);
+
+      removeCrudReferences(
+        path.join(targetPath, "src", `app.${langKey}`)
+      );
+    }
+
+    // ALWAYS CLEANUP MARKERS
+    cleanupTemplateMarkers(
+      path.join(targetPath, "src", `app.${langKey}`)
+    );
+
+    if (isModular) {
+      cleanupTemplateMarkers(
+        path.join(targetPath, "src", `routes/index.route.${langKey}`)
+      );
+    }
+
+    console.log(`\n✅ Project "${projectName}" created successfully!\n`);
+
+  } catch (err) {
+    console.error("❌ Failed to create project:", err);
+    process.exit(1);
+  }
+}
+
+

package/src/actions/removeCRUD.js

@@ -1,62 +1,88 @@
-import fs from "fs";
-import path from "path";
-
-
-export function removeCrud(targetPath, name, langKey) {
-  try {
-    const crudPaths = [
-      `src/models/${name}.model.${langKey}`,
-      `src/controllers/${name}.controller.${langKey}`,
-      `src/routes/${name}.route.${langKey}`,
-      `src/services/${name}.service.${langKey}`,
-      `src/validations/${name}.validation.${langKey}`,
-      `src/middlewares/auth.middleware.${langKey}`,
-      `src/schemas/${name}.schema.${langKey}`
-    ];
-
-    crudPaths.forEach(relPath => {
-      const absPath = path.join(targetPath, relPath);
-
-      if (fs.existsSync(absPath)) {
-        fs.rmSync(absPath, { force: true });
-        console.log(`✔ Removed: ${relPath}`);
-      } // else {
-      //   console.log(`Skipped (not found): ${relPath}`);
-      // }
-    });
-  } catch (err) {
-    console.error("❌ Error while removing CRUD files:", err.message);
-  }
-}
-
-export function removeCrudReferences(appJsPath) {
-  let content = fs.readFileSync(appJsPath, "utf8");
-
-  // Remove imports block
-  content = content.replace(
-    /\/\/ ROUTE_IMPORTS_START[\s\S]*?\/\/ ROUTE_IMPORTS_END/,
-    ""
-  );
-
-  // Remove route usage block
-  content = content.replace(
-    /\/\/ ROUTE_USES_START[\s\S]*?\/\/ ROUTE_USES_END/,
-    ""
-  );
-
-  fs.writeFileSync(appJsPath, content, "utf8");
-}
-
-export function removeCrudModule(targetPath, name) {
-  try {
-    const modulePath = path.join(targetPath, `src/modules/${name}`);
-    if (fs.existsSync(modulePath)) {
-      fs.rmSync(modulePath, { recursive: true, force: true });
-      console.log(`✔ Removed module: ${name}`);
-    } else {
-      console.log(`Skipped module (not found): ${name}`);
-    }
-  } catch (err) {
-    console.error("❌ Error while removing CRUD module:", err.message);
-  }
-}
+import fs from "fs";
+import path from "path";
+
+export function removeCrud(targetPath, name, langKey) {
+  try {
+    const crudPaths = [
+      `src/models/${name}.model.${langKey}`,
+      `src/controllers/${name}.controller.${langKey}`,
+      `src/routes/${name}.route.${langKey}`,
+      `src/services/${name}.service.${langKey}`,
+      `src/validations/${name}.validation.${langKey}`,
+      `src/middlewares/auth.middleware.${langKey}`,
+      `src/schemas/${name}.schema.${langKey}`,
+    ];
+
+    crudPaths.forEach((relPath) => {
+      const absPath = path.join(targetPath, relPath);
+
+      if (fs.existsSync(absPath)) {
+        fs.rmSync(absPath, { force: true });
+        console.log(`✔ Removed: ${relPath}`);
+      } // else {
+      //   console.log(`Skipped (not found): ${relPath}`);
+      // }
+    });
+  } catch (err) {
+    console.error("❌ Error while removing CRUD files:", err.message);
+  }
+};
+
+export function cleanupTemplateMarkers(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return false;
+  }
+
+  let content = fs.readFileSync(filePath, "utf8");
+
+  content = content
+    .replace(/^\s*\/\/ ROUTE_IMPORTS_START\s*$/gm, "")
+    .replace(/^\s*\/\/ ROUTE_IMPORTS_END\s*$/gm, "")
+    .replace(/^\s*\/\/ ROUTE_USES_START\s*$/gm, "")
+    .replace(/^\s*\/\/ ROUTE_USES_END\s*$/gm, "");
+
+  // Remove excessive blank lines
+  content = content.replace(/\n{3,}/g, "\n\n");
+
+  fs.writeFileSync(filePath, content, "utf8");
+
+  return true;
+};
+
+export function removeCrudReferences(appJsPath) {
+  if (!fs.existsSync(appJsPath)) {
+    return false;
+  }
+
+  let content = fs.readFileSync(appJsPath, "utf8");
+
+  // Remove imports block + surrounding blank lines
+  content = content.replace(
+    /\s*\/\/ ROUTE_IMPORTS_START[\s\S]*?\/\/ ROUTE_IMPORTS_END\s*/g,
+    "\n",
+  );
+
+  // Remove route usage block + surrounding blank lines
+  content = content.replace(
+    /\s*\/\/ ROUTE_USES_START[\s\S]*?\/\/ ROUTE_USES_END\s*/g,
+    "\n",
+  );
+
+  fs.writeFileSync(appJsPath, content, "utf8");
+
+  return true;
+};
+
+export function removeCrudModule(targetPath, name) {
+  try {
+    const modulePath = path.join(targetPath, `src/modules/${name}`);
+    if (fs.existsSync(modulePath)) {
+      fs.rmSync(modulePath, { recursive: true, force: true });
+      console.log(`✔ Removed module: ${name}`);
+    } else {
+      console.log(`Skipped module (not found): ${name}`);
+    }
+  } catch (err) {
+    console.error("❌ Error while removing CRUD module:", err.message);
+  }
+};

package/src/cli.js

@@ -1,128 +1,147 @@
-#!/usr/bin/env node
-import inquirer from "inquirer";
-import templates from "./config/templates.js";
-import { createProject } from "./actions/createProject.js";
-
-async function main() {
-  console.log("\n🚀 Welcome to NeatNode CLI!\n");
-
-  // STEP 1 — Project Name
-  const { projectName } = await inquirer.prompt([
-    {
-      type: "input",
-      name: "projectName",
-      message: "Enter project folder name:",
-      default: "my-app",
-      validate: (v) => v.trim() !== "" || "Project name cannot be empty.",
-    },
-  ]);
-
-  // STEP 2 — Choose Language
-  const { language } = await inquirer.prompt([
-    {
-      type: "list",
-      name: "language",
-      message: "Select language:",
-      choices: ["JavaScript", "TypeScript"],
-    },
-  ]);
-
-  const langKey = language === "JavaScript" ? "js" : "ts";
-  const templateList = templates[langKey];
-
-  // STEP 3 — Choose Template
-  const { template } = await inquirer.prompt([
-    {
-      type: "list",
-      name: "template",
-      message: "Choose a template:",
-      choices: templateList.map((t) => t.name),
-    },
-  ]);
-
-  const chosen = templateList.find((t) => t.name === template);
-
-  // STEP 4 — CRUD Optional (only for some templates)
-  let includeCrud = false;
-  let isModular = chosen.isModular || false;
-  let crudName = "";
-
-  if (chosen.name === "Basic Express") {
-    const { includeCrud: answer } = await inquirer.prompt([
-      {
-        type: "confirm",
-        name: "includeCrud",
-        message: "Include example Todo CRUD?",
-        default: true,
-      },
-    ]);
-    includeCrud = answer;
-    crudName = "todo";
-  }
-
-  if (chosen.name === "REST API") {
-    const { includeCrud: answer } = await inquirer.prompt([
-      {
-        type: "confirm",
-        name: "includeCrud",
-        message: "Include example User CRUD?",
-        default: true,
-      },
-    ]);
-    includeCrud = answer;
-    crudName = "user";
-  }
-
-  if (chosen.name === "Basic Express (TS)") {
-    const { includeCrud: answer } = await inquirer.prompt([
-      {
-        type: "confirm",
-        name: "includeCrud",
-        message: "Include example Todo CRUD?",
-        default: true,
-      },
-    ]);
-    includeCrud = answer;
-    crudName = "todo";
-  }
-  if (chosen.name === "REST API (TS)") {
-    const { includeCrud: answer } = await inquirer.prompt([
-      {
-        type: "confirm",
-        name: "includeCrud",
-        message: "Include example Auth CRUD?",
-        default: true,
-      },
-    ]);
-    includeCrud = answer;
-    crudName = "auth";
-    isModular = chosen.isModular;
-  }
-
-  // STEP 5 — Create Project (Remote download logic inside)
-  await createProject({
-    projectName,
-    repoPath: chosen.repoPath,
-    includeCrud,
-    crudName,
-    langKey,
-    isModular,
-  });
-
-  
-  console.log(`\n✅ Project "${projectName}" created successfully using "${chosen.name}".\n`);
-
-  console.log("Next steps:");
-  console.log(`  cd ${projectName}`);
-  console.log("  npm install");
-  console.log("  npm run dev\n");
-
-  console.log("🎉 Happy Coding!\n");
-
-
-
-}
-
-main().catch((err) => {
-  console.error("❌ Error:", err.message || err);
-});
+#!/usr/bin/env node
+import inquirer from "inquirer";
+import templates from "./config/templates.js";
+import { createProject } from "./actions/createProject.js";
+
+async function main() {
+  console.log("\n🚀 Welcome to NeatNode CLI!\n");
+
+  // STEP 1 — Project Name
+  const { projectName } = await inquirer.prompt([
+    {
+      type: "input",
+      name: "projectName",
+      message: "Enter project folder name:",
+      default: "my-app",
+      validate: (v) => v.trim() !== "" || "Project name cannot be empty.",
+    },
+  ]);
+
+  // STEP 2 — Choose Language
+  const { language } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "language",
+      message: "Select language:",
+      choices: ["JavaScript", "TypeScript"],
+    },
+  ]);
+
+  const langKey = language === "JavaScript" ? "js" : "ts";
+  const templateList = templates[langKey];
+
+  // STEP 3 — Choose Template
+  const { template } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "template",
+      message: "Choose a template:",
+      choices: templateList.map((t) => t.name),
+    },
+  ]);
+
+  const chosen = templateList.find((t) => t.name === template);
+
+  let isModular = chosen.isModular || false;
+  let architecture = null;
+
+  if (chosen.architecture) {
+    const answer = await inquirer.prompt([
+      {
+        type: "list",
+        name: "architecture",
+        message: "Select architecture:",
+        choices: ["mvc", "modular"],
+      },
+    ]);
+
+    architecture = answer.architecture;
+    isModular = architecture === "modular";
+
+    chosen.repoPath = chosen.architecture[architecture];
+
+  }
+
+  // STEP 4 — CRUD Optional (only for some templates)
+  let includeCrud = false;
+  let crudName = "";
+
+  if (chosen.name === "Basic Express") {
+    const { includeCrud: answer } = await inquirer.prompt([
+      {
+        type: "confirm",
+        name: "includeCrud",
+        message: "Include example Todo CRUD?",
+        default: true,
+      },
+    ]);
+    includeCrud = answer;
+    crudName = "todo";
+  }
+
+  if (chosen.name === "REST API") {
+    const { includeCrud: answer } = await inquirer.prompt([
+      {
+        type: "confirm",
+        name: "includeCrud",
+        message: "Include example User CRUD?",
+        default: true,
+      },
+    ]);
+    includeCrud = answer;
+    crudName = "user";
+  }
+
+  if (chosen.name === "Basic Express (TS)") {
+    const { includeCrud: answer } = await inquirer.prompt([
+      {
+        type: "confirm",
+        name: "includeCrud",
+        message: "Include example Todo CRUD?",
+        default: true,
+      },
+    ]);
+    includeCrud = answer;
+    crudName = "todo";
+  }
+  if (chosen.name === "REST API (TS)") {
+    const { includeCrud: answer } = await inquirer.prompt([
+      {
+        type: "confirm",
+        name: "includeCrud",
+        message: "Include example Auth CRUD?",
+        default: true,
+      },
+    ]);
+    includeCrud = answer;
+    crudName = "auth";
+    isModular = chosen.isModular;
+  }
+
+  // STEP 5 — Create Project (Remote download logic inside)
+  await createProject({
+    projectName,
+    repoPath: chosen.repoPath,
+    includeCrud,
+    crudName,
+    langKey,
+    isModular,
+  });
+
+
+  console.log(`\n✅ Project "${projectName}" created successfully using "${chosen.name}".\n`);
+
+  console.log("Next steps:");
+  console.log(`  cd ${projectName}`);
+  console.log("  npm install");
+  console.log("  npm run dev\n");
+
+  console.log("🎉 Happy Coding!\n");
+
+
+
+}
+
+main().catch((err) => {
+  console.error("❌ Error:", err.message || err);
+});

package/src/config/templates.js

@@ -1,13 +1,19 @@
-export default {
-  js: [
-    { name: "Basic Express", repoPath: "templates/js/express-basic" },
-    { name: "REST API", repoPath: "templates/js/express-rest-api" },
-    { name: "Socket.IO", repoPath: "templates/js/express-socket" },
-  ],
-
-  ts: [
-    { name: "Basic Express (TS)", repoPath: "templates/ts/basic-express" },
-    { name: "REST API (TS)", repoPath: "templates/ts/express-rest-api", isModular: true },
-    // { name: "Socket.IO (TS)", repoPath: "templates/ts/express-socket" },
-  ],
-};
+export default {
+  js: [
+    { name: "Basic Express", repoPath: "templates/js/express-basic" },
+    {
+      name: "REST API",
+      architecture: {
+        mvc: "templates/js/express-rest-api",
+        modular: "templates/js/express-modular-rest-api"
+      }
+    },
+    { name: "Socket.IO", repoPath: "templates/js/express-socket" },
+  ],
+
+  ts: [
+    { name: "Basic Express (TS)", repoPath: "templates/ts/basic-express" },
+    { name: "REST API (TS)", repoPath: "templates/ts/express-rest-api", isModular: true },
+    // { name: "Socket.IO (TS)", repoPath: "templates/ts/express-socket" },
+  ],
+};

package/src/utils/copyTemplate.js

@@ -1,40 +1,48 @@
-import fs from "fs";
-import path from "path";
-
-export async function copyTemplate(srcDir, destDir, replacements = {}, ) {
-  const ignoreList = ["node_modules", ".git", ".env", "package-lock.json", ".npmignore", "logs"];
-
-  if (!fs.existsSync(destDir)) {
-    fs.mkdirSync(destDir, { recursive: true });
-  }
-
-  const items = fs.readdirSync(srcDir, { withFileTypes: true });
-
-  for (const item of items) {
-    if (ignoreList.includes(item.name)) continue;
-
-    const srcPath = path.join(srcDir, item.name);
-    const destPath = path.join(destDir, item.name);
-
-    if (item.isDirectory()) {
-      // recursively copy folders
-      await copyTemplate(srcPath, destPath, replacements);
-    } else {
-      // for certain files, replace placeholders
-      if (["package.json"].includes(item.name)) {
-        let content = fs.readFileSync(srcPath, "utf-8");
-
-        // replace all {{key}} with provided replacements
-        for (const [key, value] of Object.entries(replacements)) {
-          const regex = new RegExp(`project-name`, "g");
-          content = content.replace(regex, value);
-        }
-
-        fs.writeFileSync(destPath, content, "utf-8");
-      } else {
-        // just copy normal files
-        fs.copyFileSync(srcPath, destPath);
-      }
-    }
-  }
-}
+import fs from "fs";
+import path from "path";
+
+export async function copyTemplate(srcDir, destDir, replacements = {}) {
+  const ignoreList = [
+    "node_modules",
+    ".git",
+    ".env",
+    "package-lock.json",
+    ".npmignore",
+    "logs",
+  ];
+
+  if (!fs.existsSync(destDir)) {
+    fs.mkdirSync(destDir, { recursive: true });
+  }
+
+  const items = fs.readdirSync(srcDir, { withFileTypes: true });
+
+  for (const item of items) {
+    if (ignoreList.includes(item.name)) continue;
+
+    const srcPath = path.join(srcDir, item.name);
+    const destPath = path.join(destDir, item.name);
+
+    if (item.isDirectory()) {
+      // recursively copy folders
+      await copyTemplate(srcPath, destPath, replacements);
+    } else {
+      // for certain files, replace placeholders
+      if (["package.json"].includes(item.name)) {
+        let content = fs.readFileSync(srcPath, "utf-8");
+
+        // Replace all configured {{key}} placeholders with their values.
+        for (const [key, value] of Object.entries(replacements)) {
+          const escapedKey = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+          const regex = new RegExp(`\\{\\{\\s*${escapedKey}\\s*\\}\\}`, "g");
+          content = content.replace(regex, String(value));
+        }
+
+        fs.writeFileSync(destPath, content, "utf-8");
+      } else {
+        // just copy normal files
+        fs.copyFileSync(srcPath, destPath);
+      }
+    }
+  }
+}

package/src/utils/downloadRepoTemplateByVersionTags.js

@@ -0,0 +1,127 @@
+import axios from "axios";
+import extract from "extract-zip";
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const owner = "aakash-gupta02";
+const repo = "NeatNode";
+
+const getPackageVersion = () => {
+  try {
+    const pkgPath = path.resolve(__dirname, "../../package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    return pkg.version;
+  } catch {
+    return null;
+  }
+};
+
+const getTemplateRef = () => {
+  if (process.env.NEATNODE_TEMPLATE_REF) {
+    return process.env.NEATNODE_TEMPLATE_REF;
+  }
+
+  const version = getPackageVersion();
+
+  if (!version) {
+    return "main";
+  }
+
+  return `v${version}`;
+};
+
+const getZipUrl = (ref, refType = "tag") => {
+  if (refType === "branch") {
+    return `https://codeload.github.com/${owner}/${repo}/zip/refs/heads/${ref}`;
+  }
+  return `https://codeload.github.com/${owner}/${repo}/zip/refs/tags/${ref}`;
+};
+
+const downloadFromRef = async ({ repoPath, ref, refType }) => {
+  const zipUrl = getZipUrl(ref, refType);
+
+  const tmpBase = fs.mkdtempSync(path.join(os.tmpdir(), "neatnode-"));
+  const tempZip = path.join(tmpBase, "repo.zip");
+  const tempExtractDir = path.join(tmpBase, "repo-extract");
+  const tempFinalDir = path.join(tmpBase, "template-final");
+
+  const response = await axios({
+    url: zipUrl,
+    responseType: "arraybuffer",
+  });
+
+  fs.writeFileSync(tempZip, response.data);
+  await extract(tempZip, { dir: tempExtractDir });
+
+  const extractedRootDir = fs
+    .readdirSync(tempExtractDir, { withFileTypes: true })
+    .find((entry) => entry.isDirectory());
+
+  if (!extractedRootDir) {
+    throw new Error(
+      `Could not locate extracted template root directory for ${refType} "${ref}".`,
+    );
+  }
+
+  const extractedRoot = path.join(tempExtractDir, extractedRootDir.name);
+  const srcTemplatePath = path.join(extractedRoot, repoPath);
+
+  if (!fs.existsSync(srcTemplatePath)) {
+    throw new Error(
+      `Template path "${repoPath}" not found in ${refType} "${ref}" archive.`,
+    );
+  }
+
+  fs.mkdirSync(tempFinalDir, { recursive: true });
+  fs.cpSync(srcTemplatePath, tempFinalDir, { recursive: true });
+  return tempFinalDir;
+};
+
+export async function downloadTemplate(repoPath) {
+  const packageRoot = path.resolve(__dirname, "../..");
+  const packagedTemplatePath = path.join(packageRoot, repoPath);
+
+  if (fs.existsSync(packagedTemplatePath)) {
+    return packagedTemplatePath;
+  }
+
+  const preferredRef = getTemplateRef();
+  const candidates = [
+    { ref: preferredRef, refType: "tag" },
+    { ref: "main", refType: "branch" },
+  ];
+
+  const uniqueCandidates = candidates.filter(
+    (candidate, index, arr) =>
+      arr.findIndex(
+        (item) =>
+          item.ref === candidate.ref && item.refType === candidate.refType,
+      ) === index,
+  );
+
+  const errors = [];
+
+  for (const candidate of uniqueCandidates) {
+    try {
+      const templatePath = await downloadFromRef({
+        repoPath,
+        ref: candidate.ref,
+        refType: candidate.refType,
+      });
+
+      return templatePath;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      errors.push(`${candidate.refType}:${candidate.ref} -> ${message}`);
+    }
+  }
+
+  throw new Error(
+    `Failed to download template from all sources. ${errors.join(" | ")}`,
+  );
+}

package/src/utils/downloadRepoTemplate.js

@@ -1,45 +0,0 @@
-import axios from "axios";
-import extract from "extract-zip";
-import fs from "fs";
-import path from "path";
-import os from "os";
-import { fileURLToPath } from "url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const owner = "aakash-gupta02";
-const repo = "NeatNode";
-
-const zipUrl = `https://codeload.github.com/${owner}/${repo}/zip/refs/heads/main`;
-
-export async function downloadTemplate(repoPath) {
-  // SAFE TEMP DIRECTORY
-  const tmpBase = fs.mkdtempSync(path.join(os.tmpdir(), "neatnode-"));
-
-  const tempZip = path.join(tmpBase, "repo.zip");
-  const tempExtractDir = path.join(tmpBase, "repo-extract");
-  const tempFinalDir = path.join(tmpBase, "template-final");
-
-  // download zip
-  const response = await axios({
-    url: zipUrl,
-    responseType: "arraybuffer",
-  });
-
-  fs.writeFileSync(tempZip, response.data);
-
-  // unzip
-  await extract(tempZip, { dir: tempExtractDir });
-
-  const extractedRoot = path.join(tempExtractDir, `${repo}-main`);
-  const srcTemplatePath = path.join(extractedRoot, repoPath);
-
-  // copy template
-  fs.mkdirSync(tempFinalDir, { recursive: true });
-  fs.cpSync(srcTemplatePath, tempFinalDir, { recursive: true });
-
-  console.log("✔ Template downloaded & extracted");
-
-  return tempFinalDir;
-}