From 6a71663236b8bf4038b03c28643e5226f392692d Mon Sep 17 00:00:00 2001
From: Melvin Chia <melvinchia623600@gmail.com>
Date: Fri, 28 Nov 2025 16:43:09 +0800
Subject: [PATCH] fix(build): update bun install command to use --linker
 isolated in build workflows and module commands

---
 .github/workflows/build.yml                         |  4 ++--
 .../contents/01.getting-started/04.Deployment.mdx   |  2 +-
 server/README.md                                    | 13 -------------
 .../commands/module-commands/commands/add-module.ts |  2 +-
 .../module-commands/commands/create-module.ts       |  2 +-
 .../module-commands/commands/update-module.ts       |  2 +-
 6 files changed, 6 insertions(+), 19 deletions(-)
 delete mode 100644 server/README.md

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index daf11036a..bc970f497 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -23,7 +23,7 @@ jobs:
           bun-version: latest
 
       - name: Install dependencies
-        run: bun upgrade && bun install
+        run: bun upgrade && bun install --linker isolated
 
       - name: Type check server
         run: bun run forge types server
@@ -45,7 +45,7 @@ jobs:
           bun-version: latest
 
       - name: Install dependencies
-        run: bun upgrade && bun install
+        run: bun upgrade && bun install --linker isolated
 
       - name: Build client
         run: bun run forge build client
diff --git a/docs/src/contents/01.getting-started/04.Deployment.mdx b/docs/src/contents/01.getting-started/04.Deployment.mdx
index 6fab63c72..96041091a 100644
--- a/docs/src/contents/01.getting-started/04.Deployment.mdx
+++ b/docs/src/contents/01.getting-started/04.Deployment.mdx
@@ -29,7 +29,7 @@ However, as of October 2025, Vercel and Netlify do not yet support Bun v1.3.0 in
 In Vercel, head to the project settings, and under the **Build & Development Settings** section, override the **Install Command** to the following:
 
 <Code language="bash">
-{`bun upgrade && bun install`}
+{`bun upgrade && bun install --linker isolated`}
 </Code>
 
 As shown in the image below:
diff --git a/server/README.md b/server/README.md
deleted file mode 100644
index d950ba62e..000000000
--- a/server/README.md
+++ /dev/null
@@ -1,13 +0,0 @@
-To install dependencies:
-
-```sh
-bun install
-```
-
-To run:
-
-```sh
-bun run dev
-```
-
-open http://localhost:3000
diff --git a/tools/forgeCLI/src/commands/module-commands/commands/add-module.ts b/tools/forgeCLI/src/commands/module-commands/commands/add-module.ts
index 7b482eb20..a7aa4c892 100644
--- a/tools/forgeCLI/src/commands/module-commands/commands/add-module.ts
+++ b/tools/forgeCLI/src/commands/module-commands/commands/add-module.ts
@@ -105,7 +105,7 @@ function installDependencies(): void {
   CLILoggingService.progress('Installing dependencies')
 
   try {
-    executeCommand('bun install', {
+    executeCommand('bun install --linker isolated', {
       stdio: ['ignore', 'ignore', 'ignore'],
       exitOnError: false
     })
diff --git a/tools/forgeCLI/src/commands/module-commands/commands/create-module.ts b/tools/forgeCLI/src/commands/module-commands/commands/create-module.ts
index 87e0cc824..31c753a93 100644
--- a/tools/forgeCLI/src/commands/module-commands/commands/create-module.ts
+++ b/tools/forgeCLI/src/commands/module-commands/commands/create-module.ts
@@ -364,7 +364,7 @@ function initializeGitRepository(modulePath: string): void {
 function installDependencies(): void {
   CLILoggingService.step('Installing module dependencies...')
 
-  executeCommand('bun install', {
+  executeCommand('bun install --linker isolated', {
     cwd: `${process.cwd()}/apps`,
     stdio: 'ignore'
   })
diff --git a/tools/forgeCLI/src/commands/module-commands/commands/update-module.ts b/tools/forgeCLI/src/commands/module-commands/commands/update-module.ts
index 5bb1f436b..6b424d752 100644
--- a/tools/forgeCLI/src/commands/module-commands/commands/update-module.ts
+++ b/tools/forgeCLI/src/commands/module-commands/commands/update-module.ts
@@ -91,7 +91,7 @@ async function updateSingleModule(moduleName: string): Promise<void> {
 
   try {
     executeCommand(
-      `cd apps/${moduleName} && git pull origin main && bun install`
+      `cd apps/${moduleName} && git pull origin main && bun install --linker isolated`
     )
 
     if (fs.existsSync(`apps/${moduleName}/server/schema.ts`)) {