refactor(docs): generate redirect map instead of 63 inline entries

Move the /docs/* -> new-URL map into src/redirects.mjs, generated from the
content tree (middleware/cookbook 1:1, flattened guide pages) plus a small
explicit set for renamed/removed/category/search URLs. astro.config.mjs now
just imports it. Same 63 entries / static redirect pages emitted; verified
64/64 live URLs still resolve and redirects fire end-to-end.

(On a wildcard host like Cloudflare these collapse to ~6 _redirects lines.)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: vishr

site/astro.config.mjs

@@ -1,77 +1,12 @@
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
+import { redirects } from './src/redirects.mjs';
 
 // https://astro.build/config
 export default defineConfig({
   site: 'https://echo.labstack.com',
-  // Preserve every live Docusaurus URL at cutover. The old site served docs under
-  // /docs/... (flattened guide pages via slug overrides); Astro generates a static
-  // meta-refresh page per entry (works on GitHub Pages — no _redirects needed).
-  redirects: {
-    '/docs': '/guide/quickstart/',
-    '/docs/binding': '/guide/binding/',
-    '/docs/category/cookbook': '/cookbook/hello-world/',
-    '/docs/category/guide': '/guide/quickstart/',
-    '/docs/category/middleware': '/middleware/basic-auth/',
-    '/docs/cookbook/auto-tls': '/cookbook/auto-tls/',
-    '/docs/cookbook/cors': '/cookbook/cors/',
-    '/docs/cookbook/crud': '/cookbook/crud/',
-    '/docs/cookbook/embed-resources': '/cookbook/embed-resources/',
-    '/docs/cookbook/file-download': '/cookbook/file-download/',
-    '/docs/cookbook/file-upload': '/cookbook/file-upload/',
-    '/docs/cookbook/graceful-shutdown': '/cookbook/graceful-shutdown/',
-    '/docs/cookbook/hello-world': '/cookbook/hello-world/',
-    '/docs/cookbook/http2': '/cookbook/http2/',
-    '/docs/cookbook/http2-server-push': '/cookbook/http2-server-push/',
-    '/docs/cookbook/jsonp': '/cookbook/jsonp/',
-    '/docs/cookbook/jwt': '/cookbook/jwt/',
-    '/docs/cookbook/load-balancing': '/cookbook/load-balancing/',
-    '/docs/cookbook/middleware': '/cookbook/middleware/',
-    '/docs/cookbook/reverse-proxy': '/cookbook/reverse-proxy/',
-    '/docs/cookbook/sse': '/cookbook/sse/',
-    '/docs/cookbook/streaming-response': '/cookbook/streaming-response/',
-    '/docs/cookbook/subdomain': '/cookbook/subdomain/',
-    '/docs/cookbook/timeout': '/cookbook/timeout/',
-    '/docs/cookbook/websocket': '/cookbook/websocket/',
-    '/docs/cookies': '/guide/cookies/',
-    '/docs/customization': '/guide/customization/',
-    '/docs/error-handling': '/guide/error-handling/',
-    '/docs/ip-address': '/guide/ip-address/',
-    '/docs/middleware/basic-auth': '/middleware/basic-auth/',
-    '/docs/middleware/body-dump': '/middleware/body-dump/',
-    '/docs/middleware/body-limit': '/middleware/body-limit/',
-    '/docs/middleware/casbin-auth': '/middleware/casbin-auth/',
-    '/docs/middleware/context-timeout': '/middleware/context-timeout/',
-    '/docs/middleware/cors': '/middleware/cors/',
-    '/docs/middleware/csrf': '/middleware/csrf/',
-    '/docs/middleware/decompress': '/middleware/decompress/',
-    '/docs/middleware/gzip': '/middleware/gzip/',
-    '/docs/middleware/jwt': '/middleware/jwt/',
-    '/docs/middleware/key-auth': '/middleware/key-auth/',
-    '/docs/middleware/logger': '/middleware/logger/',
-    '/docs/middleware/method-override': '/middleware/method-override/',
-    '/docs/middleware/open-telemetry': '/middleware/open-telemetry/',
-    '/docs/middleware/prometheus': '/middleware/prometheus/',
-    '/docs/middleware/proxy': '/middleware/proxy/',
-    '/docs/middleware/rate-limiter': '/middleware/rate-limiter/',
-    '/docs/middleware/recover': '/middleware/recover/',
-    '/docs/middleware/redirect': '/middleware/redirect/',
-    '/docs/middleware/request-id': '/middleware/request-id/',
-    '/docs/middleware/rewrite': '/middleware/rewrite/',
-    '/docs/middleware/secure': '/middleware/secure/',
-    '/docs/middleware/session': '/middleware/session/',
-    '/docs/middleware/static': '/middleware/static/',
-    '/docs/middleware/trailing-slash': '/middleware/trailing-slash/',
-    '/docs/quick-start': '/guide/quickstart/',
-    '/docs/request': '/guide/request/',
-    '/docs/response': '/guide/response/',
-    '/docs/routing': '/guide/routing/',
-    '/docs/start-server': '/guide/customization/',
-    '/docs/static-files': '/guide/static-files/',
-    '/docs/templates': '/guide/templates/',
-    '/docs/testing': '/guide/testing/',
-    '/search': '/',
-  },
+  // Preserve every live Docusaurus /docs/* URL at cutover (generated — see ./src/redirects.mjs).
+  redirects,
   integrations: [
     starlight({
       title: 'Echo',

site/src/redirects.mjs

@@ -0,0 +1,37 @@
+import { readdirSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+// Old Docusaurus URLs -> new locations, generated so astro.config stays small.
+// The old site served docs under /docs/ with guide pages flattened (slug
+// overrides). On GitHub Pages each entry still emits its own static
+// meta-refresh page (no server-side wildcards) — that's why there are ~60.
+// On a wildcard-capable host (Cloudflare/Netlify) these collapse to a handful
+// of `_redirects` lines.
+
+const docsDir = fileURLToPath(new URL('./content/docs', import.meta.url));
+const pages = (sub) =>
+  readdirSync(`${docsDir}/${sub}`)
+    .filter((f) => /\.mdx?$/.test(f))
+    .map((f) => f.replace(/\.mdx?$/, ''));
+
+// Guide pages were flattened to /docs/<name>. Exclude pages that have no old
+// URL (new in v5) or are handled explicitly below.
+const GUIDE_SKIP = new Set(['context', 'installation', 'quickstart']);
+
+const fromList = (subPrefix, toPrefix, names) =>
+  Object.fromEntries(names.map((n) => [`/docs/${subPrefix}${n}`, `/${toPrefix}${n}/`]));
+
+export const redirects = {
+  // Renamed, removed, index, Docusaurus category pages, and the old search page.
+  '/docs': '/guide/quickstart/',
+  '/docs/quick-start': '/guide/quickstart/',
+  '/docs/start-server': '/guide/customization/',
+  '/docs/category/guide': '/guide/quickstart/',
+  '/docs/category/middleware': '/middleware/basic-auth/',
+  '/docs/category/cookbook': '/cookbook/hello-world/',
+  '/search': '/',
+  // Bulk, generated from the current content tree.
+  ...fromList('', 'guide/', pages('guide').filter((n) => !GUIDE_SKIP.has(n))),
+  ...fromList('middleware/', 'middleware/', pages('middleware')),
+  ...fromList('cookbook/', 'cookbook/', pages('cookbook')),
+};