From 521e0d792fd5a40f82a4195cf98260995da69f2c Mon Sep 17 00:00:00 2001
From: "anthropic-code-agent[bot]" <242468646+Claude@users.noreply.github.com>
Date: Tue, 14 Apr 2026 06:38:28 +0000
Subject: [PATCH] feat: configure studio to use server mode for app-host
 deployment

- Add .env.production to set VITE_RUNTIME_MODE=server for production builds
- Update .env.example to clarify dev vs production environment variables
- Studio will now connect to app-host API server instead of using MSW when deployed

Agent-Logs-Url: https://github.com/objectstack-ai/framework/sessions/7c42b007-148b-43e2-a418-1cdc3815f3c0

Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>
---
 apps/studio/.env.example    | 10 ++++++----
 apps/studio/.env.production | 16 ++++++++++++++++
 2 files changed, 22 insertions(+), 4 deletions(-)
 create mode 100644 apps/studio/.env.production

diff --git a/apps/studio/.env.example b/apps/studio/.env.example
index 5cff8b487..ccc53b0b7 100644
--- a/apps/studio/.env.example
+++ b/apps/studio/.env.example
@@ -1,9 +1,11 @@
-# Environment Variables
+# Environment Variables for Development
 # Copy this file to .env.local and customize
+#
+# NOTE: .env.production is used for production builds (e.g., app-host deployment)
 
-# Runtime Mode: 'msw' (default) | 'server'
-# - msw: Mock Service Worker with in-browser kernel
-# - server: Connect to real ObjectStack server
+# Runtime Mode: 'msw' (default for dev) | 'server'
+# - 'msw': Mock Service Worker with in-browser kernel (recommended for local dev)
+# - 'server': Connect to real ObjectStack server
 # Also overridable via URL: ?mode=msw|server
 VITE_RUNTIME_MODE=msw
 
diff --git a/apps/studio/.env.production b/apps/studio/.env.production
new file mode 100644
index 000000000..7a0debf79
--- /dev/null
+++ b/apps/studio/.env.production
@@ -0,0 +1,16 @@
+# Production Environment Configuration
+# This file is used during production builds (vite build)
+#
+# When Studio is deployed as part of app-host (examples/app-host),
+# it should run in server mode and connect to the app-host API server
+# instead of using MSW (Mock Service Worker).
+
+# Runtime Mode: 'server' for production deployment
+# - 'server': Connect to real ObjectStack server (app-host API)
+# - 'msw': Mock Service Worker mode (browser-based kernel, for local dev)
+VITE_RUNTIME_MODE=server
+
+# Server URL: Empty string for same-origin (app-host serves both UI and API)
+# The client SDK will use relative URLs (/api/v1/...)
+# Empty string = same origin (recommended for app-host deployment)
+VITE_SERVER_URL=