launchframe 0.2.5 → 0.3.0

package/{template/docs → docs}/research/INSPECTION_GUIDE.md

@@ -23,17 +23,19 @@ If automation hits a bot wall, **do not pretend extraction succeeded** — captu
 - [ ] **Gestures** — drag, pan, hover follow (often Framer Motion)
 - [ ] **Implementation rule** — use **`framer-motion`** for anything beyond trivial single-property CSS `transition`. Record **duration, easing, delay, stagger**, and **trigger** (scroll, hover, tap) in specs.
 
-### 3. Illustration, pixel art & brand motifs *(production landings)*
+### 3. Idea-tailored illustration & motifs *(production landings)*
 
-When the reference page is **sparse** (mostly type + gray boxes) or after a **rebrand** the UI still reads generic, treat illustration as required inventory — not optional garnish.
+When the reference page is **sparse** (mostly type + gray boxes) or after a **rebrand** the UI still reads generic, illustration is required — and it must be **unique to the SaaS idea** (`launchframe.config.json#idea`), not reusable wallpaper.
 
-- [ ] **Inline SVG** — hero shapes, dividers, card mini-scenes; note `viewBox`, whether fills use **`currentColor`**, and which CSS variables apply
-- [ ] **Pixel art / sprite accents** — intentional palette (list hex fills), grid size, scaling strategy (`imageRendering`), animation frames if any
-- [ ] **Motif thread** — recurring stroke/icon creature/grid that should echo across hero, OG sketch, favicon
-- [ ] **Accent tokens** — beyond monochrome: primary/secondary accent roles for SVG strokes, CTAs, focus (extract or **define** in `:root` for authored pages)
-- [ ] **Motion tiers A–E** — page-load stagger, scroll reveals + staggerChildren, looping ambient (marquee/caret), hover lifts, decorative parallax — document each with **reduced-motion** fallback (`prefers-reduced-motion`)
+- [ ] **Metaphor list** — 3–6 nouns/verbs derived from `idea`; every bespoke asset maps to ≥ one entry
+- [ ] **Uniqueness check** — If the scene works unchanged for another product category, revise
+- [ ] **Inline SVG** — hero shapes, dividers, card mini-scenes; note `viewBox`, **`currentColor`** vs fixed fills, **Idea tie-in** sentence per asset
+- [ ] **Pixel art / sprites** — only when character reinforces the metaphor; palette hex table; `imageRendering` / grid discipline
+- [ ] **Motif thread** — recurring element echoing hero + OG + favicon **for this product**, not a random geometric pattern
+- [ ] **Accent tokens** — primary/secondary roles aligned with idea personality (extract from reference or define in `:root`)
+- [ ] **Motion tiers A–E** — document with **reduced-motion** fallback (`prefers-reduced-motion`)
 
-See **`AGENTS.md` → Production polish for marketing landings** for tier definitions and folder conventions (`src/components/marketing/art/`).
+See **`AGENTS.md` → Production polish for marketing landings** for tier definitions and folders (`src/components/marketing/art/`, `public/images/marketing/`).
 
 ---
 
@@ -44,6 +46,7 @@ This guide outlines what to capture when inspecting a target website via Chrome
 ## Phase 1: Visual Audit
 
 ### Screenshots to Capture
+- [ ] **Single-page landing — full scroll depth** — slow-scroll until lazy sections stabilize; **`fullPage`** / stitched capture so footer and below-fold bands are included (not viewport-only hero grabs)
 - [ ] Every distinct page — desktop, tablet, mobile
 - [ ] Dark mode variants (if applicable)
 - [ ] Light mode variants (if applicable)

