ci: deploy docs

.github/workflows/docs.yml

@@ -0,0 +1,31 @@
+name: Deploy
+
+on:
+  push:
+    branches:
+      - 'main'
+
+jobs:
+  deploy:
+    name: Deploy
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Tools
+        uses: ./.github/actions/install-tools
+
+      - name: Install Dependencies
+        uses: ./.github/actions/install-dependencies
+
+      - name: Build Docs
+        run: pnpm docs:build
+
+      - name: Deploy to Netlify
+        run: pnpm run docs:deploy --prod
+        env:
+          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
+          NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}
+        shell: bash

.gitignore

@@ -5,6 +5,7 @@ pnpm-debug.log*
 
 # Build
 lib-types/
+.netlify/
 server/
 dist/
 lib/
@@ -18,4 +19,4 @@ tmp/
 coverage/
 
 # Misc
-.DS_Store
+.DS_Store

docs/adapters/netlify-edge/vite.config.ts

@@ -0,0 +1,22 @@
+import { netlifyEdgeAdapter } from '@builder.io/qwik-city/adapters/netlify-edge/vite'
+import { extendConfig } from '@builder.io/qwik-city/vite'
+import path from 'node:path'
+
+import baseConfig from '../../../vite.config.docs'
+
+export default extendConfig(baseConfig, () => ({
+  build: {
+    rollupOptions: {
+      input: [
+        path.join(__dirname, '../../entry.netlify-edge.tsx'),
+        '@qwik-city-plan',
+      ],
+    },
+    outDir: path.join(
+      __dirname,
+      '../../server/.netlify/edge-functions/entry.netlify-edge',
+    ),
+    ssr: true,
+  },
+  plugins: [netlifyEdgeAdapter()],
+}))

docs/entry.netlify-edge.tsx

@@ -0,0 +1,17 @@
+import type { PlatformNetlify } from '@builder.io/qwik-city/middleware/netlify-edge'
+
+import { createQwikCity } from '@builder.io/qwik-city/middleware/netlify-edge'
+import { manifest } from '@qwik-client-manifest'
+import qwikCityPlan from '@qwik-city-plan'
+
+import render from './entry.ssr'
+
+declare global {
+  type QwikCityPlatform = PlatformNetlify
+}
+
+export default createQwikCity({
+  qwikCityPlan,
+  manifest,
+  render,
+})

docs/mocks/vscode.ts

@@ -0,0 +1,5 @@
+export let workspace = {
+  getConfiguration: () => ({
+    get: () => {},
+  }),
+}

docs/public/_headers

@@ -0,0 +1,2 @@
+/build/*
+  Cache-Control: public, max-age=31536000, s-maxage=31536000, immutable

netlify.toml

@@ -0,0 +1,6 @@
+[build]
+publish = "docs/dist"
+command = "pnpm run docs:build"
+
+[functions]
+directory = "docs/server/.netlify/edge-functions"

package.json

@@ -33,7 +33,9 @@
     "docs:clean": "pnpm run /^docs:clean:/",
     "docs:debug": "node --inspect-brk ./node_modules/vite/bin/vite.js --mode ssr --force",
     "docs:preview": "pnpm run docs:clean && qwik build preview && vite preview --open --config vite.config.docs.ts",
+    "docs:deploy": "netlify deploy --build",
     "build.client": "vite build --config vite.config.docs.ts",
+    "build.server": "vite build --config ./docs/adapters/netlify-edge/vite.config.ts",
     "build.types": "tsc --incremental --noEmit",
     "build.preview": "vite build --ssr docs/entry.preview.tsx --config vite.config.docs.ts",
     "scripts:preview": "tsx ./scripts/generate-preview.ts",
@@ -165,6 +167,7 @@
     "@builder.io/qwik-city": "^1.8.0",
     "@commitlint/cli": "^19.4.0",
     "@commitlint/config-conventional": "^19.2.2",
+    "@netlify/edge-functions": "^2.10.0",
     "@types/culori": "^2.1.1",
     "@types/eslint": "^9.6.0",
     "@types/node": "^22.2.0",
@@ -187,6 +190,7 @@
     "eslint-plugin-vitest": "^0.5.4",
     "focus-trap": "^7.5.4",
     "lightningcss": "^1.26.0",
+    "netlify-cli": "^17.34.0",
     "prettier": "^3.3.3",
     "puppeteer": "^23.0.2",
     "shiki": "^1.12.1",
@@ -202,7 +206,6 @@
     "typescript": "^5.5.4",
     "undici": "^6.19.7",
     "vite": "^5.4.0",
-    "vite-tsconfig-paths": "^4.3.2",
     "vitest": "^2.0.5"
   }
 }