nodejs-quickstart-structure 1.11.1 → 1.12.0

package/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.12.0] - 2026-03-04
+### Added
+- **Zod Environment Validation:** Replaced manual `dotenv` process calls in server entry points with a centralized schema parser.
+  - Automatically generates `src/config/env.ts` (or `.js`) evaluating `NODE_ENV`, `PORT`, and strictly mapping database, cache, and Kafka connection definitions gracefully crashing the app at startup if missing.
+- **PM2 Deployment Configuration:** Natively supports PM2 ecosystem clustering for VPS and EC2 configurations out-of-the-box.
+  - Generates `ecosystem.config.js` intelligently mapping dynamic environments for Redis, Databases, and Kafka without user prompts.
+  - Modifies `package.json` with an out-of-the-box `npm run deploy` script bound to `pm2 start ecosystem.config.js --env production`.
+  - Upgraded generated README deployment guides for transparent CLI instruction workflows outlining the contrast between running Docker vs PM2.
+
 ## [1.11.1] - 2026-03-03
 ### Fixed
 - Fixed relative import paths in Clean Architecture JS `error.middleware.js` — changed to correct 3-level relative paths (`../../../`).

package/README.md

@@ -35,6 +35,7 @@ We don't just generate boilerplate; we generate **production-ready** foundations
 -   **🔄 CI/CD Integration**: Pre-configured workflows for **GitHub Actions**, **Jenkins**, and **GitLab CI**.
 -   **⚓ Git Hooks**: `Husky` and `Lint-Staged` to ensure no bad code is ever committed.
 -   **🐳 DevOps**: Highly optimized **Multi-Stage Dockerfile** for small, secure production images.
+-   **🚀 Deployment**: Ship confidently with an integrated **PM2 Ecosystem Configuration** for zero-downtime reloads and robust process management.
 
 ## 🧩 240+ Project Combinations
 
@@ -92,7 +93,6 @@ The generated project will include:
 
 -   `src/`: Source code (controllers, routes, services/use-cases).
 -   `src/errors/`: Custom error classes — `ApiError`, `NotFoundError`, `BadRequestError`.
--   `src/utils/error.middleware.{ts|js}`: Global Express error handler (logs 500s, returns `{ statusCode, message }`).
 -   `flyway/sql/`: SQL migration scripts (if SQL database selected).
 -   `docker-compose.yml`: Services configuration for DB, Flyway, and Kafka.
 -   `package.json`: Dependencies and scripts (`start`, `dev`, `build`).

package/bin/index.js

@@ -52,7 +52,7 @@ program
 
             console.log(chalk.green('\n✔ Project generated successfully!'));
             
-            let manualStartInstructions = `\nStart the app manually:\n  cd ${answers.projectName}\n  npm install`;
+            let manualStartInstructions = `\n${chalk.yellow('Development:')}\n  cd ${answers.projectName}\n  npm install`;
             
             const needsInfrastructure = answers.database !== 'None' || answers.caching === 'Redis' || answers.communication === 'Kafka';
             
@@ -67,7 +67,7 @@ program
                 manualStartInstructions += `\n  npm run dev`;
             }
             
