4bnode 4.0.4 → 4.0.5

package/README.md

@@ -180,22 +180,16 @@ Access at `http://localhost:3000/_dev` when running `npm run dev`.
 ```
 my-app/
 ├── index.js                    # Express app entry point
-├── dev-api.js                  # Dev dashboard API (auto-included)
 ├── package.json
 ├── .env.development            # Dev environment variables
 ├── .env.production             # Production environment variables
-├── .4bnode/                    # Dashboard data (tester, shared collections)
+├── .4bnode/                    # Dashboard engine & data (managed by 4bnode)
 ├── public/                     # Static files
-│   ├── index.html              # Dashboard UI
-│   ├── fonts/
-│   └── images/
-├── uploads/                    # File uploads (when using multer)
+│   └── index.html              # App status landing page
 └── src/
     ├── db.js                   # MongoDB connection (after `add mongo`)
     ├── models/                 # Mongoose schemas
-    ├── routes/                 # API route files
-    └── middleware/
-        └── auth.js             # JWT auth middleware (after `add login`)
+    └── routes/                 # API route files
 ```
 
 ## Real-time Communication

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "4bnode",
-  "version": "4.0.4",
+  "version": "4.0.5",
   "description": "4bnode is a CLI-powered backend development platform with a built-in visual dashboard to generate, manage, and test Node.js/Express APIs faster.",
   "main": "index.js",
   "type": "module",

package/skeleton/.env.example

@@ -0,0 +1,29 @@
+# ──────────────────────────────────────────────────
+# 4Brains Node project — environment variables
+#
+# Copy this file:
+#   cp .env.example .env.development
+# then fill in real values for local dev.
+#
+# Production values are managed in IntraApp:
+#   IntraApp → Deployments → <your-app> → ⋯ → Environment variables
+# ──────────────────────────────────────────────────
+
+# --- Runtime ---
+NODE_ENV=development
+PORT=3000
+
+# --- Database (uncomment after `4bnode add mongo`) ---
+# MONGO_URI=mongodb://127.0.0.1:27017/your-db-name
+
+# --- Auth (uncomment after `4bnode add login`) ---
+# JWT_SECRET=replace-with-a-long-random-string-min-32-chars
+
+# --- External services (uncomment as you add them) ---
+# SMTP_HOST=
+# SMTP_PORT=
+# SMTP_USER=
+# SMTP_PASSWORD=
+# TWILIO_ACCOUNT_SID=
+# TWILIO_AUTH_TOKEN=
+# MICROSOFT_CLIENT_ID=

package/skeleton/README.md

@@ -0,0 +1,65 @@
+# node-skeleton-app
+
+Express 5 + Dotenv + CORS app, scaffolded by [4bnode](https://github.com/pawan-4brains/4bnode).
+
+## Bootstrap (new machine / fresh clone)
+
+### 1. Install dependencies
+
+```bash
+npm install
+```
+
+### 2. Get the env file
+
+This project keeps secrets out of git. Pick the source that applies:
+
+| You are | Get values from |
+|---|---|
+| Setting up local dev | Bitwarden item: **`4bnode-<project-name> · .env.development`** |
+| Bringing up a new prod deployment | IntraApp → Deployments → `<deployment>` → Environment variables |
+| You have neither | Ping #dev-platform on Slack with the project name |
+
+Once you have the values:
+
+```bash
+cp .env.example .env.development
+# then edit .env.development and fill in the real values
+```
+
+### 3. Run it
+
+```bash
+npm run dev
+```
+
+The app starts at `http://localhost:$PORT` and the dev dashboard at `http://localhost:$PORT/_dev`.
+
+### 4. When you add a new env variable
+
+1. Add it to your local `.env.development` with a real value.
+2. Add it to `.env.example` with a placeholder. Commit the change.
+3. Add the real production value in **IntraApp → Environment variables**.
+4. Update the Bitwarden item if other devs need the same value locally.
+
+This four-step rule keeps every developer in sync without ever touching git history.
+
+## Project structure
+
+```
+.
+├── index.js              # Express app entry point
+├── package.json
+├── .env.example          # Committed — documents required keys
+├── .env.development      # Gitignored — your local values
+├── .4bnode/              # Dashboard engine & data (managed by 4bnode)
+├── public/               # Static files
+└── src/
+    ├── db.js             # MongoDB connection (after `4bnode add mongo`)
+    ├── models/           # Mongoose schemas
+    └── routes/           # API route files
+```
+
+## Extending with 4bnode
+
+Run `4bnode add` inside this project to scaffold MongoDB, CRUD, login, sockets, and more. See the [4bnode README](https://github.com/pawan-4brains/4bnode) for the full feature list.

package/skeleton/index.js

@@ -8,7 +8,8 @@ import { createInterface } from "readline";
 
 // ── Environment ─────────────────────────────────────
 const env = process.env.NODE_ENV || "development";
-dotenv.config({ path: `.env.${env}` });
+dotenv.config({ path: `.env.${env}` }); // local dev: .env.development / .env.production
+dotenv.config();                        // IntraApp prod: plain .env (won't override existing)
 
 const app = express();
 const port = process.env.PORT || 3000;
@@ -86,6 +87,11 @@ async function startServer(tryPort) {
   });
   listener.on("error", async (err) => {
     if (err.code === "EADDRINUSE") {
+      if (!process.stdin.isTTY) {
+        // Running under pm2 / systemd / IntraApp — no terminal to prompt.
+        console.error(`Port ${tryPort} is in use and no TTY is available. Exiting.`);
+        process.exit(1);
+      }
       const nextPort = await askPort(tryPort);
       startServer(nextPort);
     } else {

package/skeleton/.env.development

@@ -1 +0,0 @@
-PORT=3000

package/skeleton/.env.production

@@ -1 +0,0 @@
-PORT=3000