@vatvaghool/create-ipl-dashboard 0.1.20 → 0.1.23

package/README.md

@@ -4,13 +4,16 @@ Scaffold a full-featured IPL fantasy cricket dashboard in seconds.
 
 ```bash
 npx @vatvaghool/create-ipl-dashboard my-league
+cd my-league
+# Edit .env with your MongoDB URI, league URL and POST secret
+npm run dev:simple
 ```
 
-Follow the prompts to enter your MongoDB URI, fantasy league URL, and league name — you get a ready-to-run Next.js dashboard with standings charts, performance trackers, AI roasts, and more.
+Open http://localhost:3000
 
 ## Usage
 
-```bash
+```
 npx @vatvaghool/create-ipl-dashboard [project-name] [options]
 ```
 
@@ -19,149 +22,61 @@ npx @vatvaghool/create-ipl-dashboard [project-name] [options]
 | Flag | Description |
 |------|-------------|
 | `--help`, `-h` | Show help message |
-| `--scrape` | Auto-detect team names from the league URL |
 | `--skip-install` | Skip `npm install` (useful for testing) |
 
-### Interactive prompts
+### Prompts
 
 | Prompt | Description |
 |--------|-------------|
 | Project name | Directory to scaffold into |
-| MongoDB URI | Your MongoDB connection string (press Enter for default) |
-| League URL | The fantasy.iplt20.com league page URL |
 | League name | Used as MongoDB collection name |
-| Team names | Comma-separated with optional owner in parens, e.g. `Team A (Alice), Team B (Bob)` (press Enter for defaults) |
-
-Use `--scrape` to auto-detect from the league URL, or press Enter at the team names prompt for default placeholder teams. You can always edit `app/data/teams.ts` later.
-
-## Screenshots
-
-![](https://files.catbox.moe/a83xlk.png)
-
-*Dashboard overview — full page*
-
-![](https://files.catbox.moe/hl0kxd.png)
-
-*Performance Tracker — Recharts line chart*
-
-![](https://files.catbox.moe/k4sw53.png)
-
-*Captain Board — captain/vice-captain picks*
+| Team names | Comma-separated with optional owner in parens e.g. `Team A (Alice), Team B (Bob)` (Enter for 8 default teams) |
 
-![](https://files.catbox.moe/vt5i8w.png)
+### Setup
 
-*Ledger Table — standings with rank shifts and efficiency*
+After scaffolding, edit `.env` and fill in:
 
-![](https://files.catbox.moe/tuvkjo.png)
-
-*Match Scrubber — interactive timeline scrubber*
-
-![](https://files.catbox.moe/5nfi5i.png)
-
-*AI Roast Corner — generated commentary*
-
-## What you get
-
-A full Next.js 16 project with:
-
-- **Leaderboard dashboard** — live standings with rank movements and point gaps
-- **Performance charts** — Recharts line charts tracking every team's trajectory
-- **Captain board** — captain/vice-captain picks per team
-- **Match scrubber** — interactive timeline through match history
-- **AI roasting** — generated commentary in multiple languages
-- **Stock ticker** — fantasy stocks with sparklines
-- **Live updates** — bookmarklet or Playwright scraper for live sync
-- **MongoDB persistence** — auto-configured database connection with collection per league
+```
+MONGODB_URI=mongodb+srv://...
+IPL_LEAGUE_URL=https://fantasy.iplt20.com/classic/league/view/...
+IPL_POST_SECRET=your-secret
+```
 
-## Quick start after scaffold
+Then seed data and start syncing:
 
 ```bash
