gib-runs 2.3.6 → 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,6 +2,22 @@
 
 All notable changes to this project will be documented in this file.
 
+## [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

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.6
+# 🚀 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.6 🎉
-- 🔄 **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.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.6
+🚀 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.6
+🚀 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.6
+🚀 GIB-RUNS v2.3.7
 "Unlike Gibran, this actually works through merit"
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   📁 Root:       /home/user/project

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

@@ -627,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) {
@@ -638,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.6",
+  "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",