-            console.log(chalk.cyan(`\nNext steps:\n  cd ${answers.projectName}\n  npm install\n  docker-compose up\n-----------------------${manualStartInstructions}`));
+            console.log(chalk.cyan(`\nNext steps:\n  cd ${answers.projectName}\n  npm install\n  docker-compose up\n-----------------------${manualStartInstructions}\n\n${chalk.yellow('Production (PM2):')}\n  npm run build\n  npm run deploy\n  npx pm2 logs`));
 
         } catch (error) {
             console.error(chalk.red('Error generating project:'), error);

package/lib/generator.js

@@ -1,8 +1,8 @@
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { setupProjectDirectory, copyBaseStructure, copyCommonFiles } from './modules/project-setup.js';
-import { renderPackageJson, renderDockerCompose, renderReadme, renderDockerfile, renderProfessionalConfig, setupCiCd, renderTestSample, renderEnvExample } from './modules/config-files.js';
-import { renderIndexFile, renderErrorMiddleware, renderDynamicComponents, renderSwaggerConfig, setupViews as setupSrcViews } from './modules/app-setup.js';
+import { renderPackageJson, renderDockerCompose, renderReadme, renderDockerfile, renderProfessionalConfig, setupCiCd, renderTestSample, renderEnvExample, renderPm2Config } from './modules/config-files.js';
+import { renderIndexFile, renderEnvConfig, renderErrorMiddleware, renderDynamicComponents, renderSwaggerConfig, setupViews as setupSrcViews } from './modules/app-setup.js';
 import { setupDatabase } from './modules/database-setup.js';
 import { setupKafka, setupViews } from './modules/kafka-setup.js';
 import { setupCaching } from './modules/caching-setup.js';
@@ -33,6 +33,9 @@ export const generateProject = async (config) => {
     // 6. Render index file (ts/js)
     await renderIndexFile(templatePath, targetDir, config);
 
+    // 6a. Render Environment Configuration
+    await renderEnvConfig(templatePath, targetDir, config);
+
     // 6a. Render error middleware
     await renderErrorMiddleware(templatePath, targetDir, config);
 
@@ -73,6 +76,9 @@ export const generateProject = async (config) => {
     // 15. Env Example
     await renderEnvExample(templatesDir, targetDir, config);
 
+    // 16. PM2 Configuration
+    await renderPm2Config(templatesDir, targetDir, config);
+
     console.log(`
       ====================================================
              Node.js Project Created Successfully!

package/lib/modules/app-setup.js

@@ -22,6 +22,30 @@ export const renderIndexFile = async (templatePath, targetDir, config) => {
     }
 };
 
+export const renderEnvConfig = async (templatePath, targetDir, config) => {
+    const { language, architecture, database, caching, communication } = config;
+    const envExt = language === 'TypeScript' ? 'ts' : 'js';
+    
+    let configDir = path.join(targetDir, 'src', 'config');
+    if (architecture === 'Clean Architecture' && language === 'JavaScript') {
+        configDir = path.join(targetDir, 'src', 'infrastructure', 'config');
+    }
+
+    const envTemplatePath = path.join(configDir, `env.${envExt}.ejs`);
+    const envDestPath = path.join(configDir, `env.${envExt}`);
+    
+    if (await fs.pathExists(envTemplatePath)) {
+        const envTemplate = await fs.readFile(envTemplatePath, 'utf-8');
+        const envContent = ejs.render(envTemplate, {
+            database,
+            caching,
+            communication
+        });
+        await fs.writeFile(envDestPath, envContent);
+        await fs.remove(envTemplatePath);
+    }
+};
+
 export const renderErrorMiddleware = async (templatePath, targetDir, config) => {
     const { language, architecture } = config;
     const errName = language === 'TypeScript' ? 'error.middleware.ts' : 'error.middleware.js';

package/lib/modules/config-files.js

@@ -59,6 +59,21 @@ export const renderDockerfile = async (templatesDir, targetDir, config) => {
     await fs.writeFile(path.join(targetDir, 'Dockerfile'), dockerfileContent);
 };
 
+export const renderPm2Config = async (templatesDir, targetDir, config) => {
+    const { projectName, database, dbName, communication, language, caching } = config;
+    const pm2ConfigPath = path.join(targetDir, 'ecosystem.config.js');
+    const pm2Template = await fs.readFile(path.join(templatesDir, 'common', 'ecosystem.config.js.ejs'), 'utf-8');
+    const pm2Content = ejs.render(pm2Template, {
+        projectName,
+        database,
+        dbName,
+        communication,
+        language,
+        caching
+    });
+    await fs.writeFile(pm2ConfigPath, pm2Content);
+};
+
 export const renderProfessionalConfig = async (templatesDir, targetDir, language) => {
     const eslintTemplate = await fs.readFile(path.join(templatesDir, 'common', 'eslint.config.mjs.ejs'), 'utf-8');
     const eslintContent = ejs.render(eslintTemplate, { language });
@@ -98,7 +113,8 @@ export const renderTestSample = async (templatesDir, targetDir, language) => {
 
 export const renderEnvExample = async (templatesDir, targetDir, config) => {
     const { database, dbName, communication, projectName, caching } = config;
-    const envPath = path.join(targetDir, '.env.example');
+    const envExamplePath = path.join(targetDir, '.env.example');
+    const envPath = path.join(targetDir, '.env');
     const envTemplate = await fs.readFile(path.join(templatesDir, 'common', '.env.example.ejs'), 'utf-8');
     
     const envContent = ejs.render(envTemplate, {
@@ -109,5 +125,6 @@ export const renderEnvExample = async (templatesDir, targetDir, config) => {
         caching
     });
     
+    await fs.writeFile(envExamplePath, envContent);
     await fs.writeFile(envPath, envContent);
 };

package/lib/modules/kafka-setup.js

@@ -55,21 +55,12 @@ export const setupKafka = async (templatesDir, targetDir, config) => {
         // Cleanup old services folder
         await fs.remove(path.join(targetDir, 'src/services'));
         
-        // Remove src/config if it was only for Kafka and not needed by other parts
-        // But Database setup might assume src/config existence in some templates (though moved to infrastructure/database for clean arch)
-        // Safest to leave src/config if non-empty, or remove if empty. 
-        // For now, mirroring original logic: remove specific REST folders
-        
         // Remove REST-specific folders (Interfaces)
         await fs.remove(path.join(targetDir, 'src/interfaces/routes'));
         await fs.remove(path.join(targetDir, 'src/interfaces/controllers'));
         
-        // Original logic removed src/config entirely for clean arch kafka? 
-        // Let's check original logic: 
-        // await fs.remove(path.join(targetDir, 'src/config'));
-        // Yes, it did.
-         await fs.remove(path.join(targetDir, 'src/config'));
-
+        // Original logic removed src/config entirely, but now we use it for Zod env validation in TS.
+        // We will no longer delete it.
     } else if (architecture === 'MVC' && (!config.viewEngine || config.viewEngine === 'None')) {
         // MVC Cleanup for Kafka Worker (No views)
         await fs.remove(path.join(targetDir, 'src/controllers'));
@@ -84,29 +75,5 @@ export const setupViews = async (templatesDir, targetDir, config) => {
         if (await fs.pathExists(publicDir)) {
             await fs.copy(publicDir, path.join(targetDir, 'public'));
         }
-        
-        // Copy views mapping
-        // Logic handled in database-setup (part of db config block in original) but functionally belongs here or separate.
-        // Original: if (viewEngine && viewEngine !== 'None') await fs.copy(...) inside the DB block for MVC.
-        // We moved it to database-setup.js to match flow, but let's double check if we missed it there.
-        // Checked database-setup.js: It copies views ONLY if database !== 'None' OR if database === 'None'
-        // So it is covered. Ideally it should be here, but for now strict refactor keeps it effectively in DB/structure setup phase.
-        // To be cleaner, we should move the VIEW copying here.
-        
-        // Moving View Copying Check here for better separation:
-        // We need to verify if database-setup.js ALREADY does this. 
-        // In my prev step for database-setup.js, I included logic:
-        // if (architecture === 'MVC') { if (viewEngine...) copy views }
-        // So duplication might occur if I add it here too. 
-        // Let's relies on this module ONLY for public assets for now, or ensure idempotency.
-        
-        // Actually, let's keep it clean. database-setup.js shouldn't handle views. 
-        // I will assume I can update database-setup.js to remove view copying if I put it here?
-        // OR just leave it there for this iteration to avoid breaking changes in flow order.
-        // Let's stick to the original flow where possible, but this module is 'kafka-and-views'.
-        
-        // The original logic had view copying inside the "Database Config" block.
-        // My database-setup.js preserved that. 
-        // So this logic here only handles 'public' folder copying which was Step 8 in original.
     }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodejs-quickstart-structure",
-  "version": "1.11.1",
+  "version": "1.12.0",
   "type": "module",
   "description": "A CLI to scaffold Node.js microservices with MVC or Clean Architecture",
   "main": "bin/index.js",

package/templates/clean-architecture/js/src/index.js.ejs

@@ -4,8 +4,6 @@ const logger = require('./infrastructure/log/logger');
 const { connectKafka, sendMessage } = require('./infrastructure/messaging/kafkaClient');
 <% } -%>
 
-const PORT = process.env.PORT || 3000;
-
 <%_ if (database !== 'None') { -%>
 // Database Sync
 const syncDatabase = async () => {
@@ -21,7 +19,7 @@ const syncDatabase = async () => {
             <%_ } -%>
             logger.info('Database synced');
             // Start the web server after DB sync
-            startServer(PORT);
+            startServer();
             <%_ if (communication === 'Kafka') { -%>
             // Connect Kafka
             connectKafka().then(async () => {
@@ -42,7 +40,7 @@ const syncDatabase = async () => {
 };
 syncDatabase();
 <%_ } else { -%>
-startServer(PORT);
+startServer();
 <%_ if (communication === 'Kafka') { -%>
 // Connect Kafka
 connectKafka().then(async () => {

package/templates/clean-architecture/js/src/infrastructure/config/env.js.ejs

@@ -0,0 +1,47 @@
+const { z } = require('zod');
+const logger = require('../log/logger');
+
+if (process.env.NODE_ENV !== 'production') {
+  require('dotenv').config();
+}
+
+const envSchema = z.object({
+  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+  PORT: z.string().transform(Number).default('3000'),
+<%_ if (database !== 'None') { -%>
+  DB_HOST: z.string(),
+<%_ if (database === 'MySQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'PostgreSQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'MongoDB') { -%>
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } -%>
+<%_ } -%>
+<%_ if (caching === 'Redis') { -%>
+  REDIS_HOST: z.string(),
+  REDIS_PORT: z.string().transform(Number),
+  REDIS_PASSWORD: z.string().optional(),
+<%_ } -%>
+<%_ if (communication === 'Kafka') { -%>
+  KAFKA_BROKER: z.string(),
+<%_ } -%>
+});
+
+const _env = envSchema.safeParse(process.env);
+
+if (!_env.success) {
+  logger.error('❌ Invalid environment variables:', _env.error.format());
+  process.exit(1);
+}
+
+const env = _env.data;
+
+module.exports = { env };

package/templates/clean-architecture/js/src/infrastructure/webserver/middlewares/error.middleware.js

@@ -2,7 +2,8 @@ const logger = require('../../log/logger');
 const { ApiError } = require('../../../errors/ApiError');
 const HTTP_STATUS = require('../../../utils/httpCodes');
 
-const errorMiddleware = (err, req, res, _) => {
+// eslint-disable-next-line no-unused-vars
+const errorMiddleware = (err, req, res, next) => {
   let error = err;
 
   if (!(error instanceof ApiError)) {

package/templates/clean-architecture/js/src/infrastructure/webserver/server.js.ejs

@@ -1,6 +1,5 @@
 const express = require('express');
 const cors = require('cors');
-require('dotenv').config();
 const logger = require('../log/logger');
 const morgan = require('morgan');
 const { errorMiddleware } = require('./middlewares/error.middleware');
@@ -19,7 +18,11 @@ const { typeDefs, resolvers } = require('../../interfaces/graphql');
 const { gqlContext } = require('../../interfaces/graphql/context');
 <%_ } -%>
 
-const startServer = async (port) => {
+const { env } = require('../config/env');
+
+const startServer = async () => {
+    // Determine port using the validated env
+    const port = env.PORT;
     const app = express();
 
     app.use(cors());

package/templates/clean-architecture/js/src/interfaces/graphql/resolvers/user.resolvers.js.ejs

@@ -12,7 +12,10 @@ const userResolvers = {
     createUser: async (_, { name, email }) => {
       return await userController.createUser({ name, email });
     }
-  }
+  }<%_ if (database === 'MongoDB') { -%>,
+  User: {
+    id: (parent) => parent.id || parent._id
+  }<%_ } %>
 };
 
 module.exports = { userResolvers };

package/templates/clean-architecture/ts/src/config/env.ts.ejs

@@ -0,0 +1,46 @@
+import dotenv from 'dotenv';
+import { z } from 'zod';
+import logger from '@/infrastructure/log/logger';
+
+if (process.env.NODE_ENV !== 'production') {
+  dotenv.config();
+}
+
+const envSchema = z.object({
+  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+  PORT: z.string().transform(Number).default('3000'),
+<%_ if (database !== 'None') { -%>
+  DB_HOST: z.string(),
+<%_ if (database === 'MySQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'PostgreSQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'MongoDB') { -%>
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } -%>
+<%_ } -%>
+<%_ if (caching === 'Redis') { -%>
+  REDIS_HOST: z.string(),
+  REDIS_PORT: z.string().transform(Number),
+  REDIS_PASSWORD: z.string().optional(),
+<%_ } -%>
+<%_ if (communication === 'Kafka') { -%>
+  KAFKA_BROKER: z.string(),
+<%_ } -%>
+});
+
+const _env = envSchema.safeParse(process.env);
+
+if (!_env.success) {
+  logger.error('❌ Invalid environment variables:', _env.error.format());
+  process.exit(1);
+}
+
+export const env = _env.data;

package/templates/clean-architecture/ts/src/index.ts.ejs

@@ -3,7 +3,6 @@ import cors from 'cors';
 import helmet from 'helmet';
 import hpp from 'hpp';
 import rateLimit from 'express-rate-limit';
-import dotenv from 'dotenv';
 import logger from '@/infrastructure/log/logger';
 import morgan from 'morgan';
 import { errorMiddleware } from '@/utils/error.middleware';
@@ -20,12 +19,12 @@ import { unwrapResolverError } from '@apollo/server/errors';
 import { ApiError } from '@/errors/ApiError';
 import { typeDefs, resolvers } from '@/interfaces/graphql';
 import { gqlContext, MyContext } from '@/interfaces/graphql/context';
-<% } -%>
+<%_ } -%>
 
-dotenv.config();
+import { env } from '@/config/env';
 
 const app = express();
-const port = process.env.PORT || 3000;
+const port = env.PORT;
 
 // Security Middleware
 <%_ if (communication === 'GraphQL') { -%>
@@ -96,15 +95,13 @@ const startServer = async () => {
     app.listen(port, () => {
         logger.info(`Server running on port ${port}`);
 <%_ if (communication === 'Kafka') { -%>
-        try {
-          const kafkaService = new KafkaService();
-          kafkaService.connect().then(() => {
-            logger.info('Kafka connected');
-            kafkaService.sendMessage('test-topic', 'Hello Kafka from Clean Arch TS!');
-          });
-        } catch (err) {
+        const kafkaService = new KafkaService();
+        kafkaService.connect().then(() => {
+          logger.info('Kafka connected');
+          kafkaService.sendMessage('test-topic', 'Hello Kafka from Clean Arch TS!');
+        }).catch(err => {
           logger.error('Failed to connect to Kafka:', err);
-        }
+        });
 <%_ } -%>
     });
 };

package/templates/clean-architecture/ts/src/interfaces/graphql/resolvers/user.resolvers.ts.ejs

@@ -14,5 +14,8 @@ export const userResolvers = {
       const user = await userController.createUser({ name, email });
       return user;
     }
-  }
+  }<%_ if (database === 'MongoDB') { -%>,
+  User: {
+    id: (parent: { id?: string; _id?: unknown }) => parent.id || parent._id
+  }<%_ } %>
 };

package/templates/clean-architecture/ts/src/utils/error.middleware.ts.ejs

@@ -3,7 +3,8 @@ import logger from '@/infrastructure/log/logger';
 import { ApiError } from '@/errors/ApiError';
 import { HTTP_STATUS } from '@/utils/httpCodes';
 
-export const errorMiddleware = (err: Error, req: Request, res: Response, _: unknown) => {
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export const errorMiddleware = (err: Error, req: Request, res: Response, next: unknown) => {
   let error = err;
 
   if (!(error instanceof ApiError)) {

package/templates/common/.env.example.ejs

@@ -19,7 +19,9 @@ DB_PASSWORD=root
 DB_NAME=<%= dbName %>
 <%_ } -%>
 <%_ if (database === 'MongoDB') { -%>
-DB_URI=mongodb://localhost:27017/<%= dbName %>
+DB_HOST=localhost
+DB_PORT=27017
+DB_NAME=<%= dbName %>
 <%_ } -%>
 <%_ } -%>
 

package/templates/common/README.md.ejs

@@ -183,6 +183,36 @@ docker run -p 3000:3000 <%= projectName %>
 ```
 <% } -%>
 
+## 🚀 PM2 Deployment (VPS/EC2)
+This project is pre-configured for direct deployment to a VPS/EC2 instance using **PM2** (via `ecosystem.config.js`).
+1. Install dependencies
+```bash
+npm install
+```
+2. **Start Infrastructure (DB, Redis, Kafka, etc.) in the background**
+*(This specifically starts the background services without running the application inside Docker, allowing PM2 to handle it).*
+```bash
+docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> zookeeper kafka<% } %>
+```
+3. **Wait 5-10s** for the database to fully initialize.
+4. **Deploy the App using PM2 in Cluster Mode**
+```bash
+<% if (language === 'TypeScript') { %>npm run build
+<% } %>npm run deploy
+```
+5. **Check logs**
+```bash
+npx pm2 logs
+```
+6. Stop and remove the PM2 application
+```bash
+npx pm2 delete <%= projectName %>
+```
+7. Stop and remove the Docker infrastructure
+```bash
+docker-compose down
+```
+
 ## 🔒 Security Features
 -   **Helmet**: Sets secure HTTP headers.
 -   **CORS**: Configured for cross-origin requests.

package/templates/common/database/js/mongoose.js.ejs

@@ -8,7 +8,9 @@ logger = require('../log/logger');
 <% } %>
 const connectDB = async () => {
     const dbHost = process.env.DB_HOST || 'localhost';
-    const mongoURI = process.env.MONGO_URI || `mongodb://${dbHost}:27017/<%= dbName %>`;
+    const dbPort = process.env.DB_PORT || '27017';
+    const dbName = process.env.DB_NAME || '<%= dbName %>';
+    const mongoURI = process.env.MONGO_URI || `mongodb://${dbHost}:${dbPort}/${dbName}`;
     
     let retries = 5;
     while (retries) {

package/templates/common/database/ts/mongoose.ts.ejs

@@ -6,7 +6,9 @@ import logger from '@/infrastructure/log/logger';
 <% } %>
 const connectDB = async (): Promise<void> => {
     const dbHost = process.env.DB_HOST || 'localhost';
-    const mongoURI = process.env.MONGO_URI || `mongodb://${dbHost}:27017/<%= dbName %>`;
+    const dbPort = process.env.DB_PORT || '27017';
+    const dbName = process.env.DB_NAME || '<%= dbName %>';
+    const mongoURI = process.env.MONGO_URI || `mongodb://${dbHost}:${dbPort}/${dbName}`;
     
     let retries = 5;
     while (retries) {

package/templates/common/docker-compose.yml.ejs

@@ -28,10 +28,15 @@ services:
       - DB_USER=root
       - DB_PASSWORD=root
       - DB_NAME=<%= dbName %>
+      - DB_PORT=3306
 <%_ } -%><%_ if (database === 'PostgreSQL') { -%>
       - DB_USER=postgres
       - DB_PASSWORD=root
       - DB_NAME=<%= dbName %>
+      - DB_PORT=5432
+<%_ } -%><%_ if (database === 'MongoDB') { -%>
+      - DB_NAME=<%= dbName %>
+      - DB_PORT=27017
 <%_ } -%>
 <%_ } -%>
 <%_ } else { -%>
@@ -48,10 +53,15 @@ services:
       - DB_USER=root
       - DB_PASSWORD=root
       - DB_NAME=<%= dbName %>
+      - DB_PORT=3306
 <%_ } -%><%_ if (database === 'PostgreSQL') { -%>
       - DB_USER=postgres
       - DB_PASSWORD=root
       - DB_NAME=<%= dbName %>
+      - DB_PORT=5432
+<%_ } -%><%_ if (database === 'MongoDB') { -%>
+      - DB_NAME=<%= dbName %>
+      - DB_PORT=27017
 <%_ } -%>
 <%_ } -%>
 <%_ } -%>
