feat(server): add BASE_PATH environment variable support

src/Ivy/Core/Server/ServerUtils.cs

@@ -41,6 +41,7 @@ public static ServerArgs GetArgs()
             TestConnection = parser.GetValue<string?>(parsedArgs, "test-connection", null),
             EnableDevTools = parser.GetValue(parsedArgs, "enable-dev-tools", false),
             Host = parser.GetValue<string?>(parsedArgs, "host", null),
+            BasePath = parser.GetValue<string?>(parsedArgs, "path-base", null),
         };
         serverArgs = serverArgs with { FindAvailablePort = parser.GetValue(parsedArgs, "find-available-port", false) };
         if (serverArgs.IsCliCommand)

src/Ivy/Server.cs

@@ -59,7 +59,12 @@
 #endif
     public string? Host { get; set; } = null;
 
+    /// <summary>
+    /// Base path for the application when running behind a reverse proxy (e.g., "/myapp").
+    /// </summary>
+    public string? BasePath { get; set; } = null;
+
     /// <summary>
     /// True when the process is running a CLI-only command (--describe, --describe-connection, --test-connection)
     /// that needs DI but should not bind a real port.
     /// </summary>
@@ -108,6 +113,11 @@
             _args = _args with { Host = host };
         }
 
+        if (_args.BasePath == null && Environment.GetEnvironmentVariable("BASE_PATH") is { } basePath)
+        {
+            _args = _args with { BasePath = basePath };
+        }
+
         _args = _args with
         {
             AssetAssembly = _args.AssetAssembly ?? Assembly.GetCallingAssembly(),
@@ -765,6 +775,11 @@
             app.UseHttpsRedirection();
         }
 
+        if (!string.IsNullOrEmpty(_args.BasePath))
+        {
+            app.UsePathBase(_args.BasePath);
+        }
+
         var logger = _args.Verbose ? app.Services.GetRequiredService<ILogger<Server>>() : new NullLogger<Server>();