nodejs-quickstart-structure 1.9.1 → 1.9.2

package/CHANGELOG.md

@@ -5,6 +5,11 @@ 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.9.2] - 2026-02-23
+### Fixed
+- Fixed an issue where the generator output misleading instructions (`DATABASE_URL`) for standalone `docker run` executions. The CLI success commands and `README.md` now conditionally include dynamic compose network bindings (`--network`) and accurate environment variables matching the user's selected DB stack.
+- Fixed a bug where `DB_PASSWORD` in `database.ts.ejs` and `database.js.ejs` defaulted to `postgres` instead of `root` for PostgreSQL configurations, causing standalone Node local servers (`npm run dev`) to fail connection handshakes with default `docker-compose` clusters. 
+
 ## [1.9.1] - 2026-02-22
 ### Added
 - Implemented **Daily Template Vulnerability Audit** via GitHub Actions (`.github/workflows/daily-audit.yml`). A custom script now parses `package.json.ejs` daily to proactively scan for high-severity vulnerabilities in generated dependencies, ensuring generated projects are eternally secure.

package/bin/index.js

@@ -51,7 +51,23 @@ program
             await generateProject(answers);
 
             console.log(chalk.green('\n✔ Project generated successfully!'));
-            console.log(chalk.cyan(`\nNext steps:\n  cd ${answers.projectName}\n  npm install\n  docker-compose up\n-----------------------\nStart the app manually:\n  cd ${answers.projectName}\n  npm install\n  npm run dev`));
+            
+            let manualStartInstructions = `\nStart the app manually:\n  cd ${answers.projectName}\n  npm install`;
+            
+            const needsInfrastructure = answers.database !== 'None' || answers.caching === 'Redis' || answers.communication === 'Kafka';
+            
+            if (needsInfrastructure) {
+                let servicesToStart = '';
+                if (answers.database !== 'None') servicesToStart += ' db';
+                if (answers.caching === 'Redis') servicesToStart += ' redis';
+                if (answers.communication === 'Kafka') servicesToStart += ' zookeeper kafka';
+                
+                manualStartInstructions += `\n  docker-compose up -d${servicesToStart}  # Start infrastructure first\n  npm run dev`;
+            } else {
+                manualStartInstructions += `\n  npm run dev`;
+            }
+            
+            console.log(chalk.cyan(`\nNext steps:\n  cd ${answers.projectName}\n  npm install\n  docker-compose up\n-----------------------${manualStartInstructions}`));
 
         } catch (error) {
             console.error(chalk.red('Error generating project:'), error);

package/package.json

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

package/templates/common/README.md.ejs

@@ -111,13 +111,50 @@ This project uses **Winston** for structured logging.
 ## 🐳 Docker Deployment
 This project uses a **Multi-Stage Dockerfile** for optimized production images.
 
+<% if (database !== 'None' || caching === 'Redis' || communication === 'Kafka') { -%>
+### 1. Running Locally (Development)
+To run the Node.js application locally while using Docker for the infrastructure (Database, Redis, Kafka, etc.):
+
+```bash
+# Start infrastructure
+docker-compose up -d<% if (database !== 'None') { %> db<% } %><% if (caching === 'Redis') { %> redis<% } %><% if (communication === 'Kafka') { %> zookeeper kafka<% } %>
+
+# Start the application
+npm run dev
+```
+
+### 2. Running the App Container with Compose Infrastructure
+If you want to run the application itself inside a Docker container while connecting to the infrastructure managed by your `docker-compose.yml`:
+
+```bash
+# First, ensure your infrastructure is running
+docker-compose up -d
+
+# Build Production Image
+docker build -t <%= projectName %> .
+
+# Run Container (attached to the compose network)
+docker run -p 3000:3000 --network <%= projectName %>_default \
+<% if (database !== 'None') { -%>
+  -e DB_HOST=db \
+<% } -%>
+<% if (caching === 'Redis') { -%>
+  -e REDIS_HOST=redis \
+<% } -%>
+<% if (communication === 'Kafka') { -%>
+  -e KAFKA_BROKER=kafka:29092 \
+<% } -%>
+  <%= projectName %>
+```
+<% } else { -%>
 ```bash
 # Build Production Image
 docker build -t <%= projectName %> .
 
 # Run Container
-docker run -p 3000:3000 -e DATABASE_URL=... <%= projectName %>
+docker run -p 3000:3000 <%= projectName %>
 ```
+<% } -%>
 
 ## 🔒 Security Features
 -   **Helmet**: Sets secure HTTP headers.

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

@@ -1,14 +1,13 @@
 const { Sequelize } = require('sequelize');
 require('dotenv').config();
 
-// Determine dialect
 <% if (database === 'MySQL') { %>const dialect = 'mysql';<% } -%>
 <% if (database === 'PostgreSQL') { %>const dialect = 'postgres';<% } -%>
 
 const sequelize = new Sequelize(
   process.env.DB_NAME || '<%= dbName %>',
   process.env.DB_USER || '<% if (database === 'MySQL') { %>root<% } else { %>postgres<% } %>',
-  process.env.DB_PASSWORD || '<% if (database === 'MySQL') { %>root<% } else { %>postgres<% } %>',
+  process.env.DB_PASSWORD || '<% if (database === 'MySQL') { %>root<% } else { %>root<% } %>',
   {
     host: process.env.DB_HOST || '127.0.0.1',
     dialect: dialect,

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

@@ -3,14 +3,13 @@ import dotenv from 'dotenv';
 
 dotenv.config();
 
-// Determine dialect
 <% if (database === 'MySQL') { %>const dialect = 'mysql';<% } -%>
 <% if (database === 'PostgreSQL') { %>const dialect = 'postgres';<% } -%>
 
 const sequelize = new Sequelize(
   process.env.DB_NAME || '<%= dbName %>',
   process.env.DB_USER || '<% if (database === 'MySQL') { %>root<% } else { %>postgres<% } %>',
-  process.env.DB_PASSWORD || '<% if (database === 'MySQL') { %>root<% } else { %>postgres<% } %>',
+  process.env.DB_PASSWORD || '<% if (database === 'MySQL') { %>root<% } else { %>root<% } %>',
   {
     host: process.env.DB_HOST || '127.0.0.1',
     dialect: dialect,