add local demo data mode

Author: B-EtterDigital

.env.example

@@ -11,6 +11,10 @@ NEXTAUTH_SECRET=your-secret-here # Generate with: openssl rand -base64 32
 GITHUB_ID=your-github-oauth-app-id
 GITHUB_SECRET=your-github-oauth-app-secret
 
+# Local visual QA (optional)
+# Set to 1 to use built-in demo leaderboard/profile data instead of Supabase.
+# NEXT_PUBLIC_VIBERANK_DEMO_DATA=1
+
 # To get GitHub OAuth credentials:
 # 1. Go to https://github.com/settings/developers
 # 2. Click "New OAuth App"

README.md

@@ -138,6 +138,14 @@ pnpm dev
 
 Open <http://localhost:3000>.
 
+For local visual QA without a Supabase project, enable the built-in demo data:
+
+```bash
+NEXT_PUBLIC_VIBERANK_DEMO_DATA=1 pnpm dev
+```
+
+Demo data is read-only and only intended to render realistic leaderboard, profile, model-list, and hire-page states during UI review.
+
 ### Useful scripts
 
 | Command | What it does |
@@ -146,7 +154,7 @@ Open <http://localhost:3000>.
 | `pnpm build` | Production build |
 | `pnpm start` | Serve the production build |
 | `pnpm lint` | Run `next lint` |
-| `pnpm test` | Run the ccusage normalization/validation tests (`node test/ccusage.test.mts`; pass a `cc.json` path to also test real data) |
+| `pnpm test` | Run the ccusage and data-layer tests (`node test/ccusage.test.mts`; pass a `cc.json` path to also test real data) |
 | `pnpm exec tsc --noEmit` | Type-check without emitting |
 
 ## Tech stack

package.json

@@ -8,7 +8,7 @@
     "build": "next build",
     "start": "next start",
     "lint": "next lint",
-    "test": "node test/ccusage.test.mts"
+    "test": "node test/ccusage.test.mts && for f in test/*.test.mts; do [ \"$f\" = \"test/ccusage.test.mts\" ] || node \"$f\" || exit 1; done"
   },
   "dependencies": {
     "@auth/core": "^0.40.0",