@vatvaghool/create-ipl-dashboard 0.1.15 → 0.1.18

package/README.md

@@ -34,10 +34,9 @@ npx @vatvaghool/create-ipl-dashboard [project-name] [options]
 | Private key | Google service account private key (only if google_sheets chosen) |
 | League URL | The fantasy.iplt20.com league page URL |
 | Collection/sheet name | MongoDB collection or Google sheet for this league's data |
-| League name | Display name for your league |
-| Teams | Team names (and optional owners) in your league
+| League name | Used as collection/table name in storage |
 
-If `--scrape` is provided, the CLI attempts to extract team names from the league page HTML. If that fails, it falls back to manual entry.
+Set team names later via `app/data/teams.ts` or use `--scrape` to auto-detect from the league URL during scaffolding.
 
 ## Screenshots
 
@@ -85,16 +84,31 @@ cd my-league
 
 # Start the dev server
 npm run dev:simple
-
-# Capture auth state for scrapers (one-time setup)
-npm run capture:ipl-auth
-
-# Scrape live leaderboard data
-npm run sync:ipl
 ```
 
 Open http://localhost:3000 to see your dashboard.
 
+### Available commands
+
+| Command | Description |
+|---------|-------------|
+| `npm run dev` | Dev server with welcome splash |
+| `npm run dev:simple` | Dev server (simple, no splash) |
+| `npm run build` | Production build |
+| `npm start` | Production server |
+| `npm run capture:ipl-auth` | Capture Playwright login state (one-time) |
+| `npm run sync:ipl` | Scrape live leaderboard snapshot |
+| `npm run sync:ipl:watch` | Scrape leaderboard in watch mode (polls every 2 min) |
+| `npm run sync:ipl:transfers-daily` | Scrape transfer/booster data |
+| `npm run sync:cloud` | Run both leaderboard + transfer sync (for cloud jobs) |
+| `npm run seed:league` | Seed league metadata into storage |
+| `npm run seed:mongodb` | Seed initial raw user data from `data.ts` |
+| `npm run seed:mongodb:reset` | Reset and re-seed MongoDB data |
+| `npm run verify:production` | Verify production setup |
+| `npm run monitor:ops` | Check ops health status |
+| `npm run test` | Run test suite |
+| `npm run lint` | Run linter |
+
 ## How it works
 
 The CLI:
@@ -121,11 +135,13 @@ The template includes all dashboard components, API endpoints, scrapers, and tes
 npx @vatvaghool/create-ipl-dashboard another-league
 ```
 
-Provide a different collection name (e.g. `ipl_2025_friends_league`) and the new league will be stored in its own collection — data stays fully isolated.
+Provide a different league name and the new league will be stored in its own collection/sheet — data stays fully isolated.
 
 ### Viewing seeded data
 
-Connect to the MongoDB instance with any MongoDB client. Each league appears as a separate collection containing a document with `type: "league"` and all the metadata (name, URL, teams, timestamps).
+**MongoDB:** Connect with any MongoDB client. Each league appears as a separate collection with `type: "league"`.
+
+**Google Sheets:** Open your spreadsheet in a browser. Each league has its own sheet (tab) with league metadata in row 2.
 
 ### Production deployment
 
@@ -135,4 +151,23 @@ npm run build
 npx vercel --prod
 ```
 
-Set `IPL_POST_SECRET` in your Vercel dashboard. The `MONGODB_URI` and `COLLECTION_NAME` are already populated in the scaffolded `.env`.
+Set `IPL_POST_SECRET` in your Vercel dashboard. Storage credentials are already populated in the scaffolded `.env`.
+
+### Data sync workflow
+
+```bash
+# 1. Capture browser login (one-time)
+npm run capture:ipl-auth
+
+# 2. Scrape leaderboard (manual or watch mode)
+npm run sync:ipl
+npm run sync:ipl:watch     # auto-poll every 2 min
+
+# 3. Scrape transfer/booster data
+npm run sync:ipl:transfers-daily
+
+# 4. Run all scrapers (for cloud jobs)
+npm run sync:cloud
+```
+
+See the [Available commands](#quick-start-after-scaffold) table above for all options.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vatvaghool/create-ipl-dashboard",
-  "version": "0.1.15",
+  "version": "0.1.18",
   "description": "Scaffold an IPL fantasy cricket dashboard project",
   "type": "module",
   "bin": {

package/src/index.mjs

@@ -3,12 +3,10 @@
 import { join } from "node:path";
 import { existsSync } from "node:fs";
 import { mkdir } from "node:fs/promises";
-import { getProjectName, getMongoUri, getStorageBackend, getGoogleSheetsConfig, getLeagueUrl, getCollectionName, getLeagueName, getTeams, close } from "./prompts.mjs";
+import { getProjectName, getConnectionUrl, getLeagueUrl, getLeagueName, close } from "./prompts.mjs";
 import { scaffoldProject } from "./scaffold.mjs";
 import { scrapeTeamsFromUrl } from "./scraper.mjs";
 
-const DEFAULT_MONGODB_URI = "mongodb+srv://admin:admin@cricket.ptjjrub.mongodb.net/?appName=cricket";
-
 function printHelp(exitCode) {
   console.log(`
   create-ipl-dashboard [project-name] [options]