@@ -89,7 +99,7 @@ services:
       - mongodb_data:/data/db
 
   mongo-migrate:
-    image: node:18-alpine
+    image: node:22-alpine
     working_dir: /app
     volumes:
       - .:/app

package/templates/common/ecosystem.config.js.ejs

@@ -0,0 +1,40 @@
+module.exports = {
+  apps: [{
+    name: "<%= projectName %>",
+    script: "<% if (language === 'TypeScript') { %>./dist/index.js<% } else { %>./src/index.js<% } %>", // Entry point
+    instances: "max",           // Run in Cluster Mode to utilize all CPUs (Note: On Windows, cluster mode may throw `spawn wmic ENOENT` errors due to missing WMIC in Windows 11. To fix, change instances to 1, or install wmic)
+    exec_mode: "cluster",
+    watch: false,               // Disable watch in production
+    max_memory_restart: "1G",
+    env_production: {
+      NODE_ENV: "production",
+      PORT: 3000,
+<%_ if (caching === 'Redis') { -%>
+      REDIS_HOST: "127.0.0.1",
+      REDIS_PORT: 6379,
+      REDIS_PASSWORD: "",
+<%_ } -%>
+<%_ if (communication === 'Kafka') { -%>
+      KAFKA_BROKER: "127.0.0.1:9092",
+      KAFKAJS_NO_PARTITIONER_WARNING: 1,
+<%_ } -%>
+<%_ if (database !== 'None') { -%>
+      DB_HOST: "127.0.0.1",
+<%_ if (database === 'MySQL') { -%>
+      DB_USER: "root",
+      DB_PASSWORD: "root",
+      DB_NAME: "<%= dbName %>",
+      DB_PORT: 3306
+<%_ } else if (database === 'PostgreSQL') { -%>
+      DB_USER: "postgres",
+      DB_PASSWORD: "root",
+      DB_NAME: "<%= dbName %>",
+      DB_PORT: 5432
+<%_ } else if (database === 'MongoDB') { -%>
+      DB_NAME: "<%= dbName %>",
+      DB_PORT: 27017
+<%_ } -%>
+<%_ } -%>
+    }
+  }]
+};

