feat(website): add Starlight docs at /docs

- Full CLI command reference under /docs/commands/
- Configuration, environments, workers, CI/CD, backups, Cloudflare,
  hardening, and team-users guides
- Starlight sidebar wired to autogenerate commands section
- Add docs link to header nav
- Switch GitHub Pages workflow to pnpm to match website lockfile

Author: devalade

.github/workflows/website.yml

@@ -25,11 +25,16 @@ jobs:
         working-directory: website
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
       - uses: actions/setup-node@v4
         with:
           node-version: '22'
-      - run: npm ci || npm install
-      - run: npm run build
+          cache: 'pnpm'
+          cache-dependency-path: website/pnpm-lock.yaml
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm build
         env:
           GITHUB_ACTIONS: 'true'
       - uses: actions/configure-pages@v5

website/astro.config.mjs

@@ -1,8 +1,51 @@
 // @ts-check
 import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
 
 // https://astro.build/config
 export default defineConfig({
   site: 'https://shipnode.dev',
   base: '/',
+  integrations: [
+    starlight({
+      title: 'ShipNode',
+      description: 'Deploy Node.js apps to a single VPS — zero-downtime, PM2, Caddy, SSH.',
+      social: [
+        { icon: 'github', label: 'GitHub', href: 'https://github.com/devalade/shipnode' },
+      ],
+      customCss: ['./src/styles/docs.css'],
+      sidebar: [
+        {
+          label: 'Getting started',
+          items: [
+            { label: 'Introduction', slug: 'docs' },
+            { label: 'Install', slug: 'docs/install' },
+            { label: 'Quick start', slug: 'docs/quick-start' },
+          ],
+        },
+        {
+          label: 'Configuration',
+          items: [
+            { label: 'shipnode.config.ts', slug: 'docs/configuration' },
+            { label: 'Multi-environment', slug: 'docs/environments' },
+            { label: 'Workers', slug: 'docs/workers' },
+          ],
+        },
+        {
+          label: 'Commands',
+          items: [{ autogenerate: { directory: 'docs/commands' } }],
+        },
+        {
+          label: 'Operations',
+          items: [
+            { label: 'CI/CD', slug: 'docs/ci-cd' },
+            { label: 'Backups', slug: 'docs/backups' },
+            { label: 'Cloudflare Tunnel', slug: 'docs/cloudflare' },
+            { label: 'Server hardening', slug: 'docs/hardening' },
+            { label: 'Team users', slug: 'docs/users' },
+          ],
+        },
+      ],
+    }),
+  ],
 });

website/package.json

@@ -12,6 +12,8 @@
     "astro": "astro"
   },
   "dependencies": {
-    "astro": "^6.1.10"
+    "@astrojs/starlight": "^0.39.2",
+    "astro": "^6.1.10",
+    "sharp": "^0.34.5"
   }
 }