gib-runs 2.3.5 → 2.3.7

package/.gib-runs.json.example

@@ -0,0 +1,21 @@
+{
+  "port": 8080,
+  "host": "0.0.0.0",
+  "open": true,
+  "logLevel": 2,
+  "compression": true,
+  "cors": false,
+  "spa": false,
+  "watch": ["src", "public", "dist"],
+  "ignore": ["*.test.js", "*.spec.js", "*.map"],
+  "middleware": [],
+  "wait": 100,
+  "noCssInject": false,
+  "qrCode": false,
+  "tunnel": false,
+  "autoRestart": false,
+  "enableUpload": false,
+  "enableHealth": true,
+  "logToFile": false,
+  "customErrorPage": true
+}

package/CHANGELOG.md

@@ -2,7 +2,23 @@
 
 All notable changes to this project will be documented in this file.
 
-## [2.3.5] - 2026-02-12
+## [2.3.7] - 2026-02-13
+
+### Added
+- 📁 **Project-Level Config File** - Support for `.gib-runs.json` in project root
+  - Overrides global config (`~/.gib-runs.json`)
+  - Priority: Project config > Global config > CLI args > Defaults
+  - Perfect for team-shared project settings
+- 🎯 **Improved Watch Ignore Patterns** - Better file watching performance
+  - Auto-ignore common directories: `node_modules`, `.git`, `dist`, `build`, `coverage`, `.next`, `.nuxt`, `.output`, `out`, `target`
+  - Prevents unnecessary reloads from build artifacts
+  - Reduces CPU usage during development
+- ⚡ **Enhanced File Watching Stability** - More reliable change detection
+  - Added `awaitWriteFinish` option to prevent partial file reads
+  - Ignores permission errors automatically
+  - Debounced file changes for better performance
+
+## [2.3.6] - 2026-02-12
 
 ### Added
 - 🔄 **Environment Variable Replacement** - Automatic replacement of `${VAR_NAME}` patterns in HTML files

package/README.md