@@ -61,18 +59,8 @@ async function main() {
 
   await mkdir(projectPath, { recursive: true });
 
-  const storageBackend = await getStorageBackend();
-  let mongoUri = "";
-  let googleSheets = {};
-
-  if (storageBackend === "google_sheets") {
-    googleSheets = await getGoogleSheetsConfig();
-  } else {
-    mongoUri = await getMongoUri(DEFAULT_MONGODB_URI);
-  }
-
+  const conn = await getConnectionUrl();
   const leagueUrl = await getLeagueUrl();
-  const collectionName = await getCollectionName();
   const leagueName = await getLeagueName();
   let teams;
 
@@ -81,17 +69,12 @@ async function main() {
     teams = await scrapeTeamsFromUrl(leagueUrl);
     if (teams && teams.length > 0) {
       console.log(`  Found ${teams.length} team(s): ${teams.map((t) => t.name).join(", ")}`);
-    } else {
-      console.log("  Could not auto-detect teams. Enter them manually:");
-      teams = await getTeams();
     }
-  } else {
-    teams = await getTeams();
   }
 
   close();
 
-  await scaffoldProject(projectPath, { mongoUri, storageBackend, googleSheets, leagueUrl, collectionName, leagueName, teams, skipInstall: flags.skipInstall });
+  await scaffoldProject(projectPath, { conn, leagueUrl, leagueName, teams, skipInstall: flags.skipInstall });
 
   console.log("");
   console.log("  Next steps:");

package/src/prompts.mjs

@@ -1,5 +1,6 @@
 import { createInterface } from "node:readline";
 import { stdin as input, stdout as output, stdin } from "node:process";
+import * as readline from "node:readline";
 
 const isTTY = stdin.isTTY;
 
@@ -24,96 +25,136 @@ function prompt(query) {
   });
 }
 
-export async function getProjectName(args) {
-  if (args[0]) return args[0];
-  if (!isTTY) {
-    await consumeAllLines();
-    return pipedLines[promptIndex++] || "ipl-dashboard";
-  }
-  return (await prompt("Project name: ")).trim() || "ipl-dashboard";
-}
+const BACKEND_VALUES = { mongodb: "mongodb", google_sheets: "google_sheets" };
 
