feat(docs): migrate from Deco deploy to Cloudflare Pages (#2659)

- Replace Cloudflare Workers server with native Pages routing via _redirects
- Remove wrangler.toml, server/, and deco-cli dependencies
- Simplify Astro config and build scripts
- Update GitHub Actions workflow to use wrangler pages deploy
- Uses existing CF_API_TOKEN and CF_ACCOUNT_ID secrets

The docs site is now pure static Astro built with Cloudflare Pages, eliminating the worker resource limit issues.

Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>

Author: tlgimenes

.github/workflows/deploy-docs.yaml

@@ -18,14 +18,16 @@ jobs:
       - name: Set up Bun
         uses: oven-sh/setup-bun@v2
 
-      - name: Install Deco CLI
-        run: bun install -g deco-cli
-
       - name: Install dependencies
         run: bun install
 
-      - name: Deploy
-        run: bun run deploy
+      - name: Build
+        run: bun run build
+        working-directory: apps/docs
+
+      - name: Deploy to Cloudflare Pages
+        run: wrangler pages deploy dist/client --project-name=decocms-docs
         working-directory: apps/docs
         env:
-          DECO_DEPLOY_TOKEN: ${{ secrets.DECO_DEPLOY_TOKEN_DOCS }}
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CF_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT_ID }}

apps/docs/astro.config.mjs

@@ -1,52 +1,21 @@
 // @ts-check
 import { defineConfig } from "astro/config";
 import tailwindcss from "@tailwindcss/vite";
-import { unlink } from "node:fs/promises";
-import { join } from "node:path";
 
 import mdx from "@astrojs/mdx";
 
 import react from "@astrojs/react";
 
-/**
- * Patches the CSR redirect to delete the root index files.
- * @returns {import("astro").AstroIntegration}
- */
-function patchCsrRedirect() {
-  return {
-    name: "patch-csr-redirect",
-    hooks: {
-      "astro:build:done": async ({ dir }) => {
-        const filesToDelete = [
-          "index.html",
-          "en/index.html",
-          "pt-br/index.html",
-        ];
-        for (const file of filesToDelete) {
-          try {
-            await unlink(join(dir.pathname, file));
-            console.log(`[CSR Redirect Patch] Deleted ${file}`);
-          } catch {
-            // File may not exist, ignore
-          }
-        }
-      },
-    },
-  };
-}
-
 // https://astro.build/config
 export default defineConfig({
   root: "client",
   server: {
     port: 4000,
   },
-  redirects: {
-    "/": "/2026-03-10/en/mcp-mesh/quickstart",
-  },
   outDir: "dist/client/",
+  publicDir: "client/public",
   srcDir: "client/src",
-  integrations: [mdx(), react(), patchCsrRedirect()],
+  integrations: [mdx(), react()],
   vite: {
     plugins: [
       // @ts-ignore: tailwindcss plugin type issue

apps/docs/client/public/_redirects

@@ -0,0 +1,14 @@
+# Root redirects
+/ /2026-03-10/en/mcp-mesh/quickstart 302
+/latest /2026-03-10/en/mcp-mesh/quickstart 302
+/2026-03-10 /2026-03-10/en/mcp-mesh/quickstart 302
+/2025-10-10 /2025-10-10/en/introduction 302
+/en /2026-03-10/en/mcp-mesh/quickstart 302
+/pt-br /2026-03-10/pt-br/mcp-mesh/quickstart 302
+/2026-03-10/en /2026-03-10/en/mcp-mesh/quickstart 302
+/2026-03-10/pt-br /2026-03-10/pt-br/mcp-mesh/quickstart 302
+/2025-10-10/en /2025-10-10/en/introduction 302
+/2025-10-10/pt-br /2025-10-10/pt-br/introduction 302
+
+# Rewrite /latest/* to current version
+/latest/* /2026-03-10/:splat 302

apps/docs/package.json

@@ -3,17 +3,10 @@
   "version": "1.0.0",
   "description": "DecoCMS documentation",
   "scripts": {
-    "dev": "concurrently \"bun run dev:client\" \"NODE_ENV=development bun --hot run server/main.ts\"",
-    "dev:client": "astro dev",
-    "dev:tunnel": "deco link -p 3000 -- bun run dev",
-    "build": "bun run build:client && bun run build:server:wrangler",
-    "build:client": "astro build",
+    "dev": "astro dev",
+    "build": "astro build",
     "check": "astro sync > /dev/null 2>&1 && tsc --noEmit",
-    "build:server:bun": "NODE_ENV=production bun build server/main.ts --target=bun --outfile=dist/server/main.js",
-    "build:server:wrangler": "wrangler build && mkdir -p dist/server && mv ./dist/main.js dist/server/main.js",
-    "start": "NODE_ENV=production bun run dist/server/main.js",
-    "deploy": "bun run build && deco deploy ./dist/server -y -f -t $DECO_DEPLOY_TOKEN",
-    "gen": "deco gen --output=shared/deco.gen.ts",
+    "deploy": "bun run build && wrangler pages deploy dist/client --project-name=decocms-docs",
     "astro": "astro"
   },
   "dependencies": {
@@ -25,13 +18,10 @@
     "react": "^19.2.0",
     "react-dom": "^19.1.0",
     "tailwindcss": "^4.0.7",
-    "typescript": "^5.9.3",
-    "@decocms/runtime": "workspace:*"
+    "typescript": "^5.9.3"
   },
   "devDependencies": {
     "@tailwindcss/typography": "^0.5.16",
-    "concurrently": "^9.2.1",
-    "deco-cli": "^0.28.0",
     "typescript": "^5.9.3",
     "wrangler": "^4.40.3"
   },