fix: make slack management routing configurable

Author: osolmaz

ui/entrypoint.sh

@@ -4,6 +4,7 @@ set -eu
 API_BASE_URL="${SPRITZ_API_BASE_URL:-}"
 WEBSOCKET_BASE_URL="${SPRITZ_UI_WEBSOCKET_BASE_URL:-}"
 CHAT_PATH_PREFIX="${SPRITZ_UI_CHAT_PATH_PREFIX:-}"
+SLACK_GATEWAY_BASE_PATH="${SPRITZ_UI_SLACK_GATEWAY_BASE_PATH:-}"
 OWNER_ID="${SPRITZ_UI_OWNER_ID:-}"
 AUTH_MODE="${SPRITZ_UI_AUTH_MODE:-}"
 AUTH_TOKEN_STORAGE="${SPRITZ_UI_AUTH_TOKEN_STORAGE:-}"
@@ -38,6 +39,9 @@ fi
 if [ -z "$CHAT_PATH_PREFIX" ]; then
   CHAT_PATH_PREFIX="/c"
 fi
+if [ -z "$SLACK_GATEWAY_BASE_PATH" ]; then
+  SLACK_GATEWAY_BASE_PATH="/slack-gateway"
+fi
 if [ -z "$ASSET_VERSION" ]; then
   ASSET_VERSION="$(date +%s)"
 fi
