From b0aa6434aea98056ac76f2d7b5ed36b819c4c8c6 Mon Sep 17 00:00:00 2001
From: Ryan Malloy <ryan@supported.systems>
Date: Tue, 10 Feb 2026 17:08:10 -0700
Subject: [PATCH] Add production docs deployment

- Add Dockerfile with multi-stage build (node -> caddy)
- Add docker-compose.yml for caddy-docker-proxy
- Update astro.config.mjs with production site URL
- Add Documentation link to README.md header
- Add Documentation URL to pyproject.toml
---
 README.md                    |  4 ++--
 docs-site/Dockerfile         | 12 ++++++++++++
 docs-site/astro.config.mjs   |  2 +-
 docs-site/docker-compose.yml | 13 +++++++++++++
 pyproject.toml               |  1 +
 5 files changed, 29 insertions(+), 3 deletions(-)
 create mode 100644 docs-site/Dockerfile
 create mode 100644 docs-site/docker-compose.yml

diff --git a/README.md b/README.md
index 3e0d655..1502e81 100644
--- a/README.md
+++ b/README.md
@@ -5,11 +5,11 @@
 </p>
 
 <p align="center">
+  <a href="https://mcbluetooth.supported.systems">Documentation</a> •
   <a href="#installation">Installation</a> •
   <a href="#quick-start">Quick Start</a> •
   <a href="#features">Features</a> •
-  <a href="#tools-reference">Tools</a> •
-  <a href="#architecture">Architecture</a>
+  <a href="#tools-reference">Tools</a>
 </p>
 
 <p align="center">
diff --git a/docs-site/Dockerfile b/docs-site/Dockerfile
new file mode 100644
index 0000000..c1a25fb
--- /dev/null
+++ b/docs-site/Dockerfile
@@ -0,0 +1,12 @@
+# Build stage
+FROM node:22-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+# Serve stage
+FROM caddy:2-alpine
+COPY --from=builder /app/dist /srv
+CMD ["caddy", "file-server", "--root", "/srv", "--listen", ":80"]
diff --git a/docs-site/astro.config.mjs b/docs-site/astro.config.mjs
index 0d2fada..e004c31 100644
--- a/docs-site/astro.config.mjs
+++ b/docs-site/astro.config.mjs
@@ -6,7 +6,7 @@ import icon from 'astro-icon';
 // https://astro.build/config
 export default defineConfig({
 	// Site URL for sitemap generation
-	site: 'https://mcbluetooth.example.com',
+	site: 'https://mcbluetooth.supported.systems',
 
 	// Disable telemetry
 	telemetry: false,
diff --git a/docs-site/docker-compose.yml b/docs-site/docker-compose.yml
new file mode 100644
index 0000000..a687bbd
--- /dev/null
+++ b/docs-site/docker-compose.yml
@@ -0,0 +1,13 @@
+services:
+  docs:
+    build: .
+    restart: unless-stopped
+    networks:
+      - caddy
+    labels:
+      caddy: ${DOCS_DOMAIN:-mcbluetooth.supported.systems}
+      caddy.reverse_proxy: "{{upstreams 80}}"
+
+networks:
+  caddy:
+    external: true
diff --git a/pyproject.toml b/pyproject.toml
index 40d6c92..aab8249 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -43,6 +43,7 @@ dev = [
 mcbluetooth = "mcbluetooth:main"
 
 [project.urls]
+Documentation = "https://mcbluetooth.supported.systems"
 Repository = "https://git.supported.systems/MCP/mcbluetooth"
 
 [tool.hatch.build.targets.wheel]