Host Slidev deck on GitHub Pages

Adds a deploy workflow that builds the deck with base path /YZR-Team/
and publishes to GitHub Pages on push to main. Also commits the deck
source (slides, lockfile, exported PDF) and the narrative doc.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>

Author: roger704

.github/workflows/deploy.yml

@@ -0,0 +1,58 @@
+name: Deploy Slidev deck to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'presentation/**'
+      - '.github/workflows/deploy.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: presentation
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: presentation/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build deck
+        run: npx slidev build --base /YZR-Team/ --out dist
+
+      - name: SPA fallback (copy index.html → 404.html)
+        run: cp dist/index.html dist/404.html
+
+      - uses: actions/configure-pages@v5
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: presentation/dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -2,3 +2,5 @@
 .claude/
 node_modules/
 *.log
+presentation/dist/
+presentation/.slidev/

README.md

@@ -8,6 +8,14 @@ The 10 seconds between an AI agent asking for the go-ahead and the owner tapping
 
 Interactive mock-up built with Lovable → [**roger704/hands-free-help**](https://github.com/roger704/hands-free-help)
 
+## Presentation
+
+Slidev deck that pulls the live Lovable mock via iframe — see [`presentation/`](./presentation/).
+
+```bash
+cd presentation && npm install && npm run dev
+```
+
 ## Contents
 
 | File | What it is |

presentation/.gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.slidev/
+*.log
+slides-export.pdf

presentation/README.md

@@ -0,0 +1,43 @@
+# Tap to Trust — Deck
+
+Web-based Slidev deck. Embeds the Lovable mock **live** in an iframe, so whenever the prototype updates the deck updates too.
+
+## Run it
+
+```bash
+cd presentation
+npm install
+npm run dev
+```
+
+Opens at `http://localhost:3030`.
+
+## Export
+
+```bash
+npm run build     # static site → dist/
+npm run export    # → slides-export.pdf
+```
+
+## Edit
+
+Everything lives in [`slides.md`](./slides.md). Each `---` is a slide. Markdown + Vue + Tailwind.
+
+## The Lovable URL
+
+The iframes point to `https://hands-free-help.lovable.app`. If Lovable publishes the app at a different URL, swap it in `slides.md` (two places: the Live Prototype slide and the Walkthrough slide).
+
+## Deck flow
+
+1. Title
+2. The 10-second problem
+3. Target user (3 personas)
+4. The response spectrum (7 ways)
+5. The 6-step shape
+6. **Live prototype (iframe)**
+7. Scenario walkthrough (fish supply chain) + iframe
+8. The feel (context / customer / handoff / tone)
+9. Voice mode
+10. Learning loops
+11. Failure modes
+12. Closing + links