@@ -49,6 +53,7 @@ escape_sed() {
 API_BASE_URL_ESCAPED="$(escape_sed "$API_BASE_URL")"
 WEBSOCKET_BASE_URL_ESCAPED="$(escape_sed "$WEBSOCKET_BASE_URL")"
 CHAT_PATH_PREFIX_ESCAPED="$(escape_sed "$CHAT_PATH_PREFIX")"
+SLACK_GATEWAY_BASE_PATH_ESCAPED="$(escape_sed "$SLACK_GATEWAY_BASE_PATH")"
 OWNER_ID_ESCAPED="$(escape_sed "$OWNER_ID")"
 AUTH_MODE_ESCAPED="$(escape_sed "$AUTH_MODE")"
 AUTH_TOKEN_STORAGE_ESCAPED="$(escape_sed "$AUTH_TOKEN_STORAGE")"
@@ -80,6 +85,7 @@ ASSET_VERSION_ESCAPED="$(escape_sed "$ASSET_VERSION")"
 sed "s|__SPRITZ_API_BASE_URL__|${API_BASE_URL_ESCAPED}|g" "${HTML_DIR}/config.js" \
   | sed "s|__SPRITZ_UI_WEBSOCKET_BASE_URL__|${WEBSOCKET_BASE_URL_ESCAPED}|g" \
   | sed "s|__SPRITZ_UI_CHAT_PATH_PREFIX__|${CHAT_PATH_PREFIX_ESCAPED}|g" \
+  | sed "s|__SPRITZ_UI_SLACK_GATEWAY_BASE_PATH__|${SLACK_GATEWAY_BASE_PATH_ESCAPED}|g" \
   | sed "s|__SPRITZ_OWNER_ID__|${OWNER_ID_ESCAPED}|g" \
   | sed "s|__SPRITZ_UI_AUTH_MODE__|${AUTH_MODE_ESCAPED}|g" \
   | sed "s|__SPRITZ_UI_AUTH_TOKEN_STORAGE__|${AUTH_TOKEN_STORAGE_ESCAPED}|g" \

ui/public/config.js

@@ -2,6 +2,7 @@ window.SPRITZ_CONFIG = {
   apiBaseUrl: '__SPRITZ_API_BASE_URL__',
   websocketBaseUrl: '__SPRITZ_UI_WEBSOCKET_BASE_URL__',
   chatPathPrefix: '__SPRITZ_UI_CHAT_PATH_PREFIX__',
+  slackGatewayBasePath: '__SPRITZ_UI_SLACK_GATEWAY_BASE_PATH__',
   ownerId: '__SPRITZ_OWNER_ID__',
   presets: __SPRITZ_UI_PRESETS__,
   repoDefaults: {

ui/src/App.tsx

@@ -8,6 +8,7 @@ import { CreatePage } from '@/pages/create';
 import { SettingsPage } from '@/pages/settings';
 import { TerminalPage } from '@/pages/terminal';
 import { chatCatchAllRoutePath } from '@/lib/urls';
+import { slackGatewayBasePath } from '@/lib/slack-management';
 
 /**
  * Maps legacy SPA-mounted Slack gateway paths to the real server-rendered
@@ -18,7 +19,12 @@ export function buildLegacySlackGatewayRedirectURL(
   search: string,
   hash: string,
 ): string {
-  const nextPath = pathname.startsWith('/spritz/') ? pathname.slice('/spritz'.length) : pathname;
+  const legacyPrefix = '/spritz/slack-gateway';
+  const nextPath = pathname.startsWith(legacyPrefix)
+    ? `${slackGatewayBasePath()}${pathname.slice(legacyPrefix.length)}`
+    : pathname.startsWith('/spritz/')
+      ? pathname.slice('/spritz'.length)
+      : pathname;
   return `${nextPath}${search}${hash}`;
 }
 
@@ -35,9 +41,14 @@ function LegacySlackGatewayRedirectPage() {
   const location = useLocation();
 
   if (typeof window !== 'undefined') {
-    browserLocation.replace(
-      buildLegacySlackGatewayRedirectURL(location.pathname, location.search, location.hash),
+    const redirectURL = buildLegacySlackGatewayRedirectURL(
+      location.pathname,
+      location.search,
+      location.hash,
     );
+    if (redirectURL !== `${location.pathname}${location.search}${location.hash}`) {
+      browserLocation.replace(redirectURL);
+    }
   }
 
   return null;

ui/src/lib/config.ts

@@ -84,6 +84,7 @@ export interface SpritzConfig {
   apiBaseUrl: string;
   websocketBaseUrl: string;
   chatPathPrefix: string;
+  slackGatewayBasePath: string;
   ownerId: string;
   presets: Preset[] | string;
   repoDefaults: RepoDefaults;
@@ -105,6 +106,7 @@ export function resolveConfig(raw: RawSpritzConfig = {}): SpritzConfig {
     apiBaseUrl: raw.apiBaseUrl || '',
     websocketBaseUrl: raw.websocketBaseUrl || '',
     chatPathPrefix: raw.chatPathPrefix || '/c',
+    slackGatewayBasePath: raw.slackGatewayBasePath || '/slack-gateway',
     ownerId: raw.ownerId || '',
     presets: raw.presets || [],
     repoDefaults: {

ui/src/lib/slack-management.ts

@@ -1,3 +1,5 @@
+import { config } from './config';
+
 export interface SlackInstallTargetProfile {
   name: string;
   imageUrl?: string;
@@ -81,7 +83,18 @@ export interface SlackWorkspaceTestResult {
   postedMessageTs?: string;
 }
 
-const SLACK_GATEWAY_BASE_PATH = '/slack-gateway';
+export function slackGatewayBasePath(): string {
+  const normalized = String(config.slackGatewayBasePath || '/slack-gateway')
+    .trim()
+    .replace(/\/+$/g, '');
+  if (!normalized) return '/slack-gateway';
+  return normalized.startsWith('/') ? normalized : `/${normalized}`;
+}
+
+export function slackGatewayPath(path: string): string {
+  const normalizedPath = `/${String(path || '').replace(/^\/+/g, '')}`;
+  return `${slackGatewayBasePath()}${normalizedPath}`;
+}
 
 async function parseGatewayResponse(res: Response): Promise<unknown> {
   const text = await res.text();
@@ -110,7 +123,7 @@ export async function slackGatewayRequest<T>(
   if (options.body && !headers.has('Content-Type')) {
     headers.set('Content-Type', 'application/json');
   }
-  const res = await fetch(`${SLACK_GATEWAY_BASE_PATH}${path}`, {
+  const res = await fetch(slackGatewayPath(path), {
     credentials: 'include',
     ...options,
     headers,

ui/src/pages/settings.tsx

@@ -23,6 +23,7 @@ import {
   installationRoutePath,
   primaryConnection,
   slackGatewayRequest,
+  slackGatewayPath,
   type SlackInstallResult,
   type SlackInstallSelection,
   type SlackInstallTarget,
@@ -213,7 +214,7 @@ function WorkspaceListPage() {
       title="Slack Workspaces"
       description="Manage workspace-level Slack app installations and their selected targets."
       action={
-        <a href="/slack-gateway/slack/install" className={buttonVariants({ size: 'lg' })}>
+        <a href={slackGatewayPath('/slack/install')} className={buttonVariants({ size: 'lg' })}>
           <PlugIcon aria-hidden="true" />
           Install
         </a>