@@ -3,7 +3,7 @@
 [![license](https://img.shields.io/npm/l/gib-runs.svg)](https://github.com/levouinse/gib-runs/blob/main/LICENSE)
 [![tests](https://img.shields.io/badge/tests-32%20passing-brightgreen.svg)](https://github.com/levouinse/gib-runs)
 
-# 🚀 GIB-RUNS v2.3.5
+# 🚀 GIB-RUNS v2.3.7
 
 **Modern development server with live reload - Unlike some people, this actually runs on merit, not connections.**
 
@@ -61,10 +61,13 @@ The name is a playful nod to Indonesia's Vice President Gibran Rakabuming Raka,
 - 🚦 **Rate Limiting** - Protect against abuse (better protection than family connections)
 - 🌐 **Network Access** - True network binding that actually works (unlike some political promises)
 
-### New in v2.3.5 🎉
-- 🔄 **Environment Variable Replacement** - Automatic replacement of `${VAR_NAME}` in HTML files from .env
+### New in v2.3.7 🎉
+- 📁 **Project-Level Config File** - `.gib-runs.json` in project root (overrides global config)
+- 🎯 **Improved Watch Ignore** - Auto-ignore common directories (node_modules, dist, build, etc)
+- ⚡ **Enhanced File Watching** - Better stability with awaitWriteFinish option
 
-### New in v2.3.5 🎉
+### New in v2.3.6 🎉
+- 🔄 **Environment Variable Replacement** - Automatic replacement of `${VAR_NAME}` in HTML files from .env
 - 🔁 **Auto-Restart on Crash** - Automatically restart server on unexpected errors (resilient mode)
 - 📤 **File Upload Endpoint** - Built-in file upload support for development (POST to /upload)
 - 💚 **Health Check Endpoint** - Monitor server health and statistics (GET /health)
@@ -226,7 +229,7 @@ const server = gibRun.start({
 
 ### Configuration File
 
-Create `~/.gib-runs.json` for default settings:
+Create `~/.gib-runs.json` for global default settings:
 
 ```json
 {
@@ -239,6 +242,20 @@ Create `~/.gib-runs.json` for default settings:
 }
 ```
 
+Or create `.gib-runs.json` in your project root for project-specific settings (overrides global config):
+
+```json
+{
+  "port": 3000,
+  "spa": true,
+  "watch": ["src", "public"],
+  "ignore": ["*.test.js", "*.spec.js"],
+  "middleware": ["performance", "security"]
+}
+```
+
+**Priority**: Project config > Global config > CLI arguments > Defaults
+
 ## 🔒 HTTPS Configuration
 
 Create an HTTPS configuration module:
@@ -389,7 +406,7 @@ gib-runs
 Network URLs are **ALWAYS shown automatically** when you start the server:
 
 ```
-🚀 GIB-RUNS v2.3.5
+🚀 GIB-RUNS v2.3.7
 "Unlike Gibran, this actually works through merit"
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   📁 Root:       /home/user/project
@@ -508,7 +525,7 @@ gib-runs --tunnel-service=tunnelto
 ### Example Output
 
 ```
-🚀 GIB-RUNS v2.3.5
+🚀 GIB-RUNS v2.3.7
 "Unlike Gibran, this actually works through merit"
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   📁 Root:       /home/user/project
@@ -638,7 +655,7 @@ pm2 list
 ### Example Output
 
 ```
-🚀 GIB-RUNS v2.3.5
+🚀 GIB-RUNS v2.3.7
 "Unlike Gibran, this actually works through merit"
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   📁 Root:       /home/user/project
@@ -665,7 +682,7 @@ pm2 list
 
 **Unlike Gibran's career, these processes run on actual merit and capability!** 🔥
 
-## 🆕 New Features in v2.3.5
+## 🆕 New Features in v2.3.6
 
 ### Auto-Restart on Crash
 

package/gib-run.js

@@ -23,6 +23,14 @@ if (fs.existsSync(configPath)) {
 	if (opts.ignorePattern) opts.ignorePattern = new RegExp(opts.ignorePattern);
 }
 
+// Project-level config (overrides global config)
+var projectConfigPath = path.join(process.cwd(), '.gib-runs.json');
+if (fs.existsSync(projectConfigPath)) {
+	var projectConfig = fs.readFileSync(projectConfigPath, 'utf8');
+	assign(opts, JSON.parse(projectConfig));
+	if (opts.ignorePattern) opts.ignorePattern = new RegExp(opts.ignorePattern);
+}
+
 for (var i = process.argv.length - 1; i >= 2; --i) {
 	var arg = process.argv[i];
 	if (arg.indexOf("--port=") > -1) {

package/index.js

@@ -74,12 +74,6 @@ function staticServer(root) {
 			if (hasNoOrigin && (possibleExtensions.indexOf(x) > -1)) {
 				// TODO: Sync file read here is not nice, but we need to determine if the html should be injected or not
 				var contents = fs.readFileSync(filepath, "utf8");
-				
-				// Replace environment variables like ${APP_NAME}
-				contents = contents.replace(/\$\{([A-Z_]+)\}/g, function(fullMatch, varName) {
-					return process.env[varName] || fullMatch;
-				});
-				
 				for (var i = 0; i < injectCandidates.length; ++i) {
 					match = injectCandidates[i].exec(contents);
 					if (match) {
@@ -106,12 +100,14 @@ function staticServer(root) {
 				res.setHeader('Content-Length', len);
 				var originalPipe = stream.pipe;
 				stream.pipe = function(resp) {
-					// Replace ${ENV_VAR} then inject code
-					var envReplace = es.replace(/\$\{([A-Z_]+)\}/g, function(match, varName) {
-						return process.env[varName] || match;
+					// Replace environment variables ${VAR_NAME} with actual values
+					var envReplacer = es.mapSync(function(data) {
+						return data.toString().replace(/\$\{([^}]+)\}/g, function(match, varName) {
+							return process.env[varName] || '';
+						});
 					});
 					var codeInject = es.replace(new RegExp(injectTag, "i"), INJECTED_CODE + injectTag);
-					originalPipe.call(stream, envReplace).pipe(codeInject).pipe(resp);
+					originalPipe.call(stream, envReplacer).pipe(codeInject).pipe(resp);
 				};
 			}
 		}
@@ -631,6 +627,9 @@ GibRuns.start = function(options) {
 		},
 		function(testPath) { // Ignore common build artifacts
 			return /\.(log|lock|tmp)$/.test(testPath);
+		},
+		function(testPath) { // Ignore common directories
+			return /(^|\/)((node_modules|\.git|dist|build|coverage|\.next|\.nuxt|\.output|out|target)(\/|$))/.test(testPath);
 		}
 	];
 	if (options.ignore) {
@@ -642,7 +641,12 @@ GibRuns.start = function(options) {
 	// Setup file watcher
 	GibRuns.watcher = chokidar.watch(watchPaths, {
 		ignored: ignored,
-		ignoreInitial: true
+		ignoreInitial: true,
+		ignorePermissionErrors: true,
+		awaitWriteFinish: {
+			stabilityThreshold: 100,
+			pollInterval: 50
+		}
 	});
 	function handleChange(changePath) {
 		GibRuns.reloadCount++;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gib-runs",
-  "version": "2.3.5",
+  "version": "2.3.7",
   "description": "Modern development server with live reload, hot module replacement, and advanced features for all project types - runs on merit, not nepotism",
   "keywords": [
     "development",
@@ -28,13 +28,13 @@
     "compression": "^1.7.4",
     "connect": "^3.7.0",
     "cors": "^2.8.5",
-    "dotenv": "^16.0.3",
+    "dotenv": "^16.6.1",
     "event-stream": "^4.0.1",
     "faye-websocket": "^0.11.4",
     "http-auth": "^4.2.0",
     "localtunnel": "^2.0.2",
     "morgan": "^1.10.0",
-    "multer": "^1.4.5-lts.1",
+    "multer": "^2.0.2",
     "object-assign": "^4.1.1",
     "open": "^8.4.2",
     "ora": "^5.4.1",