Move docs to main site

Author: nikhilwoodruff

.github/workflows/docs.yml

@@ -2,9 +2,6 @@ name: Test
 
 on:
   pull_request:
-  push:
-    branches:
-      - main
 
 jobs:
   test:

.github/workflows/test.yml

@@ -1,10 +1,20 @@
+# Build docs
+FROM node:22-slim AS docs-builder
+WORKDIR /docs
+COPY docs/package.json docs/bun.lock ./
+RUN npm install
+COPY docs/ ./
+RUN npm run build
+
+# Build API
 FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim
 
 WORKDIR /app
 
 # Copy project files
 COPY pyproject.toml README.md ./
 COPY src/ ./src/
+COPY --from=docs-builder /docs/out ./docs/out/
 
 # Install dependencies
 RUN uv pip install --system -e .

Dockerfile

@@ -2,7 +2,7 @@ import type { NextConfig } from "next";
 
 const nextConfig: NextConfig = {
   output: "export",
-  basePath: "/policyengine-api-v2-alpha",
+  basePath: "/docs",
   images: {
     unoptimized: true,
   },

docs/next.config.ts

@@ -1,8 +1,10 @@
 from contextlib import asynccontextmanager
+from pathlib import Path
 
 import logfire
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
+from fastapi.staticfiles import StaticFiles
 from fastapi_cache import FastAPICache
 from fastapi_cache.backends.inmemory import InMemoryBackend
 from fastapi_mcp import FastApiMCP
@@ -45,6 +47,7 @@ async def lifespan(app: FastAPI):
     debug=settings.debug,
     lifespan=lifespan,
     redirect_slashes=True,
+    docs_url=None,  # Disable default Swagger UI - we serve custom docs
 )
 
 # Add CORS middleware
@@ -66,6 +69,11 @@ async def lifespan(app: FastAPI):
 mcp = FastApiMCP(app)
 mcp.mount_http()
 
+# Mount static docs site at /docs (built from Next.js in docs/out)
+docs_path = Path(__file__).parent.parent.parent / "docs" / "out"
+if docs_path.exists():
+    app.mount("/docs", StaticFiles(directory=docs_path, html=True), name="docs")
+
 
 @app.get("/health")
 def health_check():