refactor: make pre-rendering opt-in via npm run build:prerender

Puppeteer setup in GitHub Actions CI is complex (Chrome dependencies,
executable paths, etc.). Instead of fighting CI, make pre-rendering
opt-in for local builds before releases.

Changes:
- npm run build → standard SPA build (no pre-rendering)
- npm run build:prerender → build + Puppeteer pre-rendering
- Removed Chrome setup from deploy.yml workflow
- Keep PUPPETEER_SKIP_DOWNLOAD=true in CI (faster installs)
- Added README.md with pre-rendering instructions

Rationale:
- CI deploys standard SPA (Google/Bing will index via JS execution)
- Pre-rendered builds can be done locally before important releases
- Avoids CI complexity and fragility
- Still have SEO meta tags for immediate indexing

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: raifdmueller

.github/workflows/deploy.yml

@@ -32,14 +32,6 @@ jobs:
         env:
           PUPPETEER_SKIP_DOWNLOAD: true
 
-      - name: Setup Chrome for Puppeteer
-        uses: browser-actions/setup-chrome@latest
-        with:
-          chrome-version: stable
-
-      - name: Set Puppeteer executable path
-        run: echo "PUPPETEER_EXECUTABLE_PATH=$(which google-chrome-stable)" >> $GITHUB_ENV
-
       - name: Detect base path
         id: base
         run: |

README.md

@@ -0,0 +1,45 @@
+# Vibe-Coding Risk Radar
+
+MECE risk framework for AI-generated code — 5 dimensions, 4 tiers, actionable mitigations.
+
+🔗 **Live Demo:** https://llm-coding.github.io/vibe-coding-risk-radar/
+
+## Features
+
+- Interactive 5-dimension risk assessment (code type, language, deployment, data, blast radius)
+- 4-tier classification (Minimal, Moderate, High, Critical)
+- Claude Code skills for automated repo analysis (`/risk-assess`, `/risk-mitigate`)
+- Architecture Decision Record (ADR) generation
+- Bilingual interface (DE/EN)
+
+## Development
+
+```bash
+npm install          # Install dependencies
+npm run dev          # Start dev server
+npm run build        # Production build
+npm run preview      # Preview build locally
+```
+
+## Pre-rendering for SEO
+
+The app includes a Puppeteer-based pre-rendering script for better SEO.
+
+**Local pre-rendering (before release):**
+
+```bash
+npm run build:prerender
+```
+
+This renders the full React app to static HTML in `dist/index.html`.
+
+**Note:** Pre-rendering is not run in CI due to Puppeteer/Chrome setup complexity. The deployed version is a standard SPA (search engines with JS support will still index it, just slower).
+
+## Documentation
+
+- Full docs: `npm run docs` → `dist/docs/`
+- In-app: Click "Documentation" button
+
+## License
+
+MIT — see LICENSE file

package.json

@@ -5,7 +5,8 @@
   "type": "module",
   "scripts": {
     "dev": "vite",
-    "build": "vite build && node scripts/prerender.js",
+    "build": "vite build",
+    "build:prerender": "npm run build && node scripts/prerender.js",
     "preview": "vite preview",
     "docs": "asciidoctor -a icons=font -a source-highlighter=highlight.js -a linkcss -a stylesheet=asciidoctor.css -D dist/docs docs/risk-radar.adoc docs/risk-radar-en.adoc",
     "prepare": "husky"