package/templates/common/package.json.ejs

@@ -7,6 +7,7 @@
     "start": "<% if (language === 'TypeScript') { %>node dist/index.js<% } else { %>node src/index.js<% } %>",
     "dev": "<% if (language === 'TypeScript') { %>nodemon --exec ts-node -r tsconfig-paths/register src/index.ts<% } else { %>nodemon src/index.js<% } %>"<% if (language === 'TypeScript') { %>,
     "build": "rimraf dist && tsc && tsc-alias<% if (viewEngine && viewEngine !== 'None') { %> && cpx \"src/views/**/*\" dist/views<% } %><% if (communication === 'REST APIs') { %> && cpx \"src/**/*.yml\" dist/<% } %>"<% } %>,
+    "deploy": "npx pm2 start ecosystem.config.js --env production",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write .",
@@ -20,6 +21,7 @@
   "dependencies": {
     "express": "^4.18.2",
     "dotenv": "^16.3.1",
+    "zod": "^3.22.4",
 <% if (database === 'MySQL') { %>    "mysql2": "^3.6.5",
     "sequelize": "^6.35.2",
 <% } -%>
@@ -81,7 +83,7 @@
     "lint-staged": "^15.4.3"<% if (language === 'TypeScript') { %>,
     "typescript-eslint": "^8.24.1",<%_ if (communication === 'REST APIs') { %>
     "@types/swagger-ui-express": "^4.1.6",
-    "@types/yamljs": "^0.2.34",<%_ } -%>
+    "@types/yamljs": "^0.2.34",<%_ } %>
     "jest": "^29.7.0",
     "ts-jest": "^29.2.5",
     "@types/jest": "^29.5.14",

package/templates/mvc/js/src/config/env.js.ejs

@@ -0,0 +1,46 @@
+const { z } = require('zod');
+const logger = require('../utils/logger');
+
+if (process.env.NODE_ENV !== 'production') {
+  require('dotenv').config();
+}
+const envSchema = z.object({
+  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+  PORT: z.string().transform(Number).default('3000'),
+<%_ if (database !== 'None') { -%>
+  DB_HOST: z.string(),
+<%_ if (database === 'MySQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'PostgreSQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'MongoDB') { -%>
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } -%>
+<%_ } -%>
+<%_ if (caching === 'Redis') { -%>
+  REDIS_HOST: z.string(),
+  REDIS_PORT: z.string().transform(Number),
+  REDIS_PASSWORD: z.string().optional(),
+<%_ } -%>
+<%_ if (communication === 'Kafka') { -%>
+  KAFKA_BROKER: z.string(),
+<%_ } -%>
+});
+
+const _env = envSchema.safeParse(process.env);
+
+if (!_env.success) {
+  logger.error('❌ Invalid environment variables:', _env.error.format());
+  process.exit(1);
+}
+
+const env = _env.data;
+
+module.exports = { env };

package/templates/mvc/js/src/graphql/resolvers/user.resolvers.js.ejs

@@ -10,7 +10,10 @@ const userResolvers = {
     createUser: async (_, { name, email }) => {
       return await userController.createUser({ name, email });
     }
-  }
+  }<%_ if (database === 'MongoDB') { -%>,
+  User: {
+    id: (parent) => parent.id || parent._id
+  }<%_ } %>
 };
 
 module.exports = { userResolvers };

