From d75b4eb2a9448e663576277666fd5d60588e053f Mon Sep 17 00:00:00 2001
From: Gleb Volkov <glebusheg@gmail.com>
Date: Fri, 8 Aug 2025 14:17:26 +0200
Subject: [PATCH] Add debug flag to GDJS build script (#7771)

---
 GDJS/README.md        | 22 ++++++++++++++++++++++
 GDJS/scripts/build.js |  4 +++-
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/GDJS/README.md b/GDJS/README.md
index b84061cd95..5df9fbbd21 100644
--- a/GDJS/README.md
+++ b/GDJS/README.md
@@ -26,6 +26,28 @@ The game engine is in the _Runtime_ folder. If you want to work on the engine di
 
 - To launch type checking with TypeScript, run `npm install` and `npm run check-types` in `GDJS` folder.
 
+#### Building GDJS Runtime
+
+To build the GDJS Runtime, run `npm run build` in the `GDJS` folder.
+
+**Build Options:**
+
+- **Production build (default)**: `npm run build` - builds with minification enabled
+- **Debug build**: `npm run build -- --debug` - builds without minification for easier debugging
+- **Custom output path**: `npm run build -- --out=/path/to/output` - specify custom output directory
+
+**Examples:**
+```bash
+# Standard production build
+npm run build
+
+# Debug build for development (no minification)
+npm run build -- --debug
+
+# Debug build with custom output path
+npm run build -- --debug --out=./debug-build
+```
+
 ### GDJS Platform (exporters, code generation...)
 
 Check the [GDJS Platform](https://docs.gdevelop.io/GDJS%20Documentation/index.html) documentation or the [full GDevelop developers documentation](https://docs.gdevelop.io/).
diff --git a/GDJS/scripts/build.js b/GDJS/scripts/build.js
index f4647189d6..592fabc4cf 100644
--- a/GDJS/scripts/build.js
+++ b/GDJS/scripts/build.js
@@ -7,6 +7,8 @@ const {
 } = require('./lib/runtime-files-list');
 const args = require('minimist')(process.argv.slice(2), {
   string: ['out'],
+  boolean: ['debug'],
+  default: { debug: false }
 });
 const fs = require('fs').promises;
 
@@ -52,7 +54,7 @@ shell.mkdir('-p', bundledOutPath);
         return build({
           sourcemap: true,
           entryPoints: [inPath],
-          minify: true,
+          minify: !args.debug,
           outfile: renameBuiltFile(outPath),
         }).catch(() => {
           // Error is already logged by esbuild.