feat(server): support OPENCODE_WEB_URL for local frontend serving

Author: sjawhar

packages/opencode/src/flag/flag.ts

@@ -69,6 +69,7 @@ export namespace Flag {
   export const OPENCODE_EXPERIMENTAL_MARKDOWN = !falsy("OPENCODE_EXPERIMENTAL_MARKDOWN")
   export const OPENCODE_MODELS_URL = process.env["OPENCODE_MODELS_URL"]
   export const OPENCODE_MODELS_PATH = process.env["OPENCODE_MODELS_PATH"]
+  export const OPENCODE_WEB_URL = process.env["OPENCODE_WEB_URL"]
   export const OPENCODE_DISABLE_CHANNEL_DB = truthy("OPENCODE_DISABLE_CHANNEL_DB")
   export const OPENCODE_SKIP_MIGRATIONS = truthy("OPENCODE_SKIP_MIGRATIONS")
   export const OPENCODE_STRICT_CONFIG_DEPS = truthy("OPENCODE_STRICT_CONFIG_DEPS")

packages/opencode/src/server/server.ts

@@ -557,12 +557,50 @@ export namespace Server {
       )
       .all("/*", async (c) => {
         const path = c.req.path
+        const appDir = Flag.OPENCODE_WEB_URL
 
-        const response = await proxy(`https://app.opencode.ai${path}`, {
+        // Serve from local dist directory if OPENCODE_WEB_URL is a file path
+        if (appDir && !appDir.startsWith("http")) {
+          const fs = await import("fs")
+          const nodePath = await import("path")
+          const mimeTypes: Record<string, string> = {
+            ".html": "text/html",
+            ".js": "application/javascript",
+            ".mjs": "application/javascript",
+            ".css": "text/css",
+            ".json": "application/json",
+            ".svg": "image/svg+xml",
+            ".png": "image/png",
+            ".woff": "font/woff",
+            ".woff2": "font/woff2",
+            ".wasm": "application/wasm",
+            ".onnx": "application/octet-stream",
+          }
+          const getMime = (p: string) => mimeTypes[nodePath.default.extname(p)] || "application/octet-stream"
+          const filePath = nodePath.default.join(appDir, path === "/" ? "index.html" : path)
+          if (fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
+            return new Response(Bun.file(filePath), { headers: { "Content-Type": getMime(filePath) } })
+          }
+          // SPA fallback — only for paths that look like client-side routes
+          const apiPrefixes = ["/global", "/project", "/pty", "/config", "/experimental", "/session", "/permission", "/question", "/provider", "/mcp", "/tui", "/voice", "/tts"]
+          const isApiPath = apiPrefixes.some((prefix) => path.startsWith(prefix))
+          if (!isApiPath) {
+            const indexPath = nodePath.default.join(appDir, "index.html")
+            if (fs.existsSync(indexPath)) {
+              return new Response(Bun.file(indexPath), { headers: { "Content-Type": "text/html" } })
+            }
+          }
+          return c.notFound()
+        }
+
+        const appHost = appDir || "https://app.opencode.ai"
+        const appHostname = new URL(appHost).hostname
+
+        const response = await proxy(`${appHost}${path}`, {
           ...c.req,
           headers: {
             ...c.req.raw.headers,
-            host: "app.opencode.ai",
+            host: appHostname,
           },
         })
         response.headers.set(