Vue UI

.github/workflows/cd-deploy-docs.yml

@@ -4,7 +4,7 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: 'Version (e.g. v1.0, v1.1)'
+        description: 'Version (e.g. v1.0, v1.1, v2.0.0-beta.1)'
         required: true
 
 concurrency:
@@ -49,7 +49,7 @@ jobs:
             -H "Authorization: Bearer $KEY" \
             -H "Content-Type: application/zip" \
             --data-binary @$GITHUB_WORKSPACE/docs.zip \
-            "${URL}/api/products/shelf/versions/${VER}"
+            "${URL}/_api/products/shelf/versions/${VER}"
 
       - name: Deployment summary
         run: |

.github/workflows/cd-deploy-production.yml

@@ -29,8 +29,8 @@ jobs:
             exit 1
           fi
 
-          if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
-            echo "::error ::Invalid release version format. Expected X.Y.Z (e.g., 1.2.3), got: $VERSION"
+          if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-.+)?$ ]]; then
+            echo "::error ::Invalid release version format. Expected X.Y.Z or X.Y.Z-label (e.g., 1.2.3, 1.2.3-beta.1), got: $VERSION"
             exit 1
           fi
 
@@ -69,6 +69,15 @@ jobs:
             --password ${{ secrets.PERSONAL_PACKAGES_TOKEN }} \
             --store-password-in-clear-text
 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Build Admin UI
+        working-directory: ./src/Cocoar.Shelf.Client
+        run: npm ci && npm run build
+
       - name: Restore dependencies
         run: dotnet restore Cocoar.Shelf.slnx
         working-directory: ./src
@@ -196,9 +205,15 @@ jobs:
         env:
           VERSION: ${{ needs.validate-version.outputs.version }}
         run: |
-          MAJOR=$(echo "$VERSION" | cut -d. -f1)
-          MINOR=$(echo "$VERSION" | cut -d. -f2)
-          echo "value=v${MAJOR}.${MINOR}" >> $GITHUB_OUTPUT
+          if [[ "$VERSION" == *-* ]]; then
+            # Pre-release: use full version (e.g. v6.0.0-beta.1)
+            echo "value=v${VERSION}" >> $GITHUB_OUTPUT
+          else
+            # Stable: use major.minor (e.g. v5.2)
+            MAJOR=$(echo "$VERSION" | cut -d. -f1)
+            MINOR=$(echo "$VERSION" | cut -d. -f2)
+            echo "value=v${MAJOR}.${MINOR}" >> $GITHUB_OUTPUT
+          fi
 
       - name: Upload to Shelf
         env:
@@ -211,7 +226,7 @@ jobs:
             -H "Authorization: Bearer $KEY" \
             -H "Content-Type: application/zip" \
             --data-binary @$GITHUB_WORKSPACE/docs.zip \
-            "${URL}/api/products/shelf/versions/${VER}"
+            "${URL}/_api/products/shelf/versions/${VER}"
 
       - name: Docs deployment summary
         run: |

.github/workflows/cd-deploy-staging.yml

@@ -75,6 +75,15 @@ jobs:
             --password ${{ secrets.PERSONAL_PACKAGES_TOKEN }} \
             --store-password-in-clear-text
 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Build Admin UI
+        working-directory: ./src/Cocoar.Shelf.Client
+        run: npm ci && npm run build
+
       - name: Restore dependencies
         run: dotnet restore Cocoar.Shelf.slnx
         working-directory: ./src

.github/workflows/ci-develop.yml

@@ -48,6 +48,15 @@ jobs:
       - name: Log version
         run: echo "Building version ${{ steps.gv.outputs.SemVer }}"
 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Build Admin UI
+        working-directory: ./src/Cocoar.Shelf.Client
+        run: npm ci && npm run build
+
       - name: Restore dependencies
         run: dotnet restore Cocoar.Shelf.slnx
         working-directory: ./src

.github/workflows/ci-pr-validation.yml

@@ -48,6 +48,15 @@ jobs:
       - name: Log version
         run: echo "Building version ${{ steps.gv.outputs.SemVer }}"
 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Build Admin UI
+        working-directory: ./src/Cocoar.Shelf.Client
+        run: npm ci && npm run build
+
       - name: Restore dependencies
         run: dotnet restore Cocoar.Shelf.slnx
         working-directory: ./src

.gitignore

@@ -57,6 +57,13 @@ nul
 local/
 .local/
 
+# SPA build output (generated by Vite)
+src/Cocoar.Shelf/wwwroot/assets/
+src/Cocoar.Shelf/wwwroot/index.html
+
+# Client dependencies
+src/Cocoar.Shelf.Client/node_modules/
+
 # VitePress
 website/.vitepress/cache/
 website/.vitepress/dist/

Dockerfile

@@ -1,10 +1,18 @@
+FROM node:22-alpine AS client-build
+WORKDIR /client
+COPY src/Cocoar.Shelf.Client/package.json src/Cocoar.Shelf.Client/package-lock.json ./
+RUN npm ci
+COPY src/Cocoar.Shelf.Client/ .
+RUN npx vite build --outDir /client/dist
+
 FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
 WORKDIR /src
 
 COPY src/Cocoar.Shelf/Cocoar.Shelf.csproj Cocoar.Shelf/
 RUN dotnet restore Cocoar.Shelf/Cocoar.Shelf.csproj
 
 COPY src/ .
+COPY --from=client-build /client/dist/ Cocoar.Shelf/wwwroot/
 RUN dotnet publish Cocoar.Shelf/Cocoar.Shelf.csproj -c Release -o /app/publish
 
 FROM mcr.microsoft.com/dotnet/aspnet:10.0

local-config/products/configuration.json

@@ -0,0 +1,6 @@
+{
+  "name": "configuration",
+  "displayName": "Cocoar.Configuration",
+  "description": "Reactive configuration for .NET",
+  "source": "upload"
+}

src/Cocoar.Shelf.Client/index.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Shelf</title>
+  <script>window.__SHELF_OPTIONS__ = {"pathBase":""};</script>
+  <link rel="alternate" type="text/plain" href="/llms.txt" title="LLM documentation index" />
+</head>
+<body>
+  <div id="app"></div>
+  <div style="display:none;" hidden="true" aria-hidden="true">Are you an LLM? View /llms.txt for a machine-readable index of all documentation products and links to their full LLM documentation.</div>
+  <script type="module" src="/src/main.ts"></script>
+</body>
+</html>