-export async function getMongoUri(defaultUri) {
+async function select(message, choices, valueMap) {
   if (!isTTY) {
     await consumeAllLines();
-    return (pipedLines[promptIndex++] || defaultUri || "").trim();
+    const answer = (pipedLines[promptIndex++] || "").trim().toLowerCase().replace(/[\s_-]+/g, "");
+    const match = choices.find((c) => c.toLowerCase().replace(/[\s_-]+/g, "").startsWith(answer));
+    const idx = match ? choices.indexOf(match) : 0;
+    return valueMap ? valueMap[Object.keys(valueMap)[idx]] : choices[idx];
   }
-  const answer = (await prompt(`MongoDB URI (press Enter for default): `)).trim();
-  return answer || defaultUri || "";
+
+  return new Promise((resolve) => {
+    let selected = 0;
+    const rl = createInterface({ input, output });
+
+    function render(n) {
+      for (let i = 0; i < n; i++) {
+        readline.moveCursor(output, 0, -1);
+        readline.clearLine(output, 0);
+      }
+    }
+
+    process.stdout.write(`${message}\n`);
+    choices.forEach((c, i) => {
+      process.stdout.write(i === selected ? `\x1B[7m  ${c}  \x1B[0m\n` : `  ${c}\n`);
+    });
+
+    const numLines = choices.length;
+
+    readline.emitKeypressEvents(input);
+    if (input.isTTY) input.setRawMode(true);
+
+    function cleanup() {
+      input.setRawMode(false);
+      input.pause();
+      input.removeListener("keypress", handler);
+      rl.close();
+    }
+
+    function handler(str, key) {
+      if (!key) return;
+      if (key.name === "up" && selected > 0) {
+        selected--;
+        for (let i = 0; i < numLines; i++) readline.moveCursor(output, 0, -1);
+        choices.forEach((c, i) => {
+          readline.clearLine(output, 0);
+          readline.cursorTo(output, 0);
+          output.write(i === selected ? `\x1B[7m  ${c}  \x1B[0m` : `  ${c}  `);
+          if (i < numLines - 1) output.write("\n");
+        });
+        output.write("\n");
+      } else if (key.name === "down" && selected < numLines - 1) {
+        selected++;
+        for (let i = 0; i < numLines; i++) readline.moveCursor(output, 0, -1);
+        choices.forEach((c, i) => {
+          readline.clearLine(output, 0);
+          readline.cursorTo(output, 0);
+          output.write(i === selected ? `\x1B[7m  ${c}  \x1B[0m` : `  ${c}  `);
+          if (i < numLines - 1) output.write("\n");
+        });
+        output.write("\n");
+      } else if (key.name === "return") {
+        cleanup();
+        for (let i = 0; i < numLines + 1; i++) {
+          readline.moveCursor(output, 0, -1);
+          readline.clearLine(output, 0);
+        }
+        output.write(`${message} \x1B[32m${choices[selected]}\x1B[0m\n`);
+        const keys = Object.keys(valueMap || {});
+        resolve(valueMap ? valueMap[keys[selected]] : choices[selected]);
+      } else if (key.name === "c" && key.ctrl) {
+        cleanup();
+        process.exit(1);
+      }
+    }
+
+    input.on("keypress", handler);
+  });
 }
 
-export async function getLeagueUrl() {
+export async function getProjectName(args) {
+  if (args[0]) return args[0];
   if (!isTTY) {
     await consumeAllLines();
-    return (pipedLines[promptIndex++] || "").trim();
+    return pipedLines[promptIndex++] || "ipl-dashboard";
   }
-  return (await prompt("IPL fantasy league URL (or press Enter to skip, can be set later): ")).trim();
+  return (await prompt("Project name: ")).trim() || "ipl-dashboard";
 }
 
 export async function getStorageBackend() {
-  if (!isTTY) {
-    await consumeAllLines();
-    return (pipedLines[promptIndex++] || "mongodb").trim();
-  }
-  const answer = (await prompt("Storage backend (mongodb / google_sheets, default: mongodb): ")).trim().toLowerCase();
-  return answer === "google_sheets" ? "google_sheets" : "mongodb";
+  return select("Storage backend:", ["MongoDB", "Google Sheets"], BACKEND_VALUES);
 }
 
-export async function getGoogleSheetsConfig() {
-  if (!isTTY) {
-    await consumeAllLines();
-    const sheetId = (pipedLines[promptIndex++] || "").trim();
-    const email = (pipedLines[promptIndex++] || "").trim();
-    const key = (pipedLines[promptIndex++] || "").trim();
-    return { sheetId, serviceAccountEmail: email, privateKey: key };
+export async function getConnectionUrl() {
+  const backend = await getStorageBackend();
+  if (backend === "google_sheets") {
+    if (!isTTY) {
+      await consumeAllLines();
+      return { backend, sheetId: (pipedLines[promptIndex++] || "").trim(), serviceAccountEmail: (pipedLines[promptIndex++] || "").trim(), privateKey: (pipedLines[promptIndex++] || "").trim() };
+    }
+    console.log("\n  Google Sheets credentials:\n");
+    const sheetId = (await prompt("  Google Sheet ID: ")).trim();
+    const serviceAccountEmail = (await prompt("  Service account email: ")).trim();
+    const privateKey = (await prompt("  Private key (including -----BEGIN/END-----): ")).trim();
+    return { backend, sheetId, serviceAccountEmail, privateKey };
   }
-  console.log("\n  Google Sheets configuration:\n");
-  const sheetId = (await prompt("  Google Sheet ID: ")).trim();
-  const serviceAccountEmail = (await prompt("  Service account email: ")).trim();
-  const privateKey = (await prompt("  Private key (paste the full key, including -----BEGIN/END-----): ")).trim();
-  return { sheetId, serviceAccountEmail, privateKey };
-}
 
-export async function getCollectionName() {
+  const DEFAULT_MONGODB_URI = "mongodb+srv://admin:admin@cricket.ptjjrub.mongodb.net/?appName=cricket";
   if (!isTTY) {
     await consumeAllLines();
-    return (pipedLines[promptIndex++] || "league_data").trim();
+    return { backend, uri: (pipedLines[promptIndex++] || DEFAULT_MONGODB_URI || "").trim() };
   }
-  return (await prompt("Collection/sheet name for this league's data (e.g. ipl_2025_office_league): ")).trim() || "league_data";
+  const answer = (await prompt("MongoDB URI (press Enter for default): ")).trim();
+  return { backend, uri: answer || DEFAULT_MONGODB_URI || "" };
 }
 
-export async function getLeagueName() {
+export async function getLeagueUrl() {
   if (!isTTY) {
     await consumeAllLines();
-    return (pipedLines[promptIndex++] || "My IPL League").trim();
+    return (pipedLines[promptIndex++] || "").trim();
   }
-  return (await prompt("League name (e.g. Office Fantasy League): ")).trim() || "My IPL League";
+  return (await prompt("IPL fantasy league URL: ")).trim();
 }
 
-export async function getTeams() {
+export async function getLeagueName() {
   if (!isTTY) {
     await consumeAllLines();
-    const count = Math.max(1, parseInt(pipedLines[promptIndex++], 10) || 9);
-    const teams = [];
-    for (let i = 0; i < count; i++) {
-      const line = pipedLines[promptIndex++] || "";
-      const parts = line.split(",").map((s) => s.trim());
-      teams.push({ id: i + 1, name: parts[0] || `Team ${i + 1}`, owner: parts[1] || parts[0] || `Team ${i + 1}` });
-    }
-    return teams;
-  }
-
-  const countAnswer = await prompt("How many teams in your league? (default: 9): ");
-  const count = Math.max(1, parseInt(countAnswer, 10) || 9);
-
-  console.log(`\nEnter ${count} team(s) — at minimum a name, optionally an owner:\n`);
-  const teams = [];
-  for (let i = 0; i < count; i++) {
-    const line = await prompt(`  Team ${i + 1} (Name or "Name,Owner"): `);
-    const parts = line.split(",").map((s) => s.trim());
-    teams.push({ id: i + 1, name: parts[0] || `Team ${i + 1}`, owner: parts[1] || parts[0] || `Team ${i + 1}` });
+    return (pipedLines[promptIndex++] || "my_league").trim();
   }
-  return teams;
+  return (await prompt("League name (used as collection/table name, e.g. my_office_league): ")).trim() || "my_league";
 }
 
 export function close() {}

package/src/scaffold.mjs

@@ -10,7 +10,7 @@ const TEMPLATE_DIR = join(PACKAGE_ROOT, "template");
 
 export async function scaffoldProject(
   projectPath,
-  { mongoUri, storageBackend, googleSheets, leagueUrl, collectionName, leagueName, teams, skipInstall = false },
+  { conn, leagueUrl, leagueName, teams, skipInstall = false },
 ) {
   console.log(`\nCreating project at ${projectPath}...`);
 
@@ -34,17 +34,14 @@ export async function scaffoldProject(
   }
 
   await writeEnvFile(projectPath, {
-    mongoUri,
-    storageBackend,
-    googleSheets,
+    conn,
     leagueUrl,
-    collectionName,
     leagueName,
   });
-  await writeTeamData(projectPath, teams);
-  await writeLeagueData(projectPath, { leagueName, leagueUrl, teams });
+  await writeTeamData(projectPath, teams || []);
+  await writeLeagueData(projectPath, { leagueName, leagueUrl, teams: teams || [] });
   await writeMatchPointsPlaceholder(projectPath);
-  await updatePackageJson(projectPath, storageBackend);
+  await updatePackageJson(projectPath, conn.backend);
 
   for (const f of [
     "app/api/ipl/live-snapshot.json",
@@ -62,7 +59,7 @@ export async function scaffoldProject(
     if (leagueName) {
       console.log("  Seeding league metadata...");
       try {
-        execSync(`npm run seed:league -- "${leagueName}" "${collectionName}"`, {
+        execSync(`npm run seed:league -- "${leagueName}" "${leagueName}"`, {
           cwd: projectPath,
           stdio: "inherit",
         });
@@ -81,16 +78,15 @@ export async function scaffoldProject(
 
 async function writeEnvFile(
   projectPath,
-  { mongoUri, storageBackend, googleSheets, leagueUrl, collectionName, leagueName },
+  { conn, leagueUrl, leagueName },
 ) {
   const envPath = join(projectPath, ".env");
   const lines = [
-    `STORAGE_BACKEND=${storageBackend || "mongodb"}`,
-    `MONGODB_URI=${mongoUri || ""}`,
-    `COLLECTION_NAME=${collectionName || "league_data"}`,
-    `GOOGLE_SHEET_ID=${(googleSheets && googleSheets.sheetId) || ""}`,
-    `GOOGLE_SERVICE_ACCOUNT_EMAIL=${(googleSheets && googleSheets.serviceAccountEmail) || ""}`,
-    `GOOGLE_PRIVATE_KEY=${(googleSheets && googleSheets.privateKey) || ""}`,
+    `STORAGE_BACKEND=${conn.backend || "mongodb"}`,
+    `COLLECTION_NAME=${leagueName || "my_league"}`,
+    conn.backend === "google_sheets" ? `GOOGLE_SHEET_ID=${conn.sheetId || ""}` : `MONGODB_URI=${conn.uri || ""}`,
+    conn.backend === "google_sheets" ? `GOOGLE_SERVICE_ACCOUNT_EMAIL=${conn.serviceAccountEmail || ""}` : "",
+    conn.backend === "google_sheets" ? `GOOGLE_PRIVATE_KEY=${conn.privateKey || ""}` : "",
     `IPL_LEAGUE_URL=${leagueUrl || ""}`,
     `IPL_LEAGUE_NAME=${leagueName || ""}`,
     `IPL_POST_SECRET=`,
@@ -100,7 +96,7 @@ async function writeEnvFile(
     `IPL_API_LOG_PAYLOAD=0`,
     `IPL_WRITE_SEED_DATA_FILE=1`,
     ``,
-  ];
+  ].filter(Boolean);
   await writeFile(envPath, lines.join("\n"));
 }
 

package/template/README.md

@@ -12,15 +12,7 @@ npx @vatvaghool/create-ipl-dashboard my-league
 npm install
 ```
 
-Create a `.env` file:
-
-```env
-MONGODB_URI=your_mongodb_connection_string
-IPL_LEAGUE_URL=https://fantasy.iplt20.com/classic/league/view/your_league_id
-IPL_POST_SECRET=your_secret_here
-```
-
-Start the app:
+Start the dev server:
 
 ```bash
 npm run dev:simple
@@ -28,6 +20,27 @@ npm run dev:simple
 
 Open http://localhost:3000
 
+### Available commands
+
+| Command | Description |
+|---------|-------------|
+| `npm run dev` | Dev server with welcome splash |
+| `npm run dev:simple` | Dev server (simple, no splash) |
+| `npm run build` | Production build |
+| `npm start` | Production server |
+| `npm run capture:ipl-auth` | Capture Playwright login state (one-time) |
+| `npm run sync:ipl` | Scrape live leaderboard snapshot |
+| `npm run sync:ipl:watch` | Scrape leaderboard in watch mode (polls every 2 min) |
+| `npm run sync:ipl:transfers-daily` | Scrape transfer/booster data |
+| `npm run sync:cloud` | Run both leaderboard + transfer sync (for cloud jobs) |
+| `npm run seed:league` | Seed league metadata into storage |
+| `npm run seed:mongodb` | Seed initial raw user data from `data.ts` |
+| `npm run seed:mongodb:reset` | Reset and re-seed MongoDB data |
+| `npm run verify:production` | Verify production setup |
+| `npm run monitor:ops` | Check ops health status |
+| `npm run test` | Run test suite |
+| `npm run lint` | Run linter |
+
 ---
 
 ## Screenshots
@@ -116,9 +129,9 @@ Open http://localhost:3000
 
 ```
 GET /api/ipl resolution order:
-  1. MongoDB raw users (if MONGODB_URI configured)
+  1. Storage raw users (if configured — MongoDB or Google Sheets)
   2. Fallback: local seed data (app/api/ipl/data.ts)
-  3. MongoDB live snapshot (if MONGODB_URI configured)
+  3. Storage live snapshot (if configured)
   4. Fallback: local snapshot file (app/api/ipl/live-snapshot.json)
 ```
 
@@ -130,11 +143,16 @@ All hardcoded values are centralized in `app/lib/config.ts` and overridable via
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `MONGODB_URI` | - | MongoDB connection string |
+| `STORAGE_BACKEND` | `mongodb` | Storage backend: `mongodb` or `google_sheets` |
+| `MONGODB_URI` | - | MongoDB connection string (for MongoDB backend) |
+| `GOOGLE_SHEET_ID` | - | Google Sheet ID (for Google Sheets backend) |
+| `GOOGLE_SERVICE_ACCOUNT_EMAIL` | - | Google service account email |
+| `GOOGLE_PRIVATE_KEY` | - | Google service account private key |
+| `LEAGUE_NAME` | - | League name (collection/sheet name) |
 | `IPL_LEAGUE_URL` | fantasy.iplt20.com/... | Fantasy league page URL |
 | `IPL_POST_SECRET` | - | Bearer token for POST endpoints |
-| `IPL_DB_NAME` | `ipl` | MongoDB database name |
-| `IPL_COLLECTION_NAME` | `ipl` | MongoDB collection name |
+| `IPL_DB_NAME` | `ipl` | MongoDB database name (MongoDB only) |
+| `IPL_COLLECTION_NAME` | `ipl` | MongoDB collection name (MongoDB only) |
 | `IPL_TOTAL_TRANSFERS` | `160` | Total transfers per season |
 | `IPL_SYNC_INTERVAL_MS` | `120000` | Dashboard polling interval |
 | `IPL_DASHBOARD_STALE_MINUTES` | `20` (prod) / `180` (dev) | Staleness threshold |
@@ -144,19 +162,7 @@ All hardcoded values are centralized in `app/lib/config.ts` and overridable via
 
 ## Automation
 
-```bash
-# Capture login state for Playwright scrapers
-npm run capture:ipl-auth
-
-# Scrape live leaderboard snapshot
-npm run sync:ipl
-
-# Scrape transfer/booster data
-npm run sync:ipl:transfers
-
-# Run both in sequence (for cloud jobs)
-npm run sync:cloud
-```
+See the [commands table](#available-commands) above for all options.
 
 Also supports a browser bookmarklet — visit `/api/ipl/bookmarklet` while the app is running, copy the returned `javascript:` code, and save it as a bookmark. Click it on the fantasy leaderboard page to sync data.
 
@@ -178,7 +184,12 @@ Set these environment variables in your Vercel project dashboard:
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `MONGODB_URI` | Yes | MongoDB connection string |
+| `STORAGE_BACKEND` | Yes | `mongodb` or `google_sheets` |
+| `MONGODB_URI` | Yes* | MongoDB connection string (required if `mongodb`) |
+| `GOOGLE_SHEET_ID` | Yes* | Google Sheet ID (required if `google_sheets`) |
+| `GOOGLE_SERVICE_ACCOUNT_EMAIL` | Yes* | Service account email (required if `google_sheets`) |
+| `GOOGLE_PRIVATE_KEY` | Yes* | Private key (required if `google_sheets`) |
+| `LEAGUE_NAME` | Yes | Collection or sheet name |
 | `IPL_POST_SECRET` | Yes | Bearer token protecting write endpoints |
 | `IPL_LEAGUE_URL` | Yes | Your fantasy league page URL |
 | `IPL_DASHBOARD_STALE_MINUTES` | No | Staleness threshold for health checks (default: `20`) |
@@ -204,7 +215,7 @@ The app runs as a standard Node.js server on `process.env.PORT` (default `3000`)
 
 ### Production requirements
 
-- **MongoDB** is required in production for POST endpoints (returns `503` without it)
+- **Storage** (MongoDB or Google Sheets) is required in production for POST endpoints (returns `503` without it)
 - **IPL_POST_SECRET** should be a strong random value set in your hosting environment
 - The scraper should run outside the web app (Cloud Run, GitHub Actions, cron) — never in the same process
 
@@ -218,6 +229,6 @@ The app runs as a standard Node.js server on `process.env.PORT` (default `3000`)
 - **Tailwind CSS** 4
 - **Recharts** — charts
 - **Framer Motion** — animations
-- **MongoDB** — data persistence
+- **MongoDB** or **Google Sheets** — data persistence
 - **Zustand** — client state
 - **Playwright** — scraper automation