feat(www): home page UI, remote docs sync, and Vercel deploy CI

- Build the v2 home page (hero, steps, scope columns, code sample,
  diagram, concerns grid) backed by content/home.md.
- sync-docs.mjs can now pull SDK + spec docs from GitHub when
  SDK_DOCS_REMOTE=1, so CI/Vercel builds without sibling repos checked out.
- Keep content/home.md in the repo; synced lang dirs stay gitignored.
- Read the FontAwesome Pro token from FONTAWESOME_NPM_AUTH_TOKEN instead of
  hardcoding it in .npmrc.
- Replace the GitHub Pages workflow with a Vercel CLI deploy workflow and
  add vercel.json (static generate output).
- Point site.url at agentruntimecontrolprotocol.io.

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

Author: nficano

.github/workflows/deploy.yml

@@ -1,25 +1,26 @@
-name: Build & Deploy
+name: Deploy
 
 on:
   push:
     branches: [main]
+  pull_request:
   workflow_dispatch:
 
 concurrency:
-  group: pages
+  group: vercel-${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+  VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
+  # sync-docs.mjs pulls the SDK + spec docs from GitHub instead of sibling repos.
+  SDK_DOCS_REMOTE: '1'
+
 jobs:
-  build:
+  deploy:
     runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pages: write
-      id-token: write
-    env:
-      SDK_DOCS_REMOTE: '1'
     steps:
-      - name: Checkout site
+      - name: Checkout
         uses: actions/checkout@v4
 
       - name: Setup pnpm
@@ -33,30 +34,28 @@ jobs:
           node-version: 22
           cache: pnpm
 
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Sync SDK docs
-        run: pnpm sync:docs
-
-      - name: Generate static site
-        run: pnpm generate
-
-      - name: Upload Pages artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: .output/public
-
-  deploy:
-    needs: build
-    runs-on: ubuntu-latest
-    permissions:
-      pages: write
-      id-token: write
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4
+      - name: Install Vercel CLI
+        run: pnpm add --global vercel@latest
+
+      - name: Resolve deploy target
+        id: target
+        run: |
+          if [ "${{ github.ref }}" = "refs/heads/main" ]; then
+            echo "prod=--prod" >> "$GITHUB_OUTPUT"
+            echo "env=production" >> "$GITHUB_OUTPUT"
+          else
+            echo "prod=" >> "$GITHUB_OUTPUT"
+            echo "env=preview" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Pull Vercel environment
+        run: vercel pull --yes --environment=${{ steps.target.outputs.env }} --token=${{ secrets.VERCEL_TOKEN }}
+
+      - name: Build with Vercel
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          FONTAWESOME_NPM_AUTH_TOKEN: ${{ secrets.FONTAWESOME_NPM_AUTH_TOKEN }}
+        run: vercel build ${{ steps.target.outputs.prod }} --token=${{ secrets.VERCEL_TOKEN }}
+
+      - name: Deploy to Vercel
+        run: vercel deploy --prebuilt ${{ steps.target.outputs.prod }} --token=${{ secrets.VERCEL_TOKEN }}

.gitignore

@@ -24,5 +24,7 @@ logs
 !.env.example
 
 # Synced from sibling SDK + spec repos by scripts/sync-docs.mjs on every dev/build.
-content
+# content/home.md is hand-authored (the homepage source) and stays in the repo.
+content/*
+!content/home.md
 public/diagrams

app/app.config.ts

@@ -0,0 +1,8 @@
+export default defineAppConfig({
+  ui: {
+    colors: {
+      primary: 'vermilion',
+      neutral: 'inkwell',
+    },
+  },
+});