@vatvaghool/create-ipl-dashboard 0.1.18 → 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, collection name, and team names — 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,155 +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 |
-| Storage backend | `mongodb` (default) or `google_sheets` |
-| MongoDB URI | Your MongoDB connection string (only if MongoDB chosen, press Enter for default) |
-| Google Sheet ID | Google Sheet ID (only if google_sheets chosen) |
-| Service account email | Google service account email (only if google_sheets chosen) |
-| 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 | Used as collection/table name in storage |
-
-Set team names later via `app/data/teams.ts` or use `--scrape` to auto-detect from the league URL during scaffolding.
-
-## 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)
+| League name | Used as MongoDB collection name |
+| Team names | Comma-separated with optional owner in parens e.g. `Team A (Alice), Team B (Bob)` (Enter for 8 default teams) |
 
-*Ledger Table — standings with rank shifts and efficiency*
+### Setup
 
-![](https://files.catbox.moe/tuvkjo.png)
+After scaffolding, edit `.env` and fill in:
 
-*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
+```
+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
-
-The CLI:
+## API
 
-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
-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)
+| 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 |
 
-Each league gets its own collection — run `create-ipl-dashboard` again with a different collection 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/sheet — data stays fully isolated.
-
-### Viewing seeded data
-
-**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
-
-```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.18",
+  "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, getConnectionUrl, getLeagueUrl, getLeagueName, 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,33 +55,33 @@ async function main() {
 
   await mkdir(projectPath, { recursive: true });
 
-  const conn = await getConnectionUrl();
-  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(", ")}`);
-    }
+
+  let teams = await getTeams();
+
+  if (!teams || teams.length === 0) {
+    teams = [
+      { id: 1, name: "The Cricketers", owner: "Player 1" },
+      { id: 2, name: "Six Hitters", owner: "Player 2" },
+      { id: 3, name: "Bowling Titans", owner: "Player 3" },
+      { id: 4, name: "Fielding Masters", owner: "Player 4" },
+      { id: 5, name: "Night Watchmen", owner: "Player 5" },
+      { id: 6, name: "Super Kings", owner: "Player 6" },
+      { id: 7, name: "Royal Challengers", owner: "Player 7" },
+      { id: 8, name: "Mumbai Indians", owner: "Player 8" },
+    ];
   }
 
   close();
 
-  await scaffoldProject(projectPath, { conn, 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

@@ -1,6 +1,5 @@
 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;
 
@@ -25,86 +24,6 @@ function prompt(query) {
   });
 }
 
-const BACKEND_VALUES = { mongodb: "mongodb", google_sheets: "google_sheets" };
-
-async function select(message, choices, valueMap) {
-  if (!isTTY) {
-    await consumeAllLines();
-    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];
-  }
-
-  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 getProjectName(args) {
   if (args[0]) return args[0];
   if (!isTTY) {
@@ -114,47 +33,36 @@ export async function getProjectName(args) {
   return (await prompt("Project name: ")).trim() || "ipl-dashboard";
 }
 
-export async function getStorageBackend() {
-  return select("Storage backend:", ["MongoDB", "Google Sheets"], BACKEND_VALUES);
-}
-
-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 };
-  }
-
-  const DEFAULT_MONGODB_URI = "mongodb+srv://admin:admin@cricket.ptjjrub.mongodb.net/?appName=cricket";
+export async function getLeagueName() {
   if (!isTTY) {
     await consumeAllLines();
-    return { backend, uri: (pipedLines[promptIndex++] || DEFAULT_MONGODB_URI || "").trim() };
+    return (pipedLines[promptIndex++] || "my_league").trim();
   }
-  const answer = (await prompt("MongoDB URI (press Enter for default): ")).trim();
-  return { backend, uri: answer || DEFAULT_MONGODB_URI || "" };
+  return (await prompt("League name (used as collection name, e.g. my_office_league): ")).trim() || "my_league";
 }
 
-export async function getLeagueUrl() {
-  if (!isTTY) {
-    await consumeAllLines();
-    return (pipedLines[promptIndex++] || "").trim();
-  }
-  return (await prompt("IPL fantasy league URL: ")).trim();
+function parseTeams(input) {
+  return input.split(",").map((part, i) => {
+    part = part.trim();
+    if (!part) return null;
+    const match = part.match(/^(.+?)\s*\(([^)]+)\)$/);
+    if (match) {
+      return { id: i + 1, name: match[1].trim(), owner: match[2].trim() };
+    }
+    return { id: i + 1, name: part, owner: part };
+  }).filter(Boolean);
 }
 
-export async function getLeagueName() {
+export async function getTeams() {
   if (!isTTY) {
     await consumeAllLines();
-    return (pipedLines[promptIndex++] || "my_league").trim();
+    const raw = (pipedLines[promptIndex++] || "").trim();
+    if (!raw) return null;
+    return parseTeams(raw);
   }
-  return (await prompt("League name (used as collection/table name, e.g. my_office_league): ")).trim() || "my_league";
+  const answer = (await prompt("Team names (comma-separated, or press Enter for defaults):\n  e.g. Team A (Alice), Team B (Bob)\n> ")).trim();
+  if (!answer) return null;
+  return parseTeams(answer);
 }
 
 export function close() {}

package/src/scaffold.mjs

@@ -10,7 +10,7 @@ const TEMPLATE_DIR = join(PACKAGE_ROOT, "template");
 
 export async function scaffoldProject(
   projectPath,
-  { conn, leagueUrl, leagueName, teams, skipInstall = false },
+  { leagueName, teams, skipInstall = false },
 ) {
   console.log(`\nCreating project at ${projectPath}...`);
 
@@ -33,15 +33,11 @@ export async function scaffoldProject(
     } catch {}
   }
 
-  await writeEnvFile(projectPath, {
-    conn,
-    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, conn.backend);
+  await updatePackageJson(projectPath);
 
   for (const f of [
     "app/api/ipl/live-snapshot.json",
@@ -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,27 +67,27 @@ export async function scaffoldProject(
   console.log("\n  Done! Your project is ready at:", projectPath);
 }
 
-async function writeEnvFile(
-  projectPath,
-  { conn, leagueUrl, leagueName },
-) {
+async function writeEnvFile(projectPath, { leagueName }) {
   const envPath = join(projectPath, ".env");
   const lines = [
-    `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 || ""}`,
+    `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`,
     `IPL_WRITE_SEED_DATA_FILE=1`,
     ``,
-  ].filter(Boolean);
+  ];
   await writeFile(envPath, lines.join("\n"));
 }
 
@@ -140,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 });
 
@@ -156,7 +147,7 @@ async function writeLeagueData(projectPath, { leagueName, leagueUrl, teams }) {
 
 export const leagueInfo: LeagueInfo = {
   name: "${leagueName || ""}",
-  leagueUrl: "${leagueUrl || ""}",
+  leagueUrl: "",
   teams: [
 ${teamEntries},
   ],
@@ -182,7 +173,7 @@ async function writeMatchPointsPlaceholder(projectPath) {
   await writeFile(join(dir, "match-points.ts"), content);
 }
 
-async function updatePackageJson(projectPath, storageBackend) {
+async function updatePackageJson(projectPath) {
   const pkgPath = join(projectPath, "package.json");
   try {
     const raw = await readFile(pkgPath, "utf8");
@@ -191,10 +182,7 @@ async function updatePackageJson(projectPath, storageBackend) {
     pkg.private = false;
     delete pkg.scripts?.["generate:template"];
     pkg.scripts["seed:league"] = "node scripts/seed-league.mjs";
-    if (storageBackend === "google_sheets" && !pkg.dependencies.googleapis) {
-      pkg.dependencies = pkg.dependencies || {};
-      pkg.dependencies.googleapis = "^140.0.0";
-    }
+    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 {}
 }