tweaks for release docs

Author: clavery

.github/workflows/deploy-docs.yml

@@ -58,11 +58,17 @@ jobs:
       - name: Build release documentation
         if: steps.release.outputs.exists == 'true'
         run: |
-          # Save main build
+          # Save main build and config (config has version dropdown code)
           mv docs/.vitepress/dist docs/.vitepress/dist-main
+          cp docs/.vitepress/config.mts /tmp/config.mts
 
-          # Checkout and build at release tag
+          # Checkout release tag
           git checkout ${{ steps.release.outputs.tag }}
+
+          # Restore config from main (has version dropdown and dynamic base path)
+          cp /tmp/config.mts docs/.vitepress/config.mts
+
+          # Build at release tag with main's config
           pnpm install --frozen-lockfile
           pnpm -r run build
           RELEASE_VERSION=${{ steps.release.outputs.tag }} IS_RELEASE_BUILD=true pnpm run docs:build

docs/.vitepress/config.mts

@@ -5,27 +5,33 @@ import typedocSidebar from '../api/typedoc-sidebar.json';
 const releaseVersion = process.env.RELEASE_VERSION || 'unreleased';
 const isReleaseBuild = process.env.IS_RELEASE_BUILD === 'true';
 
-// Base path for this build
-const basePath = '/b2c-developer-tooling/';
+// Base paths - release build lives in /release/ subdirectory
+const siteBase = '/b2c-developer-tooling';
+const basePath = isReleaseBuild ? `${siteBase}/release/` : `${siteBase}/`;
 
 // Build version dropdown items
-// Note: VitePress automatically prepends the base path to links, so we use root-relative paths
+// VitePress prepends base path to links starting with /, so we use relative paths
+// that work correctly for each build context
 function getVersionItems() {
-  if (isReleaseBuild) {
-    return [
-      { text: 'Development (main)', link: basePath },
-      { text: `Release (${releaseVersion})`, link: `${basePath}release/` },
-    ];
+  if (releaseVersion === 'unreleased') {
+    // No release yet - only show dev
+    return [{ text: 'Development (main)', link: '/' }];
   }
-  // Main branch build - check if there's a release version
-  if (releaseVersion !== 'unreleased') {
+
+  if (isReleaseBuild) {
+    // Release build: base is /b2c-developer-tooling/release/
+    // Use ../ to navigate up to main docs
     return [
-      { text: 'Development (main)', link: '/' },
-      { text: `Release (${releaseVersion})`, link: '/release/' },
+      { text: 'Development (main)', link: '../' },
+      { text: `Release (${releaseVersion})`, link: '/' },
     ];
   }
-  // No release yet
-  return [{ text: 'Development (main)', link: '/' }];
+
+  // Main build: base is /b2c-developer-tooling/
+  return [
+    { text: 'Development (main)', link: '/' },
+    { text: `Release (${releaseVersion})`, link: '/release/' },
+  ];
 }
 
 const guideSidebar = [
@@ -81,7 +87,7 @@ const guideSidebar = [
 export default defineConfig({
   title: 'B2C DX',
   description: 'Salesforce Commerce Cloud B2C Developer Experience - CLI, MCP Server, and SDK',
-  base: '/b2c-developer-tooling/',
+  base: basePath,
 
   // Ignore dead links in api-readme.md (links are valid after TypeDoc generates the API docs)
   ignoreDeadLinks: [/^\.\/clients\//],