-cd my-league
-
-# Start the dev server
-npm run dev:simple
+npm run seed:api          # Seed match data into MongoDB
+npm run seed:league       # Seed league metadata
+npm run capture:ipl-auth  # One-time Playwright login
+npm run sync:ipl:watch    # Start live sync
 ```
 
-Open http://localhost:3000 to see your dashboard.
-
-### Available commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `npm run dev` | Dev server with welcome splash |
-| `npm run dev:simple` | Dev server (simple, no splash) |
+| `npm run dev:simple` | Start dev server |
 | `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 sync:ipl:watch` | Scrape leaderboard in watch mode |
+| `npm run sync:cloud` | Run all scrapers |
+| `npm run seed:api` | POST /api/ops/seed — seed match data into MongoDB |
+| `npm run seed:league` | Seed league metadata into MongoDB |
+| `npm run test` | Run tests |
 | `npm run lint` | Run linter |
 
-## How it works
+## API
 
-The CLI:
+| Route | Method | Description |
+|-------|--------|-------------|
+| `/api/ipl` | GET | Dashboard payload |
+| `/api/ipl` | POST | Ingest leaderboard snapshot |
+| `/api/ipl/transfers` | GET/POST | Transfer/booster data |
+| `/api/ipl/upcoming-matches` | GET | Upcoming match schedule |
+| `/api/ops/status` | GET | Health check |
+| `/api/ops/seed` | POST | Seed initial match data into MongoDB |
 
-1. Copies a pre-built Next.js app template
-2. Writes your `.env` with the `MONGODB_URI`, `COLLECTION_NAME`, league URL, and league name
-3. Generates `app/data/teams.ts` with your team roster (if `--scrape` was used)
-4. Generates `app/data/league.ts` with league metadata
-5. Creates a placeholder `app/data/match-points.ts` (auto-populates as you sync)
-6. Installs dependencies
-7. Runs `seed:league` to create a **document in your specified collection** in the pre-configured database, storing league metadata (name, URL, teams, timestamps)
-
-Each league gets its own collection — run `create-ipl-dashboard` again with a different league name to add another league.
-
-The template includes all dashboard components, API endpoints, scrapers, and tests from the [ipl-dashboard](https://github.com/anomalyco/ipl-dashboard) project.
-
----
-
-## Next Steps
-
-### Adding more leagues
-
-```bash
-npx @vatvaghool/create-ipl-dashboard another-league
-```
-
-Provide a different league name and the new league will be stored in its own collection — data stays fully isolated.
-
-### Viewing seeded data
-
-Connect with any MongoDB client. Each league appears as a separate collection with `type: "league"`.
-
-### Production deployment
-
-```bash
-cd my-league
-npm run build
-npx vercel --prod
-```
-
-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
-```
+## Project
 
