4bnode 4.0.3 → 4.0.5

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