package/launchframe.config.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://launchframe.dev/schema/launchframe.config.json",
+  "url": "https://vercel.com/",
+  "idea": "saas-idea",
+  "createdAt": "2026-05-15T00:27:49.833Z",
+  "launchframeVersion": "0.2.6",
+  "notes": [
+    "The /clone-website skill reads this file at the start of every run.",
+    "After scaffold: open this folder in Cursor (or your AI editor) and say **Build it** — same workflow.",
+    "`url` is the visual source-of-truth (clone its layout, spacing, tokens, motion).",
+    "`idea` is the rebranding directive applied AFTER the pixel-perfect clone.",
+    "Edit either field and re-invoke the skill to re-run."
+  ]
+}

package/package.json

@@ -1,52 +1,54 @@
-{
-  "name": "launchframe",
-  "version": "0.2.5",
-  "description": "Scaffold a SaaS-ready Next.js codebase from any URL. Point launchframe at a website you admire and describe the SaaS you want to build — it drops in the AI-cloner template wired with your URL and idea so your AI agent (Claude Code, Cursor, Codex, etc.) can run /clone-website and produce a pixel-perfect, re-skinned starting point.",
-  "license": "MIT",
-  "author": "Evan Gruhlkey",
-  "homepage": "https://github.com/evangruhlkey/launchframe#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/evangruhlkey/launchframe.git"
-  },
-  "bugs": {
-    "url": "https://github.com/evangruhlkey/launchframe/issues"
-  },
-  "keywords": [
-    "launchframe",
-    "scaffold",
-    "ai",
-    "ai-agents",
-    "website-clone",
-    "reverse-engineering",
-    "saas",
-    "boilerplate",
-    "template",
-    "nextjs",
-    "shadcn",
-    "shadcn-ui",
-    "tailwindcss",
-    "claude-code",
-    "cursor",
-    "codex",
-    "cli"
-  ],
-  "bin": {
-    "launchframe": "bin/launchframe.mjs"
-  },
-  "files": [
-    "bin",
-    "template",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "test:scaffold": "node bin/launchframe.mjs https://linear.app \"AI feedback platform\" --dir tmp-scaffold --force --skip-install",
-    "sync:skill": "node template/scripts/sync-skills.mjs",
-    "sync:agents": "bash template/scripts/sync-agent-rules.sh"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "type": "module"
-}
+{
+  "name": "launchframe",
+  "version": "0.3.0",
+  "private": false,
+  "description": "clone any website into a clean, modern Next.js codebase using AI coding agents",
+  "license": "MIT",
+  "keywords": [
+    "claude-code",
+    "website-clone",
+    "reverse-engineering",
+    "nextjs",
+    "ai",
+    "template",
+    "tailwindcss",
+    "shadcn-ui"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint",
+    "typecheck": "tsc --noEmit",
+    "check": "npm run lint && npm run typecheck && npm run build",
+    "recon": "node scripts/recon-playwright.mjs",
+    "recon:headed": "node scripts/recon-playwright.mjs --headed"
+  },
+  "dependencies": {
+    "@base-ui/react": "^1.3.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "framer-motion": "^12.4.0",
+    "lucide-react": "^1.6.0",
+    "next": "16.2.1",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "shadcn": "^4.1.0",
+    "tailwind-merge": "^3.5.0",
+    "tw-animate-css": "^1.4.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^24",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.2.1",
+    "playwright": "^1.49.1",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}

package/{template/scripts → scripts}/recon-playwright.mjs

@@ -4,7 +4,7 @@
  *
  * Reads URL from launchframe.config.json (or --url). Writes:
  *   - docs/design-references/playwright-<host>-<w>px.png (full page)
- *   - docs/research/computed-snapshot.json (styles + asset inventory + bot-wall hint)
+ *   - docs/research/computed-snapshot.json (styles + merged asset inventory + bot-wall hint)
  *   - docs/research/MEDIA_MANIFEST.md (table of discovered media URLs)
  *
  * Usage:
@@ -52,27 +52,91 @@ function safeHost(url) {
   }
 }
 