package/templates/mvc/js/src/index.js.ejs

@@ -1,6 +1,5 @@
 const express = require('express');
 const cors = require('cors');
-require('dotenv').config();
 <%_ if (communication === 'REST APIs') { -%>const apiRoutes = require('./routes/api');<%_ } -%>
 <%_ if (communication === 'Kafka') { -%>const { connectKafka, sendMessage } = require('./services/kafkaService');<%_ } -%>
 <%_ if (communication === 'GraphQL') { -%>
@@ -16,9 +15,10 @@ const { gqlContext } = require('./graphql/context');
 const swaggerUi = require('swagger-ui-express');
 const swaggerSpecs = require('./config/swagger');
 <%_ } -%>
+const { env } = require('./config/env');
 
 const app = express();
-const PORT = process.env.PORT || 3000;
+const PORT = env.PORT;
 const logger = require('./utils/logger');
 const morgan = require('morgan');
 const { errorMiddleware } = require('./utils/error.middleware');

package/templates/mvc/js/src/utils/error.middleware.js

@@ -2,7 +2,8 @@ const logger = require('./logger');
 const { ApiError } = require('../errors/ApiError');
 const HTTP_STATUS = require('./httpCodes');
 
-const errorMiddleware = (err, req, res, _) => {
+// eslint-disable-next-line no-unused-vars
+const errorMiddleware = (err, req, res, next) => {
   let error = err;
 
   if (!(error instanceof ApiError)) {

package/templates/mvc/ts/src/config/env.ts.ejs

@@ -0,0 +1,45 @@
+import dotenv from 'dotenv';
+import { z } from 'zod';
+import logger from '@/utils/logger';
+
+if (process.env.NODE_ENV !== 'production') {
+  dotenv.config();
+}
+const envSchema = z.object({
+  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+  PORT: z.string().transform(Number).default('3000'),
+<%_ if (database !== 'None') { -%>
+  DB_HOST: z.string(),
+<%_ if (database === 'MySQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'PostgreSQL') { -%>
+  DB_USER: z.string(),
+  DB_PASSWORD: z.string(),
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } else if (database === 'MongoDB') { -%>
+  DB_NAME: z.string(),
+  DB_PORT: z.string().transform(Number),
+<%_ } -%>
+<%_ } -%>
+<%_ if (caching === 'Redis') { -%>
+  REDIS_HOST: z.string(),
+  REDIS_PORT: z.string().transform(Number),
+  REDIS_PASSWORD: z.string().optional(),
+<%_ } -%>
+<%_ if (communication === 'Kafka') { -%>
+  KAFKA_BROKER: z.string(),
+<%_ } -%>
+});
+
+const _env = envSchema.safeParse(process.env);
+
+if (!_env.success) {
+  logger.error('❌ Invalid environment variables:', _env.error.format());
+  process.exit(1);
+}
+
+export const env = _env.data;

package/templates/mvc/ts/src/graphql/resolvers/user.resolvers.ts.ejs

@@ -14,5 +14,8 @@ export const userResolvers = {
       const user = await userController.createUser({ name, email });
       return user;
     }
-  }
+  }<%_ if (database === 'MongoDB') { -%>,
+  User: {
+    id: (parent: { id?: string; _id?: unknown }) => parent.id || parent._id
+  }<%_ } %>
 };

