docs(nx-dev): add redirects for astro docs (#32372)

add new redirects file
redirect root to the intro page
redirect legacy showcase projects to quickstart until those projects get
updated

closes: DOC-94
closes: DOC-114

Author: barbados-clemens

astro-docs/astro.config.mjs

@@ -7,12 +7,14 @@ import react from '@astrojs/react';
 import markdoc from '@astrojs/markdoc';
 import tailwindcss from '@tailwindcss/vite';
 import { sidebar } from './sidebar.mts';
+import { redirects } from './redirects.mts';
 
 // https://astro.build/config
 export default defineConfig({
   vite: { plugins: [tailwindcss()] },
   site: 'https://docs.nx.dev',
   adapter: netlify(),
+  redirects,
   integrations: [
     markdoc(),
     starlight({

astro-docs/project.json

@@ -22,11 +22,23 @@
           "target": "build"
         }
       ],
+      "outputs": [
+        "{projectRoot}/dist",
+        "{projectRoot}/.astro",
+        "{projectRoot}/.netlify"
+      ],
       "command": "astro build",
       "options": {
         "cwd": "astro-docs"
       }
     },
+    "preview": {
+      "dependsOn": ["build"],
+      "command": "astro preview",
+      "options": {
+        "cwd": "astro-docs"
+      }
+    },
     "astro": {
       "command": "astro",
       "options": {

astro-docs/redirects.mts

@@ -0,0 +1,29 @@
+export const redirects = {
+  '/': '/getting-started/intro',
+  '/showcase': '/quickstart',
+  // astro doesn't seem to  allow configuing catch all redirect routes
+  // so hard code each previous route to the redirect for now
+  // '/showcase/[...slug]': '/quickstart',
+  '/showcase/example-repos': '/quickstart',
+  '/showcase/example-repos/add-express': '/quickstart',
+  '/showcase/example-repos/add-lit': '/quickstart',
+  '/showcase/example-repos/add-solid': '/quickstart',
+  '/showcase/example-repos/add-qwik': '/quickstart',
+  '/showcase/example-repos/add-rust': '/quickstart',
+  '/showcase/example-repos/add-dotnet': '/quickstart',
+  '/showcase/example-repos/add-astro': '/quickstart',
+  '/showcase/example-repos/add-svelte': '/quickstart',
+  '/showcase/example-repos/add-fastify': '/quickstart',
+  '/showcase/example-repos/apollo-react': '/quickstart',
+  '/showcase/example-repos/nestjs-prisma': '/quickstart',
+  '/showcase/example-repos/mongo-fastify': '/quickstart',
+  '/showcase/example-repos/redis-fastify': '/quickstart',
+  '/showcase/example-repos/postgres-fastify': '/quickstart',
+  '/showcase/example-repos/serverless-fastify-planetscale': '/quickstart',
+  '/showcase/example-repos/mfe': '/quickstart',
+  '/showcase/benchmarks': '/references/benchmarks',
+  '/showcase/benchmarks/tsc-batch-mode':
+    '/references/benchmarks/tsc-batch-mode',
+  '/showcase/benchmarks/caching': '/references/benchmarks/caching',
+  '/showcase/benchmarks/nx-agents': '/references/benchmarks/nx-agents',
+};