-/** Scroll to bottom slowly to trigger lazy-loaded media */
+/**
+ * Scroll the full document depth slowly so lazy-loaded media and below-fold DOM resolve.
+ * Repeats until scrollHeight stabilizes (handles incremental infinite layouts up to max rounds).
+ */
 async function scrollFullPage(page) {
   await page.evaluate(async () => {
     const delay = (ms) => new Promise((r) => setTimeout(r, ms));
-    const step = Math.max(1, Math.floor(window.innerHeight * 0.85));
-    let y = 0;
-    const max = document.documentElement.scrollHeight;
-    while (y < max) {
-      y = Math.min(y + step, max);
-      window.scrollTo(0, y);
-      await delay(200);
+    const stepSize = () => Math.max(1, Math.floor(window.innerHeight * 0.85));
+
+    let unchangedStreak = 0;
+    let prevTotal = -1;
+
+    for (let round = 0; round < 12; round++) {
+      let y = 0;
+      let limit = document.documentElement.scrollHeight;
+
+      while (y < limit) {
+        y = Math.min(y + stepSize(), limit);
+        window.scrollTo(0, y);
+        await delay(130);
+        limit = document.documentElement.scrollHeight;
+      }
+
+      window.scrollTo(0, document.documentElement.scrollHeight);
+      await delay(420);
+
+      const h = document.documentElement.scrollHeight;
+
+      window.scrollTo(0, 0);
+      await delay(220);
+
+      if (h === prevTotal) unchangedStreak++;
+      else unchangedStreak = 0;
+      prevTotal = h;
+
+      if (unchangedStreak >= 2) break;
     }
-    window.scrollTo(0, 0);
-    await delay(300);
   });
 }
 
+function mergeAssetInventory(base, extra) {
+  if (!extra) return base;
+  const imgKey = (i) => i.src || "";
+  const seenImg = new Set(base.images.map(imgKey));
+  const images = [...base.images];
+  for (const i of extra.images) {
+    const k = imgKey(i);
+    if (k && !seenImg.has(k)) {
+      seenImg.add(k);
+      images.push(i);
+    }
+  }
+
+  const vidKey = (v) => `${v.src || ""}|${v.poster || ""}`;
+  const seenVid = new Set(base.videos.map(vidKey));
+  const videos = [...base.videos];
+  for (const v of extra.videos) {
+    const k = vidKey(v);
+    if ((v.src || v.poster) && !seenVid.has(k)) {
+      seenVid.add(k);
+      videos.push(v);
+    }
+  }
+
+  const seenBg = new Set(base.backgroundImages.map((b) => b.url));
+  const backgroundImages = [...base.backgroundImages];
+  for (const b of extra.backgroundImages) {
+    if (b.url && !seenBg.has(b.url)) {
+      seenBg.add(b.url);
+      backgroundImages.push(b);
+    }
+  }
+
+  return {
+    images,
+    videos,
+    backgroundImages,
+    svgCount: Math.max(base.svgCount ?? 0, extra.svgCount ?? 0),
+  };
+}
+
 async function gatherPageData(page) {
   return page.evaluate(() => {
     const title = document.title || "";
-    const text = (document.body?.innerText || "").slice(0, 5000);
+    const text = (document.body?.innerText || "").slice(0, 80000);
     const likelyBotWall =
       /just a moment/i.test(title) ||
       /checking your browser/i.test(text) ||
@@ -145,7 +209,7 @@ async function gatherPageData(page) {
     return {
       title,
       likelyBotWall,
-      textSample: text.slice(0, 1200),
+      textSample: text.slice(0, 24000),
       assetInventory: {
         images: imgs.filter((i) => i.src),
         videos,
@@ -272,23 +336,32 @@ async function main() {
     await new Promise((r) => setTimeout(r, 2500));
     snapshot.finalUrl = page.url();
 
+    let mergedInventory = null;
+    let desktopLandmarks = null;
+
     for (const w of [1440, 390]) {
       await page.setViewportSize({ width: w, height: w === 1440 ? 900 : 844 });
-      if (w === 1440) await scrollFullPage(page);
+      await scrollFullPage(page);
 
       const shotPath = join(ROOT, "docs", "design-references", `playwright-${host}-${w}px.png`);
       await page.screenshot({ path: shotPath, fullPage: true });
       snapshot.viewports[w] = { screenshot: `docs/design-references/playwright-${host}-${w}px.png` };
 
+      const data = await gatherPageData(page);
+
       if (w === 1440) {
-        const data = await gatherPageData(page);
         snapshot.title = data.title;
         snapshot.likelyBotWall = data.likelyBotWall;
-        snapshot.assetInventory = data.assetInventory;
-        snapshot.computedLandmarks = data.computedLandmarks;
+        mergedInventory = data.assetInventory;
+        desktopLandmarks = data.computedLandmarks;
         snapshot.textSample = data.textSample;
+      } else {
+        mergedInventory = mergeAssetInventory(mergedInventory, data.assetInventory);
       }
     }
+
+    snapshot.assetInventory = mergedInventory;
+    snapshot.computedLandmarks = desktopLandmarks;
   } finally {
     await browser.close();
   }

package/src/components/marketing/scribewise-landing.tsx

@@ -0,0 +1,34 @@
+import Link from "next/link";
+
+import { Button } from "@/components/ui/button";
+
+export function ScribewiseLanding() {
+  return (
+    <main className="relative flex flex-1 flex-col items-center justify-center gap-8 overflow-hidden px-6 py-24 text-center">
+      <div
+        aria-hidden
+        className="pointer-events-none absolute inset-0 -z-10 bg-[radial-gradient(ellipse_80%_50%_at_50%_-20%,color-mix(in_oklab,var(--primary)_28%,transparent),transparent)]"
+      />
+      <p className="text-muted-foreground text-xs font-medium tracking-[0.2em] uppercase">
+        Launchframe template
+      </p>
+      <div className="max-w-2xl space-y-4">
+        <h1 className="text-balance font-semibold text-4xl tracking-tight sm:text-5xl">
+          Ready for `/clone-website`
+        </h1>
+        <p className="text-muted-foreground text-balance text-lg">
+          Add your target URL and SaaS idea via <code className="text-foreground">launchframe.config.json</code>,
+          run recon if needed, then let your agent ship the full landing.
+        </p>
+      </div>
+      <div className="flex flex-wrap items-center justify-center gap-3">
+        <Button nativeButton={false} render={<Link href="https://github.com/evangruhlkey/launchframe" />}>
+          Launchframe docs
+        </Button>
+        <Button variant="outline" nativeButton={false} render={<Link href="/" />}>
+          Replace this page
+        </Button>
+      </div>
+    </main>
+  );
+}

package/bin/launchframe.mjs

@@ -1,315 +0,0 @@
-#!/usr/bin/env node
-// @ts-check
-/**
- * launchframe — scaffold an AI-cloner project pointed at any URL + SaaS idea.
- *
- * Usage:
- *   npx launchframe@latest <url> "<saas idea>" [--dir <path>] [--force] [--skip-install]
- *
- * Behavior:
- *   1. Validates the URL and SaaS-idea string.
- *   2. Copies the bundled `template/` payload into the project root (current
- *      directory by default) so dotfolders like `.cursor` and `.claude` live at
- *      the workspace root when you open that folder in your editor. Use
- *      `--dir <name>` for a subdirectory if you prefer.
- *   3. Writes `launchframe.config.json` into the new project so the bundled
- *      `/clone-website` skill knows which URL to clone and how to re-skin it
- *      for your SaaS idea.
- *   4. Runs `npm install` in the new project (so the user does not have to).
- *   5. Prints one line: open the folder in Cursor and tell the AI **Build it**.
- */
-
-import { spawnSync } from "node:child_process";
-import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
-import { createRequire } from "node:module";
-import { dirname, basename, isAbsolute, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const pkgRoot = resolve(__dirname, "..");
-const templateDir = join(pkgRoot, "template");
-const require = createRequire(import.meta.url);
-const pkgJson = require(join(pkgRoot, "package.json"));
-
-const COLORS = {
-  reset: "\x1b[0m",
-  bold: "\x1b[1m",
-  dim: "\x1b[2m",
-  red: "\x1b[31m",
-  green: "\x1b[32m",
-  yellow: "\x1b[33m",
-  cyan: "\x1b[36m",
-};
-const supportsColor = process.stdout.isTTY && !process.env.NO_COLOR;
-const c = (color, s) => (supportsColor ? COLORS[color] + s + COLORS.reset : s);
-
-function printHelp() {
-  console.log(`
-${c("bold", "launchframe")} ${c("dim", `v${pkgJson.version}`)}
-Scaffold an AI-cloner project pointed at any URL + SaaS idea.
-
-${c("bold", "Usage:")}
-  npx launchframe@latest <url> "<saas idea>" [options]
-
-${c("bold", "Arguments:")}
-  <url>          URL of the site you want to clone (e.g. https://linear.app)
-  <saas idea>    One-line description of the SaaS you're building
-                 (used to re-skin copy/branding after the visual clone)
-
-${c("bold", "Options:")}
-  --dir <path>   Output folder (default: .  — current directory / project root)
-  --force        Overwrite merging files into a non-empty directory (use with care)
-  --skip-install Skip npm install after scaffold (faster for CI / debugging)
-  --help, -h     Show this message
-  --version, -v  Show the launchframe version
-
-${c("bold", "Example:")}
-  npx launchframe@latest https://linear.app "AI-powered customer feedback platform"
-  # From an empty folder (or git init only), files land in .  so .cursor/ works at workspace root
-  npx launchframe@latest https://vercel.com "DevOps for ML" --dir launchframe-app
-  npx launchframe@latest https://stripe.com "Billing for AI agents" --skip-install
-`);
-}
-
-function exitErr(msg, code = 1) {
-  console.error(c("red", `\nlaunchframe: ${msg}`));
-  console.error(c("dim", "Run `npx launchframe --help` for usage.\n"));
-  process.exit(code);
-}
-
-function parseArgs(argv) {
-  const positional = [];
-  const opts = {
-    dir: ".",
-    force: false,
-    skipInstall: false,
-    help: false,
-    version: false,
-  };
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === "--help" || a === "-h") opts.help = true;
-    else if (a === "--version" || a === "-v") opts.version = true;
-    else if (a === "--force" || a === "-f") opts.force = true;
-    else if (a === "--skip-install") opts.skipInstall = true;
-    else if (a === "--dir" || a === "-d") {
-      const next = argv[++i];
-      if (!next || next.startsWith("-")) exitErr("`--dir` requires a value");
-      opts.dir = next;
-    } else if (a.startsWith("--dir=")) {
-      opts.dir = a.slice("--dir=".length);
-    } else if (a.startsWith("-")) {
-      exitErr(`unknown option: ${a}`);
-    } else {
-      positional.push(a);
-    }
-  }
-  return { positional, opts };
-}
-
-function normalizeUrl(raw) {
-  let candidate = raw.trim();
-  if (!/^https?:\/\//i.test(candidate)) candidate = `https://${candidate}`;
-  try {
-    const u = new URL(candidate);
-    if (!u.hostname || !u.hostname.includes(".")) throw new Error("missing hostname");
-    return u.toString();
-  } catch {
-    exitErr(`invalid URL: ${raw}`);
-  }
-}
-
-function isDirEmpty(dir) {
-  try {
-    return readdirSync(dir).length === 0;
-  } catch {
-    return true;
-  }
-}
-
-/** True if the folder is empty or only has git/bootstrap noise (so we can scaffold at project root). */
-function isScaffoldRootUsable(dir) {
-  let names;
-  try {
-    names = readdirSync(dir);
-  } catch {
-    return true;
-  }
-  if (names.length === 0) return true;
-  const allowedOnly = new Set([".git", ".gitignore", ".gitattributes"]);
-  return names.every((n) => allowedOnly.has(n));
-}
-
-function npmPackageSlug(dirName, targetDir) {
-  const raw =
-    dirName === "." || dirName === "./"
-      ? basename(targetDir) || "launchframe-app"
-      : dirName;
-  const slug = raw
-    .toLowerCase()
-    .replace(/[^a-z0-9-_]/g, "-")
-    .replace(/-+/g, "-")
-    .replace(/^-|-$/g, "")
-    .slice(0, 64);
-  return slug || "launchframe-app";
-}
-
-function rewritePackageJson(targetDir, packageSlug, url, idea) {
-  const pkgPath = join(targetDir, "package.json");
-  if (!existsSync(pkgPath)) return;
-  let pkg;
-  try {
-    pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-  } catch {
-    return;
-  }
-  pkg.name = packageSlug;
-  pkg.version = "0.1.0";
-  pkg.private = true;
-  pkg.description = `Launchframe project — clone of ${url} reframed as: ${idea}`;
-  delete pkg.author;
-  delete pkg.homepage;
-  delete pkg.repository;
-  delete pkg.bugs;
-  writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
-}
-
-function writeLaunchframeConfig(targetDir, url, idea) {
-  const cfg = {
-    $schema: "https://launchframe.dev/schema/launchframe.config.json",
-    url,
-    idea,
-    createdAt: new Date().toISOString(),
-    launchframeVersion: pkgJson.version,
-    notes: [
-      "The /clone-website skill reads this file at the start of every run.",
-      "After scaffold: open this folder in Cursor (or your AI editor) and say **Build it** — same workflow.",
-      "`url` is the visual source-of-truth (clone its layout, spacing, tokens, motion).",
-      "`idea` is the rebranding directive applied AFTER the pixel-perfect clone.",
-      "Edit either field and re-invoke the skill to re-run.",
-    ],
-  };
-  writeFileSync(
-    join(targetDir, "launchframe.config.json"),
-    JSON.stringify(cfg, null, 2) + "\n",
-    "utf8"
-  );
-}
-
-function runNpmInstall(targetDir) {
-  console.log(c("dim", "\nRunning npm install (this may take a minute)...\n"));
-  const result = spawnSync("npm", ["install", "--no-fund", "--no-audit"], {
-    cwd: targetDir,
-    stdio: "inherit",
-    shell: true,
-    env: process.env,
-  });
-  if (result.status !== 0) {
-    console.error(
-      c("yellow", "\nlaunchframe: npm install exited with an error. ") +
-        c("dim", `Fix the issue and run \`npm install\` inside the project folder, or re-run with \`--force\`.\n`)
-    );
-    process.exit(result.status === null ? 1 : result.status);
-  }
-  console.log(c("green", "\n\u2713 npm install finished.\n"));
-}
-
-function nextSteps(projectDir, dirLabel, openHint, url, idea) {
-  console.log(`
-${c("green", "\u2713")} Done — ${c("bold", dirLabel)} is ready.
-
-  ${c("dim", "Target URL:")}  ${c("cyan", url)}
-  ${c("dim", "SaaS idea:")}   ${c("cyan", idea)}
-  ${c("dim", "Folder:")}      ${projectDir}
-
-${c("bold", "All you do next:")}
-  1. Open ${c("cyan", openHint)} in ${c("bold", "Cursor")} ${c("dim", "(File \u2192 Open Folder)")}
-  2. In chat, say: ${c("bold", "Build it")}
-     ${c("dim", "Your AI reads launchframe.config.json + AGENTS.md and runs the full clone + rebrand workflow.")}
-     ${c("dim", "You can also type ") + c("cyan", "/clone-website") + c("dim", " if you prefer.")}
-
-${c("dim", "Dotfolders (.cursor, .claude, …) are at this project root so rules and skills apply when you open this folder.")}
-${c("dim", "Other editors: same folder — say Build it, or run the /clone-website skill for your tool.")}
-${c("dim", "Edit launchframe.config.json anytime to change URL or SaaS idea.")}
-`);
-}
-
-function main() {
-  const { positional, opts } = parseArgs(process.argv.slice(2));
-  if (opts.help) return printHelp();
-  if (opts.version) return console.log(pkgJson.version);
-
-  if (positional.length < 2) {
-    if (positional.length === 0) {
-      console.error(c("red", "\nlaunchframe: missing <url> and <saas idea>"));
-    } else {
-      console.error(c("red", '\nlaunchframe: missing <saas idea> (wrap it in quotes: "...")'));
-    }
-    printHelp();
-    process.exit(1);
-  }
-  if (positional.length > 2) {
-    exitErr(
-      `too many positional arguments. Wrap your SaaS idea in quotes: ` +
-        `\`npx launchframe ${positional[0]} "${positional.slice(1).join(" ")}"\``
-    );
-  }
-
-  const url = normalizeUrl(positional[0]);
-  const idea = positional[1].trim();
-  if (!idea) exitErr("SaaS idea cannot be empty");
-
-  const dirNameRaw = opts.dir;
-  const targetDir = isAbsolute(dirNameRaw) ? dirNameRaw : resolve(process.cwd(), dirNameRaw);
-
-  const isRootDot = dirNameRaw === "." || dirNameRaw === "./";
-  const usable = isDirEmpty(targetDir) || isScaffoldRootUsable(targetDir);
-  if (existsSync(targetDir) && !usable && !opts.force) {
-    exitErr(
-      `target directory \`${dirNameRaw}\` is not empty.\n` +
-        `Create an empty folder (or \`git init\` only), run again from there, or pass \`--force\` to merge files, ` +
-        `or use \`--dir launchframe-app\` to scaffold into a subdirectory.`
-    );
-  }
-
-  if (!existsSync(templateDir)) {
-    exitErr(
-      `bundled template not found at \`${templateDir}\`.\n` +
-        `This usually means the launchframe package was installed incompletely. ` +
-        `Try: \`npm install -g launchframe@latest\` or re-run \`npx launchframe@latest ...\`.`
-    );
-  }
-
-  mkdirSync(targetDir, { recursive: true });
-
-  console.log(c("dim", `\nCopying template \u2192 ${targetDir} ...`));
-  cpSync(templateDir, targetDir, {
-    recursive: true,
-    force: opts.force,
-    filter: (src) => {
-      const lower = src.toLowerCase();
-      if (lower.endsWith(`${"\\"}node_modules`) || lower.endsWith("/node_modules")) return false;
-      if (lower.endsWith(`${"\\"}.next`) || lower.endsWith("/.next")) return false;
-      if (lower.endsWith("package-lock.json")) return false;
-      return true;
-    },
-  });
-
-  const packageSlug = npmPackageSlug(dirNameRaw, targetDir);
-  rewritePackageJson(targetDir, packageSlug, url, idea);
-  writeLaunchframeConfig(targetDir, url, idea);
-
-  if (!opts.skipInstall) runNpmInstall(targetDir);
-
-  const dirLabel = isRootDot ? "this folder (project root)" : dirNameRaw;
-  const openHint = isRootDot ? "this folder" : `./${dirNameRaw}`;
-  nextSteps(targetDir, dirLabel, openHint, url, idea);
-}
-
-try {
-  main();
-} catch (err) {
-  console.error(c("red", `\nlaunchframe: ${err?.message || err}\n`));
-  process.exit(1);
-}