package/templates/mvc/ts/src/index.ts.ejs

@@ -1,9 +1,9 @@
+import { env } from '@/config/env';
 import express, { Request, Response } from 'express';
 import cors from 'cors';
 import helmet from 'helmet';
 import hpp from 'hpp';
 import rateLimit from 'express-rate-limit';
-import dotenv from 'dotenv';
 import logger from '@/utils/logger';
 import morgan from 'morgan';
 import { errorMiddleware } from '@/utils/error.middleware';
@@ -23,10 +23,8 @@ import { typeDefs, resolvers } from '@/graphql';
 import { gqlContext, MyContext } from '@/graphql/context';
 <% } -%>
 
-dotenv.config();
-
 const app = express();
-const port = process.env.PORT || 3000;
+const port = env.PORT;
 
 // Security Middleware
 <%_ if (communication === 'GraphQL') { -%>
@@ -111,15 +109,13 @@ const startServer = async () => {
     app.listen(port, () => {
         logger.info(`Server running on port ${port}`);
 <%_ if (communication === 'Kafka') { -%>
-        try {
-          const kafkaService = new KafkaService();
-          kafkaService.connect().then(() => {
-            logger.info('Kafka connected');
-            kafkaService.sendMessage('test-topic', 'Hello Kafka from MVC TS!');
-          });
-        } catch (err) {
+        const kafkaService = new KafkaService();
+        kafkaService.connect().then(() => {
+          logger.info('Kafka connected');
+          kafkaService.sendMessage('test-topic', 'Hello Kafka from MVC TS!');
+        }).catch(err => {
           logger.error('Failed to connect to Kafka:', err);
-        }
+        });
 <%_ } -%>
     });
 };

package/templates/mvc/ts/src/utils/error.middleware.ts.ejs

@@ -3,7 +3,8 @@ import logger from '@/utils/logger';
 import { ApiError } from '@/errors/ApiError';
 import { HTTP_STATUS } from '@/utils/httpCodes';
 
-export const errorMiddleware = (err: Error, req: Request, res: Response, _: unknown) => {
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export const errorMiddleware = (err: Error, req: Request, res: Response, next: unknown) => {
   let error = err;
 
   if (!(error instanceof ApiError)) {

package/templates/clean-architecture/js/src/domain/repositories/UserRepository.js

@@ -1,9 +0,0 @@
-class UserRepository {
-    async save(user) {
-        // Database logic would go here
-        user.id = Math.floor(Math.random() * 1000);
-        return user;
-    }
-}
-
-module.exports = UserRepository;