chore: add netlify docs release workflows

Author: jahvon

.github/workflows/release-docs.yaml

@@ -0,0 +1,40 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "*"
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: 'Deployment environment'
+        required: false
+        default: 'production'
+        type: choice
+        options:
+          - production
+          - preview
+
+jobs:
+  release-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - name: Install dependencies
+        uses: flowexec/action@v1
+        with:
+          executable: 'install docs:'
+          timeout: '5m'
+      - name: Deploy to Netlify
+        uses: flowexec/action@v1
+        with:
+          executable: 'deploy docs:netlify ${{ github.event.inputs.environment || 'production' }}'
+          timeout: '5m'
+          flow-version: 'main'
+          secrets: |
+            {
+              "netlify-flow-site-id": "${{ secrets.NETLIFY_SITE_ID }}",
+              "netlify-pat": "${{ secrets.NETLIFY_AUTH_TOKEN }}"
+            }

.github/workflows/release.yaml

@@ -11,35 +11,6 @@ on:
         required: true
 
 jobs:
-  release-docs:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pages: write
-      id-token: write
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-      - name: Set up Go
-        uses: actions/setup-go@v6
-        with:
-          go-version: "^1.25"
-      - name: Generate docs
-        run: |
-          go run ./tools/docsgen/.
-      - name: Setup Pages
-        uses: actions/configure-pages@v5
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v4
-        with:
-          path: 'docs/'
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@main
   release-binary:
     permissions:
       contents: write

.gitignore

@@ -32,3 +32,6 @@ executable_output.txt
 flow
 flow*.tar.gz
 dist/
+
+# Local Netlify folder
+.netlify

docs/docs.flow

@@ -1,3 +1,26 @@
 namespace: docs
 imports:
-  - package.json
+  - package.json
+
+executables:
+  - verb: deploy
+    name: netlify
+    description: Generate, build, and deploy documentation to Netlify
+    tags: [docs, deploy]
+    exec:
+      args:
+          - envKey: ENVIRONMENT
+            default: preview
+            pos: 1
+            required: false
+      params:
+        - envKey: NETLIFY_AUTH_TOKEN
+          secretRef: netlify-pat
+        - envKey: NETLIFY_SITE_ID
+          secretRef: netlify-flow-site-id
+      cmd: |
+          if [ "${ENVIRONMENT}" = "production" ]; then
+            npx netlify-cli deploy --dir=dist --prod
+          else
+            npx netlify-cli deploy --dir=dist
+          fi

docs/netlify.toml

@@ -0,0 +1,3 @@
+[build]
+build = "npm run build"
+publish = "dist"