-See the [Available commands](#quick-start-after-scaffold) table above for all options.
+A full Next.js 16 project with dashboard components, API endpoints, scrapers, and tests.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vatvaghool/create-ipl-dashboard",
-  "version": "0.1.20",
+  "version": "0.1.23",
   "description": "Scaffold an IPL fantasy cricket dashboard project",
   "type": "module",
   "bin": {
@@ -8,8 +8,7 @@
   },
   "files": [
     "src",
-    "template",
-    "screenshots"
+    "template"
   ],
   "publishConfig": {
     "access": "public"

package/src/index.mjs

@@ -3,9 +3,8 @@
 import { join } from "node:path";
 import { existsSync } from "node:fs";
 import { mkdir } from "node:fs/promises";
-import { getProjectName, getMongoUri, getLeagueUrl, getLeagueName, getTeams, close } from "./prompts.mjs";
+import { getProjectName, getLeagueName, getTeams, close } from "./prompts.mjs";
 import { scaffoldProject } from "./scaffold.mjs";
-import { scrapeTeamsFromUrl } from "./scraper.mjs";
 
 function printHelp(exitCode) {
   console.log(`
@@ -19,11 +18,9 @@ function printHelp(exitCode) {
   Options:
     --help, -h             Show this help message
     --skip-install         Skip npm install after scaffolding
-    --scrape               Auto-detect team names from the league URL
 
   Examples:
     npx create-ipl-dashboard my-league
-    npx create-ipl-dashboard my-league --scrape
     npx create-ipl-dashboard --skip-install
 `);
   process.exit(exitCode);
@@ -31,12 +28,11 @@ function printHelp(exitCode) {
 
 async function main() {
   const args = process.argv.slice(2);
-  const flags = { scrape: false, skipInstall: false, help: false };
+  const flags = { skipInstall: false, help: false };
   const positional = [];
 
   for (const arg of args) {
     if (arg === "--help" || arg === "-h") flags.help = true;
-    else if (arg === "--scrape") flags.scrape = true;
     else if (arg === "--skip-install") flags.skipInstall = true;
     else if (!arg.startsWith("--")) positional.push(arg);
     else { console.error(`Unknown flag: ${arg}`); printHelp(1); }
@@ -59,22 +55,9 @@ async function main() {
 
   await mkdir(projectPath, { recursive: true });
 
-  const mongoUri = await getMongoUri();
-  const leagueUrl = await getLeagueUrl();
   const leagueName = await getLeagueName();
 
-  let teams;
-  if (flags.scrape && leagueUrl) {
-    console.log("  Attempting to scrape team names from league URL...");
-    teams = await scrapeTeamsFromUrl(leagueUrl);
-    if (teams && teams.length > 0) {
-      console.log(`  Found ${teams.length} team(s): ${teams.map((t) => t.name).join(", ")}`);
-    }
-  }
-
-  if (!teams) {
-    teams = await getTeams();
-  }
+  let teams = await getTeams();
 
   if (!teams || teams.length === 0) {
     teams = [
@@ -91,18 +74,14 @@ async function main() {
 
   close();
 
-  await scaffoldProject(projectPath, { mongoUri, leagueUrl, leagueName, teams, skipInstall: flags.skipInstall });
+  await scaffoldProject(projectPath, { leagueName, teams, skipInstall: flags.skipInstall });
 
   console.log("");
   console.log("  Next steps:");
   console.log(`    cd ${projectName}`);
+  console.log("    Edit .env — set MONGODB_URI, IPL_LEAGUE_URL and IPL_POST_SECRET");
   console.log("    npm run dev:simple");
   console.log("");
-  console.log("  For live data sync, capture auth state:");
-  console.log(`    cd ${projectName}`);
-  console.log("    npm run capture:ipl-auth");
-  console.log("    npm run sync:ipl");
-  console.log("");
 }
 
 main().catch((err) => {

package/src/prompts.mjs

@@ -33,25 +33,6 @@ export async function getProjectName(args) {
   return (await prompt("Project name: ")).trim() || "ipl-dashboard";
 }
 
-const DEFAULT_MONGODB_URI = "mongodb+srv://admin:admin@cricket.ptjjrub.mongodb.net/?appName=cricket";
-
-export async function getMongoUri() {
-  if (!isTTY) {
-    await consumeAllLines();
-    return (pipedLines[promptIndex++] || DEFAULT_MONGODB_URI || "").trim();
-  }
-  const answer = (await prompt("MongoDB URI (press Enter for default): ")).trim();
-  return answer || DEFAULT_MONGODB_URI || "";
-}
-
-export async function getLeagueUrl() {
-  if (!isTTY) {
-    await consumeAllLines();
-    return (pipedLines[promptIndex++] || "").trim();
-  }
-  return (await prompt("IPL fantasy league URL: ")).trim();
-}
-
 export async function getLeagueName() {
   if (!isTTY) {
     await consumeAllLines();

package/src/scaffold.mjs

@@ -10,7 +10,7 @@ const TEMPLATE_DIR = join(PACKAGE_ROOT, "template");
 
 export async function scaffoldProject(
   projectPath,
-  { mongoUri, leagueUrl, leagueName, teams, skipInstall = false },
+  { leagueName, teams, skipInstall = false },
 ) {
   console.log(`\nCreating project at ${projectPath}...`);
 
@@ -33,13 +33,9 @@ export async function scaffoldProject(
     } catch {}
   }
 
-  await writeEnvFile(projectPath, {
-    mongoUri,
-    leagueUrl,
-    leagueName,
-  });
+  await writeEnvFile(projectPath, { leagueName });
   await writeTeamData(projectPath, teams || []);
-  await writeLeagueData(projectPath, { leagueName, leagueUrl, teams: teams || [] });
+  await writeLeagueData(projectPath, { leagueName, teams: teams || [] });
   await writeMatchPointsPlaceholder(projectPath);
   await updatePackageJson(projectPath);
 
@@ -56,16 +52,11 @@ export async function scaffoldProject(
     console.log("  Running npm install...");
     execSync("npm install", { cwd: projectPath, stdio: "inherit" });
 
-    if (leagueName) {
-      console.log("  Seeding league metadata...");
-      try {
-        execSync(`npm run seed:league -- "${leagueName}" "${leagueName}"`, {
-          cwd: projectPath,
-          stdio: "inherit",
-        });
-      } catch {
-        console.log("  League seed skipped (storage may not be reachable yet)");
-      }
+    console.log("  Installing Playwright browser...");
+    try {
+      execSync("npx playwright install chromium", { cwd: projectPath, stdio: "inherit" });
+    } catch {
+      console.log("  Playwright install skipped (run manually: npx playwright install chromium)");
     }
   } else {
     console.log(
@@ -76,18 +67,21 @@ export async function scaffoldProject(
   console.log("\n  Done! Your project is ready at:", projectPath);
 }
 
-async function writeEnvFile(
-  projectPath,
-  { mongoUri, leagueUrl, leagueName },
-) {
+async function writeEnvFile(projectPath, { leagueName }) {
   const envPath = join(projectPath, ".env");
   const lines = [
     `COLLECTION_NAME=${leagueName || "my_league"}`,
-    `MONGODB_URI=${mongoUri || ""}`,
-    `IPL_LEAGUE_URL=${leagueUrl || ""}`,
+    `MONGODB_URI=`,
+    `IPL_LEAGUE_URL=`,
     `IPL_LEAGUE_NAME=${leagueName || ""}`,
     `IPL_POST_SECRET=`,
     ``,
+    `# Replace the values above, then run:`,
+    `#   npm run seed:api        (seed match data into MongoDB)`,
+    `#   npm run seed:league     (seed league metadata)`,
+    `#   npm run capture:ipl-auth (one-time login)`,
+    `#   npm run sync:ipl        (scrape live leaderboard)`,
+    ``,
     `IPL_API_BASE_URL=http://localhost:3000`,
     `IPL_API_LOG=1`,
     `IPL_API_LOG_PAYLOAD=0`,
@@ -137,7 +131,7 @@ for (const team of TEAMS) {
   await writeFile(join(dir, "teams.ts"), content);
 }
 
-async function writeLeagueData(projectPath, { leagueName, leagueUrl, teams }) {
+async function writeLeagueData(projectPath, { leagueName, teams }) {
   const dir = join(projectPath, "app/data");
   await mkdir(dir, { recursive: true });
 
@@ -153,7 +147,7 @@ async function writeLeagueData(projectPath, { leagueName, leagueUrl, teams }) {
 
 export const leagueInfo: LeagueInfo = {
   name: "${leagueName || ""}",
-  leagueUrl: "${leagueUrl || ""}",
+  leagueUrl: "",
   teams: [
 ${teamEntries},
   ],
@@ -188,6 +182,7 @@ async function updatePackageJson(projectPath) {
     pkg.private = false;
     delete pkg.scripts?.["generate:template"];
     pkg.scripts["seed:league"] = "node scripts/seed-league.mjs";
+    pkg.scripts["seed:api"] = "node --experimental-strip-types -e \"fetch('http://localhost:3000/api/ops/seed',{method:'POST'}).then(r=>r.json()).then(console.log).catch(console.error)\"";
     await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
   } catch {}
 }

package/template/README.md

@@ -1,226 +1,57 @@
 # IPL Fantasy Cricket Dashboard
 
-Private Next.js dashboard for an IPL fantasy league. Combines seeded match history with live leaderboard snapshots to show standings, match-by-match movement, captain picks, cumulative trends, and league insights in one place.
-
 ## Quick Start
 
 ```bash
-# Scaffold a new project
 npx @vatvaghool/create-ipl-dashboard my-league
-
-# Or from source:
-npm install
-```
-
-Start the dev server:
-
-```bash
-npm run dev:simple
+cd my-league
+# Edit .env — set MONGODB_URI, IPL_LEAGUE_URL and IPL_POST_SECRET
+npm run seed:api          # Seed match data into MongoDB
+npm run seed:league       # Seed league metadata
+npm run capture:ipl-auth  # One-time Playwright login
+npm run sync:ipl:watch    # Start live sync
 ```
 
 Open http://localhost:3000
 
-### Available commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
-| `npm run dev` | Dev server with welcome splash |
-| `npm run dev:simple` | Dev server (simple, no splash) |
+| `npm run dev:simple` | Start dev server |
 | `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 sync:ipl:watch` | Scrape leaderboard in watch mode |
+| `npm run sync:cloud` | Run all scrapers |
+| `npm run seed:api` | Seed match data into MongoDB |
+| `npm run seed:league` | Seed league metadata |
+| `npm run test` | Run tests |
 | `npm run lint` | Run linter |
 
----
-
-## Screenshots
-
-![](https://files.catbox.moe/a83xlk.png)
-
-*Dashboard overview — full page*
-
-![](https://files.catbox.moe/hl0kxd.png)
-
-*Performance Tracker — Recharts line chart*
-
-![](https://files.catbox.moe/k4sw53.png)
-
-*Captain Board — captain/vice-captain picks*
-
-![](https://files.catbox.moe/vt5i8w.png)
-
-*Ledger Table — standings with rank shifts and efficiency*
-
-![](https://files.catbox.moe/tuvkjo.png)
-
-*Match Scrubber — interactive timeline scrubber*
-
-![](https://files.catbox.moe/5nfi5i.png)
-
-*AI Roast Corner — generated commentary*
-
----
-
-## Components
-
-### Dashboard Sections
-
-| Component | File | Description |
-|-----------|------|-------------|
-| **StickyMini** | `components/dashboard/StickyMini.tsx` | Compact stat card with title, value, note, and color-coded icon |
-| **SectionCard** | `components/dashboard/SectionCard.tsx` | Animated motion-section wrapper with title, note, accent color, and staggered entrance |
-| **ChartBoard** | `components/dashboard/ChartBoard.tsx` | Recharts bar chart for team data with pill tags and tooltips |
-| **CaptainBoard** | `components/dashboard/CaptainBoard.tsx` | All playing players with points as TeamPills badges, C/VC highlighted |
-| **LedgerTable** | `components/dashboard/LedgerTable.tsx` | Full standings table with colors, boosters, rank arrows, and formatted points |
-| **LatestBadge** | `components/dashboard/LatestBadge.tsx` | Color-coded pill badge for points (pink <200, orange 200-400, green >400) |
-
-### Widgets
-
-| Component | File | Description |
-|-----------|------|-------------|
-| **PerformanceTracker** | `components/PerformanceTracker.tsx` | Recharts line chart tracking each team's point trajectory across match days |
-| **CrownBattle** | `components/CrownBattle.tsx` | Head-to-head showdown between #1 and #2 ranked teams |
-| **AIRoasting** | `components/AIRoasting.tsx` | AI-generated roast commentary cards cycling through hot/cold/lightning/trend types |
-| **FantasyStockTicker** | `components/FantasyStockTicker.tsx` | Team stocks with trend arrows, sparklines, and fluctuating values |
-| **TeamDNAScanner** | `components/TeamDNAScanner.tsx` | Sci-fi DNA scan visualization with moving scan-line and std deviation metrics |
-| **MatchRecapScroll** | `components/MatchRecapScroll.tsx` | Scroll-styled recap panel for the latest match day results |
-| **MatchStoryScrubber** | `components/MatchStoryScrubber.tsx` | Interactive timeline scrubber to step through match history with bar charts |
-| **LiveMatchTicker** | `components/LiveMatchTicker.tsx` | Live-scrolling ticker of upcoming matches with countdowns |
-| **ProgressGlowRings** | `components/ProgressGlowRings.tsx` | Animated SVG glowing ring progress indicators per team |
-| **ColorWave** | `components/ColorWave.tsx` | Animated SVG wave/chart visualizing team scores over time |
-| **FireworksBurst** | `components/FireworksBurst.tsx` | Particle-based fireworks celebration on milestones |
-| **ThemeToggle** | `components/ThemeToggle.tsx` | Dark/light mode toggle persisted to localStorage |
-
-### UI Primitives
-
-| Component | File | Description |
-|-----------|------|-------------|
-| **TeamPills** | `components/ui/TeamPills.tsx` | Flex-wrap row of bordered pill/chip team labels |
-| **DashboardChartFrame** | `components/ui/DashboardChartFrame.tsx` | Responsive chart wrapper with hover-jitter effects |
-| **DoodleSpinner** | `components/ui/DoodleSpinner.tsx` | Hand-drawn SVG loading spinner with dotted circles |
-
----
-
-## API Endpoints
+## API
 
 | Route | Method | Description |
 |-------|--------|-------------|
-| `/api/ipl` | GET | Full dashboard payload used by the UI |
-| `/api/ipl?format=snapshot` | GET | Raw normalized snapshot only |
-| `/api/ipl` | POST | Ingest a leaderboard snapshot |
-| `/api/ipl/transfers` | GET | Transfer/booster snapshot for all teams (fetched once on mount, not on poll) |
-| `/api/ipl/transfers` | POST | Ingest a single team transfer record |
+| `/api/ipl` | GET | Dashboard payload |
+| `/api/ipl` | POST | Ingest leaderboard snapshot |
+| `/api/ipl/transfers` | GET/POST | Transfer/booster data |
 | `/api/ipl/upcoming-matches` | GET | Upcoming match schedule |
-| `/api/ops/status` | GET | Health/monitoring endpoint |
-
----
-
-## Data Flow
-
-```
-GET /api/ipl resolution order:
-  1. MongoDB raw users (if MONGODB_URI configured)
-  2. Fallback: local seed data (app/api/ipl/data.ts)
-  3. MongoDB live snapshot (if MONGODB_URI configured)
-  4. Fallback: local snapshot file (app/api/ipl/live-snapshot.json)
-```
-
----
-
-## Configuration
-
-All hardcoded values are centralized in `app/lib/config.ts` and overridable via environment variables:
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `MONGODB_URI` | - | MongoDB connection string |
-| `LEAGUE_NAME` | - | League name (collection 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_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 |
-| `IPL_TRANSFERS_STALE_MINUTES` | `720` (prod) / `1440` (dev) | Transfer staleness threshold |
-
----
-
-## Automation
-
-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.
-
----
+| `/api/ops/status` | GET | Health check |
+| `/api/ops/seed` | POST | Seed initial match data into MongoDB |
 
 ## Deployment
 
-### Deploy to Vercel (recommended)
-
 ```bash
-# Build the app
 npm run build
-
-# Deploy to Vercel
 npx vercel --prod
 ```
 
-Set these environment variables in your Vercel project dashboard:
-
-| Variable | Required | Description |
-|----------|----------|-------------|
-| `MONGODB_URI` | Yes | MongoDB connection string |
-| `LEAGUE_NAME` | Yes | MongoDB collection 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`) |
-| `IPL_TRANSFERS_STALE_MINUTES` | No | Transfer staleness threshold (default: `720`) |
-
-After deployment:
-
-1. Verify the app is healthy — visit `https://your-app.vercel.app/api/ops/status`
-2. Run the Playwright scraper (`npm run sync:cloud`) pointed at your production URL to populate live data
-3. Optionally deploy the scraper as a Cloud Run Job with `Dockerfile.sync` for automated sync every 5-10 minutes
-
-### Without Vercel
-
-```bash
-# Build
-npm run build
-
-# Start production server
-npm start
-```
-
-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)
-- **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
-
----
+Set `MONGODB_URI`, `COLLECTION_NAME`, `IPL_LEAGUE_URL`, and `IPL_POST_SECRET` in your Vercel dashboard.
 
 ## Stack
 
-- **Next.js** 16 App Router
-- **React** 19
-- **TypeScript**
-- **Tailwind CSS** 4
-- **Recharts** — charts
-- **Framer Motion** — animations
+- **Next.js** 16 App Router, **React** 19, **TypeScript**, **Tailwind CSS** 4
+- **Recharts**, **Framer Motion**, **Zustand**
 - **MongoDB** — data persistence
-- **Zustand** — client state
 - **Playwright** — scraper automation