launchframe 0.4.12 → 0.4.13

package/.amazonq/cli-agents/snapshot.json

@@ -0,0 +1,9 @@
+{
+  "name": "snapshot",
+  "description": "Verbatim page snapshot — run inspect:page, copy document.html to public/captured/, and show it on the home route via a full-viewport iframe (not a React rebuild).",
+  "prompt": "\n# Snapshot (`/snapshot`)\n\n**`/snapshot`** serves a **frozen copy** of a live URL: the captured **`document.html`** from Playwright lives under **`public/captured/`** and **`src/app/page.tsx`** embeds it in a **full-viewport iframe**. This is **verbatim hosting**, not **`/launchframe`** (no component rebuild, no SaaS overlay, no Phase 6 verification).\n\nParse **the reference URL the user passed with /snapshot**:\n\n1. **URL** — Exactly one `http://` or `https://` URL. If the user omitted it, ask once. If multiple URLs appear, use the **first** only and say you are snapshotting that one.\n\n## Step 1 — Persist the source URL\n\nUpdate **`src/lib/launchframe-config.ts`**:\n\n- Set **`LAUNCHFRAME_SOURCE_URL`** to the parsed URL (string, `as const`).\n\n## Step 2 — Capture (mandatory)\n\nFrom the repository root, run **once** for that URL (same inspector as Launchframe Step 0a). Use the URL’s **hostname** for the output parent (example: `https://www.example.com/path` → `www.example.com`):\n\n1. **One-time per machine:** `npx playwright install chromium` if captures fail for missing browsers.\n2. **Capture:**\n\n```bash\nnpm run inspect:page -- \"<URL>\" --scroll-full --wait-until networkidle --timeout 120000 --out-parent \"docs/research/<hostname>/page-inspection\"\n```\n\nThis creates `docs/research/<hostname>/page-inspection/<hostname>-<iso-stamp>/` with **`document.html`** and related artifacts.\n\nIf navigation times out, retry with `--wait-until domcontentloaded` or a higher `--timeout`, and record what worked.\n\n## Step 3 — Verbatim copy to `public`\n\n1. Ensure **`public/captured/`** exists.\n2. Pick the **latest** inspection folder under that hostname (sort by the ISO stamp in the folder name).\n3. **Copy** (do not prettify or edit) **`document.html`** from that folder to:\n\n   **`public/captured/<host-slug>-document.html`**\n\n   where **`<host-slug>`** is the URL hostname with each **`.`** replaced by **`-`** (e.g. `www.example.com` → `www-example-com`).\n\nSame-origin scripts and inline styles stay inside the file; external URLs (CDNs) remain as in the capture.\n\n## Step 4 — Home page iframe\n\nReplace **`src/app/page.tsx`** with a single full-viewport iframe **only** (no `sandbox` — it breaks many real pages):\n\n```tsx\nexport default function Home() {\n  return (\n    <iframe\n      src=\"/captured/<host-slug>-document.html\"\n      title=\"Captured snapshot\"\n      className=\"fixed inset-0 h-dvh w-dvw border-0\"\n    />\n  );\n}\n```\n\nUse the same **`<host-slug>`** as in Step 3.\n\n## Step 5 — Verify\n\nRun **`npm run build`** and fix any errors.\n\n## What to tell the user\n\nAfter **`npm run dev`**:\n\n- **Iframe:** `http://localhost:3000/`\n- **Direct static file:** `http://localhost:3000/captured/<host-slug>-document.html`\n\n## What not to do\n\n- Do **not** treat this as **`/launchframe`** (no parallel component specs, no `docs/research/LAUNCHFRAME_SUBAGENTS.md` runs for snapshot).\n- Do **not** hand-rebuild the page in React for this command.\n- Do **not** add `sandbox` on the iframe unless the user explicitly asks and accepts broken script behavior.\n",
+  "fileContext": [
+    "AGENTS.md",
+    "docs/research/**"
+  ]
+}

package/.augment/commands/snapshot.md

@@ -0,0 +1,83 @@
+---
+description: "Verbatim page snapshot — run inspect:page, copy document.html to public/captured/, and show it on the home route via a full-viewport iframe (not a React rebuild)."
+argument-hint: "<url>"
+---
+<!-- AUTO-GENERATED from .claude/skills/snapshot/SKILL.md — do not edit directly.
+     Run `node scripts/sync-skills.mjs` to regenerate. -->
+
+
+# Snapshot (`/snapshot`)
+
+**`/snapshot`** serves a **frozen copy** of a live URL: the captured **`document.html`** from Playwright lives under **`public/captured/`** and **`src/app/page.tsx`** embeds it in a **full-viewport iframe**. This is **verbatim hosting**, not **`/launchframe`** (no component rebuild, no SaaS overlay, no Phase 6 verification).
+
+Parse **$ARGUMENTS**:
+
+1. **URL** — Exactly one `http://` or `https://` URL. If the user omitted it, ask once. If multiple URLs appear, use the **first** only and say you are snapshotting that one.
+
+## Step 1 — Persist the source URL
+
+Update **`src/lib/launchframe-config.ts`**:
+
+- Set **`LAUNCHFRAME_SOURCE_URL`** to the parsed URL (string, `as const`).
+
+## Step 2 — Capture (mandatory)
+
+From the repository root, run **once** for that URL (same inspector as Launchframe Step 0a). Use the URL’s **hostname** for the output parent (example: `https://www.example.com/path` → `www.example.com`):
+
+1. **One-time per machine:** `npx playwright install chromium` if captures fail for missing browsers.
+2. **Capture:**
+
+```bash
+npm run inspect:page -- "<URL>" --scroll-full --wait-until networkidle --timeout 120000 --out-parent "docs/research/<hostname>/page-inspection"
+```
+
+This creates `docs/research/<hostname>/page-inspection/<hostname>-<iso-stamp>/` with **`document.html`** and related artifacts.
+
+If navigation times out, retry with `--wait-until domcontentloaded` or a higher `--timeout`, and record what worked.
+
+## Step 3 — Verbatim copy to `public`
+
+1. Ensure **`public/captured/`** exists.
+2. Pick the **latest** inspection folder under that hostname (sort by the ISO stamp in the folder name).
+3. **Copy** (do not prettify or edit) **`document.html`** from that folder to:
+
+   **`public/captured/<host-slug>-document.html`**
+
+   where **`<host-slug>`** is the URL hostname with each **`.`** replaced by **`-`** (e.g. `www.example.com` → `www-example-com`).
+
+Same-origin scripts and inline styles stay inside the file; external URLs (CDNs) remain as in the capture.
+
+## Step 4 — Home page iframe
+
+Replace **`src/app/page.tsx`** with a single full-viewport iframe **only** (no `sandbox` — it breaks many real pages):
+
+```tsx
+export default function Home() {
+  return (
+    <iframe
+      src="/captured/<host-slug>-document.html"
+      title="Captured snapshot"
+      className="fixed inset-0 h-dvh w-dvw border-0"
+    />
+  );
+}
+```
+
+Use the same **`<host-slug>`** as in Step 3.
+
+## Step 5 — Verify
+
+Run **`npm run build`** and fix any errors.
+
+## What to tell the user
+
+After **`npm run dev`**:
+
+- **Iframe:** `http://localhost:3000/`
+- **Direct static file:** `http://localhost:3000/captured/<host-slug>-document.html`
+
+## What not to do
+
+- Do **not** treat this as **`/launchframe`** (no parallel component specs, no `docs/research/LAUNCHFRAME_SUBAGENTS.md` runs for snapshot).
+- Do **not** hand-rebuild the page in React for this command.
+- Do **not** add `sandbox` on the iframe unless the user explicitly asks and accepts broken script behavior.

package/.claude/skills/snapshot/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: snapshot
+description: Verbatim page snapshot — run inspect:page, copy document.html to public/captured/, and show it on the home route via a full-viewport iframe (not a React rebuild).
+argument-hint: "<url>"
+argument-substitution: the reference URL the user passed with /snapshot
+user-invocable: true
+---
+
+# Snapshot (`/snapshot`)
+
+**`/snapshot`** serves a **frozen copy** of a live URL: the captured **`document.html`** from Playwright lives under **`public/captured/`** and **`src/app/page.tsx`** embeds it in a **full-viewport iframe**. This is **verbatim hosting**, not **`/launchframe`** (no component rebuild, no SaaS overlay, no Phase 6 verification).
+
+Parse **$ARGUMENTS**:
+
+1. **URL** — Exactly one `http://` or `https://` URL. If the user omitted it, ask once. If multiple URLs appear, use the **first** only and say you are snapshotting that one.
+
+## Step 1 — Persist the source URL
+
+Update **`src/lib/launchframe-config.ts`**:
+
+- Set **`LAUNCHFRAME_SOURCE_URL`** to the parsed URL (string, `as const`).
+
+## Step 2 — Capture (mandatory)
+
+From the repository root, run **once** for that URL (same inspector as Launchframe Step 0a). Use the URL’s **hostname** for the output parent (example: `https://www.example.com/path` → `www.example.com`):
+
+1. **One-time per machine:** `npx playwright install chromium` if captures fail for missing browsers.
+2. **Capture:**
+
+```bash
+npm run inspect:page -- "<URL>" --scroll-full --wait-until networkidle --timeout 120000 --out-parent "docs/research/<hostname>/page-inspection"
+```
+
+This creates `docs/research/<hostname>/page-inspection/<hostname>-<iso-stamp>/` with **`document.html`** and related artifacts.
+
+If navigation times out, retry with `--wait-until domcontentloaded` or a higher `--timeout`, and record what worked.
+
+## Step 3 — Verbatim copy to `public`
+
+1. Ensure **`public/captured/`** exists.
+2. Pick the **latest** inspection folder under that hostname (sort by the ISO stamp in the folder name).
+3. **Copy** (do not prettify or edit) **`document.html`** from that folder to:
+
+   **`public/captured/<host-slug>-document.html`**
+
+   where **`<host-slug>`** is the URL hostname with each **`.`** replaced by **`-`** (e.g. `www.example.com` → `www-example-com`).
+
+Same-origin scripts and inline styles stay inside the file; external URLs (CDNs) remain as in the capture.
+
+## Step 4 — Home page iframe
+
+Replace **`src/app/page.tsx`** with a single full-viewport iframe **only** (no `sandbox` — it breaks many real pages):
+
+```tsx
+export default function Home() {
+  return (
+    <iframe
+      src="/captured/<host-slug>-document.html"
+      title="Captured snapshot"
+      className="fixed inset-0 h-dvh w-dvw border-0"
+    />
+  );
+}
+```
+
+Use the same **`<host-slug>`** as in Step 3.
+
+## Step 5 — Verify
+
+Run **`npm run build`** and fix any errors.
+
+## What to tell the user
+
+After **`npm run dev`**:
+
+- **Iframe:** `http://localhost:3000/`
+- **Direct static file:** `http://localhost:3000/captured/<host-slug>-document.html`
+
+## What not to do
+
+- Do **not** treat this as **`/launchframe`** (no parallel component specs, no `docs/research/LAUNCHFRAME_SUBAGENTS.md` runs for snapshot).
+- Do **not** hand-rebuild the page in React for this command.
+- Do **not** add `sandbox` on the iframe unless the user explicitly asks and accepts broken script behavior.

package/.codex/skills/snapshot/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: snapshot
+description: Verbatim page snapshot — run inspect:page, copy document.html to public/captured/, and show it on the home route via a full-viewport iframe (not a React rebuild).
+argument-hint: "<url>"
+argument-substitution: the reference URL the user passed with /snapshot
+user-invocable: true
+---
+
+# Snapshot (`/snapshot`)
+
+**`/snapshot`** serves a **frozen copy** of a live URL: the captured **`document.html`** from Playwright lives under **`public/captured/`** and **`src/app/page.tsx`** embeds it in a **full-viewport iframe**. This is **verbatim hosting**, not **`/launchframe`** (no component rebuild, no SaaS overlay, no Phase 6 verification).
+
+Parse **$ARGUMENTS**:
+
+1. **URL** — Exactly one `http://` or `https://` URL. If the user omitted it, ask once. If multiple URLs appear, use the **first** only and say you are snapshotting that one.
+
+## Step 1 — Persist the source URL
+
+Update **`src/lib/launchframe-config.ts`**:
+
+- Set **`LAUNCHFRAME_SOURCE_URL`** to the parsed URL (string, `as const`).
+
+## Step 2 — Capture (mandatory)
+
+From the repository root, run **once** for that URL (same inspector as Launchframe Step 0a). Use the URL’s **hostname** for the output parent (example: `https://www.example.com/path` → `www.example.com`):
+
+1. **One-time per machine:** `npx playwright install chromium` if captures fail for missing browsers.
+2. **Capture:**
+
+```bash
+npm run inspect:page -- "<URL>" --scroll-full --wait-until networkidle --timeout 120000 --out-parent "docs/research/<hostname>/page-inspection"
+```
+
+This creates `docs/research/<hostname>/page-inspection/<hostname>-<iso-stamp>/` with **`document.html`** and related artifacts.
+
+If navigation times out, retry with `--wait-until domcontentloaded` or a higher `--timeout`, and record what worked.
+
+## Step 3 — Verbatim copy to `public`
+
+1. Ensure **`public/captured/`** exists.
+2. Pick the **latest** inspection folder under that hostname (sort by the ISO stamp in the folder name).
+3. **Copy** (do not prettify or edit) **`document.html`** from that folder to:
+
+   **`public/captured/<host-slug>-document.html`**
+
+   where **`<host-slug>`** is the URL hostname with each **`.`** replaced by **`-`** (e.g. `www.example.com` → `www-example-com`).
+
+Same-origin scripts and inline styles stay inside the file; external URLs (CDNs) remain as in the capture.
+
+## Step 4 — Home page iframe
+
+Replace **`src/app/page.tsx`** with a single full-viewport iframe **only** (no `sandbox` — it breaks many real pages):
+
+```tsx
+export default function Home() {
+  return (
+    <iframe
+      src="/captured/<host-slug>-document.html"
+      title="Captured snapshot"
+      className="fixed inset-0 h-dvh w-dvw border-0"
+    />
+  );
+}
+```
+
+Use the same **`<host-slug>`** as in Step 3.
+
+## Step 5 — Verify
+
+Run **`npm run build`** and fix any errors.
+
+## What to tell the user
+
+After **`npm run dev`**:
+
+- **Iframe:** `http://localhost:3000/`
+- **Direct static file:** `http://localhost:3000/captured/<host-slug>-document.html`
+
+## What not to do
+
+- Do **not** treat this as **`/launchframe`** (no parallel component specs, no `docs/research/LAUNCHFRAME_SUBAGENTS.md` runs for snapshot).
+- Do **not** hand-rebuild the page in React for this command.
+- Do **not** add `sandbox` on the iframe unless the user explicitly asks and accepts broken script behavior.

package/.continue/commands/snapshot.md

@@ -0,0 +1,84 @@
+---
+name: snapshot
+description: "Verbatim page snapshot — run inspect:page, copy document.html to public/captured/, and show it on the home route via a full-viewport iframe (not a React rebuild)."
+invokable: true
+---
+<!-- AUTO-GENERATED from .claude/skills/snapshot/SKILL.md — do not edit directly.
+     Run `node scripts/sync-skills.mjs` to regenerate. -->
+
+
+# Snapshot (`/snapshot`)
+
+**`/snapshot`** serves a **frozen copy** of a live URL: the captured **`document.html`** from Playwright lives under **`public/captured/`** and **`src/app/page.tsx`** embeds it in a **full-viewport iframe**. This is **verbatim hosting**, not **`/launchframe`** (no component rebuild, no SaaS overlay, no Phase 6 verification).
+
+Parse **$ARGUMENTS**:
+
+1. **URL** — Exactly one `http://` or `https://` URL. If the user omitted it, ask once. If multiple URLs appear, use the **first** only and say you are snapshotting that one.
+
+## Step 1 — Persist the source URL
+
+Update **`src/lib/launchframe-config.ts`**:
+
+- Set **`LAUNCHFRAME_SOURCE_URL`** to the parsed URL (string, `as const`).
+
+## Step 2 — Capture (mandatory)
+
+From the repository root, run **once** for that URL (same inspector as Launchframe Step 0a). Use the URL’s **hostname** for the output parent (example: `https://www.example.com/path` → `www.example.com`):
+
+1. **One-time per machine:** `npx playwright install chromium` if captures fail for missing browsers.
+2. **Capture:**
+
+```bash
+npm run inspect:page -- "<URL>" --scroll-full --wait-until networkidle --timeout 120000 --out-parent "docs/research/<hostname>/page-inspection"
+```
+
+This creates `docs/research/<hostname>/page-inspection/<hostname>-<iso-stamp>/` with **`document.html`** and related artifacts.
+
+If navigation times out, retry with `--wait-until domcontentloaded` or a higher `--timeout`, and record what worked.
+
+## Step 3 — Verbatim copy to `public`
+
+1. Ensure **`public/captured/`** exists.
+2. Pick the **latest** inspection folder under that hostname (sort by the ISO stamp in the folder name).
+3. **Copy** (do not prettify or edit) **`document.html`** from that folder to:
+
+   **`public/captured/<host-slug>-document.html`**
+
+   where **`<host-slug>`** is the URL hostname with each **`.`** replaced by **`-`** (e.g. `www.example.com` → `www-example-com`).
+
+Same-origin scripts and inline styles stay inside the file; external URLs (CDNs) remain as in the capture.
+
+## Step 4 — Home page iframe
+
+Replace **`src/app/page.tsx`** with a single full-viewport iframe **only** (no `sandbox` — it breaks many real pages):
+
+```tsx
+export default function Home() {
+  return (
+    <iframe
+      src="/captured/<host-slug>-document.html"
+      title="Captured snapshot"
+      className="fixed inset-0 h-dvh w-dvw border-0"
+    />
+  );
+}
+```
+
+Use the same **`<host-slug>`** as in Step 3.
+
+## Step 5 — Verify
+
+Run **`npm run build`** and fix any errors.
+
+## What to tell the user
+
+After **`npm run dev`**:
+
+- **Iframe:** `http://localhost:3000/`
+- **Direct static file:** `http://localhost:3000/captured/<host-slug>-document.html`
+
+## What not to do
+
+- Do **not** treat this as **`/launchframe`** (no parallel component specs, no `docs/research/LAUNCHFRAME_SUBAGENTS.md` runs for snapshot).
+- Do **not** hand-rebuild the page in React for this command.
+- Do **not** add `sandbox` on the iframe unless the user explicitly asks and accepts broken script behavior.

package/.cursor/commands/snapshot.md

@@ -0,0 +1,79 @@
+<!-- AUTO-GENERATED from .claude/skills/snapshot/SKILL.md — do not edit directly.
+     Run `node scripts/sync-skills.mjs` to regenerate. -->
+
+
+# Snapshot (`/snapshot`)
+
+**`/snapshot`** serves a **frozen copy** of a live URL: the captured **`document.html`** from Playwright lives under **`public/captured/`** and **`src/app/page.tsx`** embeds it in a **full-viewport iframe**. This is **verbatim hosting**, not **`/launchframe`** (no component rebuild, no SaaS overlay, no Phase 6 verification).
+
+Parse **the reference URL the user passed with /snapshot**:
+
+1. **URL** — Exactly one `http://` or `https://` URL. If the user omitted it, ask once. If multiple URLs appear, use the **first** only and say you are snapshotting that one.
+
+## Step 1 — Persist the source URL
+
+Update **`src/lib/launchframe-config.ts`**:
+
+- Set **`LAUNCHFRAME_SOURCE_URL`** to the parsed URL (string, `as const`).
+
+## Step 2 — Capture (mandatory)
+
+From the repository root, run **once** for that URL (same inspector as Launchframe Step 0a). Use the URL’s **hostname** for the output parent (example: `https://www.example.com/path` → `www.example.com`):
+
+1. **One-time per machine:** `npx playwright install chromium` if captures fail for missing browsers.
+2. **Capture:**
+
+```bash
+npm run inspect:page -- "<URL>" --scroll-full --wait-until networkidle --timeout 120000 --out-parent "docs/research/<hostname>/page-inspection"
+```
+
+This creates `docs/research/<hostname>/page-inspection/<hostname>-<iso-stamp>/` with **`document.html`** and related artifacts.
+
+If navigation times out, retry with `--wait-until domcontentloaded` or a higher `--timeout`, and record what worked.
+
+## Step 3 — Verbatim copy to `public`
+
+1. Ensure **`public/captured/`** exists.
+2. Pick the **latest** inspection folder under that hostname (sort by the ISO stamp in the folder name).
+3. **Copy** (do not prettify or edit) **`document.html`** from that folder to:
+
+   **`public/captured/<host-slug>-document.html`**
+
+   where **`<host-slug>`** is the URL hostname with each **`.`** replaced by **`-`** (e.g. `www.example.com` → `www-example-com`).
+
+Same-origin scripts and inline styles stay inside the file; external URLs (CDNs) remain as in the capture.
+
+## Step 4 — Home page iframe
+
+Replace **`src/app/page.tsx`** with a single full-viewport iframe **only** (no `sandbox` — it breaks many real pages):
+
+```tsx
+export default function Home() {
+  return (
+    <iframe
+      src="/captured/<host-slug>-document.html"
+      title="Captured snapshot"
+      className="fixed inset-0 h-dvh w-dvw border-0"
+    />
+  );
+}
+```
+
+Use the same **`<host-slug>`** as in Step 3.
+
+## Step 5 — Verify
+
+Run **`npm run build`** and fix any errors.
+
+## What to tell the user
+
+After **`npm run dev`**:
+
+- **Iframe:** `http://localhost:3000/`
+- **Direct static file:** `http://localhost:3000/captured/<host-slug>-document.html`
+
+## What not to do
+
+- Do **not** treat this as **`/launchframe`** (no parallel component specs, no `docs/research/LAUNCHFRAME_SUBAGENTS.md` runs for snapshot).
+- Do **not** hand-rebuild the page in React for this command.
+- Do **not** add `sandbox` on the iframe unless the user explicitly asks and accepts broken script behavior.

package/.gemini/commands/snapshot.toml

@@ -0,0 +1,85 @@
+# AUTO-GENERATED from .claude/skills/snapshot/SKILL.md
+# Run `node scripts/sync-skills.mjs` to regenerate.
+
+description = "Verbatim page snapshot — run inspect:page, copy document.html to public/captured/, and show it on the home route via a full-viewport iframe (not a React rebuild)."
+
+[prompt]
+text = '''
+
+# Snapshot (`/snapshot`)
+
+**`/snapshot`** serves a **frozen copy** of a live URL: the captured **`document.html`** from Playwright lives under **`public/captured/`** and **`src/app/page.tsx`** embeds it in a **full-viewport iframe**. This is **verbatim hosting**, not **`/launchframe`** (no component rebuild, no SaaS overlay, no Phase 6 verification).
+
+Parse **{{args}}**:
+
+1. **URL** — Exactly one `http://` or `https://` URL. If the user omitted it, ask once. If multiple URLs appear, use the **first** only and say you are snapshotting that one.
+
+## Step 1 — Persist the source URL
+
+Update **`src/lib/launchframe-config.ts`**:
+
+- Set **`LAUNCHFRAME_SOURCE_URL`** to the parsed URL (string, `as const`).
+
+## Step 2 — Capture (mandatory)
+
+From the repository root, run **once** for that URL (same inspector as Launchframe Step 0a). Use the URL’s **hostname** for the output parent (example: `https://www.example.com/path` → `www.example.com`):
+
+1. **One-time per machine:** `npx playwright install chromium` if captures fail for missing browsers.
+2. **Capture:**
+
+```bash
+npm run inspect:page -- "<URL>" --scroll-full --wait-until networkidle --timeout 120000 --out-parent "docs/research/<hostname>/page-inspection"
+```
+
+This creates `docs/research/<hostname>/page-inspection/<hostname>-<iso-stamp>/` with **`document.html`** and related artifacts.
+
+If navigation times out, retry with `--wait-until domcontentloaded` or a higher `--timeout`, and record what worked.
+
+## Step 3 — Verbatim copy to `public`
+
+1. Ensure **`public/captured/`** exists.
+2. Pick the **latest** inspection folder under that hostname (sort by the ISO stamp in the folder name).
+3. **Copy** (do not prettify or edit) **`document.html`** from that folder to:
+
+   **`public/captured/<host-slug>-document.html`**
+
+   where **`<host-slug>`** is the URL hostname with each **`.`** replaced by **`-`** (e.g. `www.example.com` → `www-example-com`).
+
+Same-origin scripts and inline styles stay inside the file; external URLs (CDNs) remain as in the capture.
+
+## Step 4 — Home page iframe
+
+Replace **`src/app/page.tsx`** with a single full-viewport iframe **only** (no `sandbox` — it breaks many real pages):
+
+```tsx
+export default function Home() {
+  return (
+    <iframe
+      src="/captured/<host-slug>-document.html"
+      title="Captured snapshot"
+      className="fixed inset-0 h-dvh w-dvw border-0"
+    />
+  );
+}
+```
+
+Use the same **`<host-slug>`** as in Step 3.
+
+## Step 5 — Verify
+
+Run **`npm run build`** and fix any errors.
+
+## What to tell the user
+
+After **`npm run dev`**:
+
+- **Iframe:** `http://localhost:3000/`
+- **Direct static file:** `http://localhost:3000/captured/<host-slug>-document.html`
+
+## What not to do
+
+- Do **not** treat this as **`/launchframe`** (no parallel component specs, no `docs/research/LAUNCHFRAME_SUBAGENTS.md` runs for snapshot).
+- Do **not** hand-rebuild the page in React for this command.
+- Do **not** add `sandbox` on the iframe unless the user explicitly asks and accepts broken script behavior.
+
+'''

package/.github/skills/snapshot/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: snapshot
+description: Verbatim page snapshot — run inspect:page, copy document.html to public/captured/, and show it on the home route via a full-viewport iframe (not a React rebuild).
+argument-hint: "<url>"
+argument-substitution: the reference URL the user passed with /snapshot
+user-invocable: true
+---
+
+# Snapshot (`/snapshot`)
+
+**`/snapshot`** serves a **frozen copy** of a live URL: the captured **`document.html`** from Playwright lives under **`public/captured/`** and **`src/app/page.tsx`** embeds it in a **full-viewport iframe**. This is **verbatim hosting**, not **`/launchframe`** (no component rebuild, no SaaS overlay, no Phase 6 verification).
+
+Parse **$ARGUMENTS**:
+
+1. **URL** — Exactly one `http://` or `https://` URL. If the user omitted it, ask once. If multiple URLs appear, use the **first** only and say you are snapshotting that one.
+
+## Step 1 — Persist the source URL
+
+Update **`src/lib/launchframe-config.ts`**:
+
+- Set **`LAUNCHFRAME_SOURCE_URL`** to the parsed URL (string, `as const`).
+
+## Step 2 — Capture (mandatory)
+
+From the repository root, run **once** for that URL (same inspector as Launchframe Step 0a). Use the URL’s **hostname** for the output parent (example: `https://www.example.com/path` → `www.example.com`):
+
+1. **One-time per machine:** `npx playwright install chromium` if captures fail for missing browsers.
+2. **Capture:**
+
+```bash
+npm run inspect:page -- "<URL>" --scroll-full --wait-until networkidle --timeout 120000 --out-parent "docs/research/<hostname>/page-inspection"
+```
+
+This creates `docs/research/<hostname>/page-inspection/<hostname>-<iso-stamp>/` with **`document.html`** and related artifacts.
+
+If navigation times out, retry with `--wait-until domcontentloaded` or a higher `--timeout`, and record what worked.
+
+## Step 3 — Verbatim copy to `public`
+
+1. Ensure **`public/captured/`** exists.
+2. Pick the **latest** inspection folder under that hostname (sort by the ISO stamp in the folder name).
+3. **Copy** (do not prettify or edit) **`document.html`** from that folder to:
+
+   **`public/captured/<host-slug>-document.html`**
+
+   where **`<host-slug>`** is the URL hostname with each **`.`** replaced by **`-`** (e.g. `www.example.com` → `www-example-com`).
+
+Same-origin scripts and inline styles stay inside the file; external URLs (CDNs) remain as in the capture.
+
+## Step 4 — Home page iframe
+
+Replace **`src/app/page.tsx`** with a single full-viewport iframe **only** (no `sandbox` — it breaks many real pages):
+
+```tsx
+export default function Home() {
+  return (
+    <iframe
+      src="/captured/<host-slug>-document.html"
+      title="Captured snapshot"
+      className="fixed inset-0 h-dvh w-dvw border-0"
+    />
+  );
+}
+```
+
+Use the same **`<host-slug>`** as in Step 3.
+
+## Step 5 — Verify
+
+Run **`npm run build`** and fix any errors.
+
+## What to tell the user
+
+After **`npm run dev`**:
+
+- **Iframe:** `http://localhost:3000/`
+- **Direct static file:** `http://localhost:3000/captured/<host-slug>-document.html`
+
+## What not to do
+
+- Do **not** treat this as **`/launchframe`** (no parallel component specs, no `docs/research/LAUNCHFRAME_SUBAGENTS.md` runs for snapshot).
+- Do **not** hand-rebuild the page in React for this command.
+- Do **not** add `sandbox` on the iframe unless the user explicitly asks and accepts broken script behavior.

package/.opencode/commands/snapshot.md

@@ -0,0 +1,82 @@
+---
+description: "Verbatim page snapshot — run inspect:page, copy document.html to public/captured/, and show it on the home route via a full-viewport iframe (not a React rebuild)."
+---
+<!-- AUTO-GENERATED from .claude/skills/snapshot/SKILL.md — do not edit directly.
+     Run `node scripts/sync-skills.mjs` to regenerate. -->
+
+
+# Snapshot (`/snapshot`)
+
+**`/snapshot`** serves a **frozen copy** of a live URL: the captured **`document.html`** from Playwright lives under **`public/captured/`** and **`src/app/page.tsx`** embeds it in a **full-viewport iframe**. This is **verbatim hosting**, not **`/launchframe`** (no component rebuild, no SaaS overlay, no Phase 6 verification).
+
+Parse **$ARGUMENTS**:
+
+1. **URL** — Exactly one `http://` or `https://` URL. If the user omitted it, ask once. If multiple URLs appear, use the **first** only and say you are snapshotting that one.
+
+## Step 1 — Persist the source URL
+
+Update **`src/lib/launchframe-config.ts`**:
+
+- Set **`LAUNCHFRAME_SOURCE_URL`** to the parsed URL (string, `as const`).
+
+## Step 2 — Capture (mandatory)
+
+From the repository root, run **once** for that URL (same inspector as Launchframe Step 0a). Use the URL’s **hostname** for the output parent (example: `https://www.example.com/path` → `www.example.com`):
+
+1. **One-time per machine:** `npx playwright install chromium` if captures fail for missing browsers.
+2. **Capture:**
+
+```bash
+npm run inspect:page -- "<URL>" --scroll-full --wait-until networkidle --timeout 120000 --out-parent "docs/research/<hostname>/page-inspection"
+```
+
+This creates `docs/research/<hostname>/page-inspection/<hostname>-<iso-stamp>/` with **`document.html`** and related artifacts.
+
+If navigation times out, retry with `--wait-until domcontentloaded` or a higher `--timeout`, and record what worked.
+
+## Step 3 — Verbatim copy to `public`
+
+1. Ensure **`public/captured/`** exists.
+2. Pick the **latest** inspection folder under that hostname (sort by the ISO stamp in the folder name).
+3. **Copy** (do not prettify or edit) **`document.html`** from that folder to:
+
+   **`public/captured/<host-slug>-document.html`**
+
+   where **`<host-slug>`** is the URL hostname with each **`.`** replaced by **`-`** (e.g. `www.example.com` → `www-example-com`).
+
+Same-origin scripts and inline styles stay inside the file; external URLs (CDNs) remain as in the capture.
+
+## Step 4 — Home page iframe
+
+Replace **`src/app/page.tsx`** with a single full-viewport iframe **only** (no `sandbox` — it breaks many real pages):
+
+```tsx
+export default function Home() {
+  return (
+    <iframe
+      src="/captured/<host-slug>-document.html"
+      title="Captured snapshot"
+      className="fixed inset-0 h-dvh w-dvw border-0"
+    />
+  );
+}
+```
+
+Use the same **`<host-slug>`** as in Step 3.
+
+## Step 5 — Verify
+
+Run **`npm run build`** and fix any errors.
+
+## What to tell the user
+
+After **`npm run dev`**:
+
+- **Iframe:** `http://localhost:3000/`
+- **Direct static file:** `http://localhost:3000/captured/<host-slug>-document.html`
+
+## What not to do
+
+- Do **not** treat this as **`/launchframe`** (no parallel component specs, no `docs/research/LAUNCHFRAME_SUBAGENTS.md` runs for snapshot).
+- Do **not** hand-rebuild the page in React for this command.
+- Do **not** add `sandbox` on the iframe unless the user explicitly asks and accepts broken script behavior.

package/.windsurf/workflows/snapshot.md

@@ -0,0 +1,79 @@
+<!-- AUTO-GENERATED from .claude/skills/snapshot/SKILL.md — do not edit directly.
+     Run `node scripts/sync-skills.mjs` to regenerate. -->
+
+
+# Snapshot (`/snapshot`)
+
+**`/snapshot`** serves a **frozen copy** of a live URL: the captured **`document.html`** from Playwright lives under **`public/captured/`** and **`src/app/page.tsx`** embeds it in a **full-viewport iframe**. This is **verbatim hosting**, not **`/launchframe`** (no component rebuild, no SaaS overlay, no Phase 6 verification).
+
+Parse **the reference URL the user passed with /snapshot**:
+
+1. **URL** — Exactly one `http://` or `https://` URL. If the user omitted it, ask once. If multiple URLs appear, use the **first** only and say you are snapshotting that one.
+
+## Step 1 — Persist the source URL
+
+Update **`src/lib/launchframe-config.ts`**:
+
+- Set **`LAUNCHFRAME_SOURCE_URL`** to the parsed URL (string, `as const`).
+
+## Step 2 — Capture (mandatory)
+
+From the repository root, run **once** for that URL (same inspector as Launchframe Step 0a). Use the URL’s **hostname** for the output parent (example: `https://www.example.com/path` → `www.example.com`):
+
+1. **One-time per machine:** `npx playwright install chromium` if captures fail for missing browsers.
+2. **Capture:**
+
+```bash
+npm run inspect:page -- "<URL>" --scroll-full --wait-until networkidle --timeout 120000 --out-parent "docs/research/<hostname>/page-inspection"
+```
+
+This creates `docs/research/<hostname>/page-inspection/<hostname>-<iso-stamp>/` with **`document.html`** and related artifacts.
+
+If navigation times out, retry with `--wait-until domcontentloaded` or a higher `--timeout`, and record what worked.
+
+## Step 3 — Verbatim copy to `public`
+
+1. Ensure **`public/captured/`** exists.
+2. Pick the **latest** inspection folder under that hostname (sort by the ISO stamp in the folder name).
+3. **Copy** (do not prettify or edit) **`document.html`** from that folder to:
+
+   **`public/captured/<host-slug>-document.html`**
+
+   where **`<host-slug>`** is the URL hostname with each **`.`** replaced by **`-`** (e.g. `www.example.com` → `www-example-com`).
+
+Same-origin scripts and inline styles stay inside the file; external URLs (CDNs) remain as in the capture.
+
+## Step 4 — Home page iframe
+
+Replace **`src/app/page.tsx`** with a single full-viewport iframe **only** (no `sandbox` — it breaks many real pages):
+
+```tsx
+export default function Home() {
+  return (
+    <iframe
+      src="/captured/<host-slug>-document.html"
+      title="Captured snapshot"
+      className="fixed inset-0 h-dvh w-dvw border-0"
+    />
+  );
+}
+```
+
+Use the same **`<host-slug>`** as in Step 3.
+
+## Step 5 — Verify
+
+Run **`npm run build`** and fix any errors.
+
+## What to tell the user
+
+After **`npm run dev`**:
+
+- **Iframe:** `http://localhost:3000/`
+- **Direct static file:** `http://localhost:3000/captured/<host-slug>-document.html`
+
+## What not to do
+
+- Do **not** treat this as **`/launchframe`** (no parallel component specs, no `docs/research/LAUNCHFRAME_SUBAGENTS.md` runs for snapshot).
+- Do **not** hand-rebuild the page in React for this command.
+- Do **not** add `sandbox` on the iframe unless the user explicitly asks and accepts broken script behavior.

package/AGENTS.md

@@ -7,7 +7,7 @@ This version has breaking changes — APIs, conventions, and file structure may
 # Website Reverse-Engineer Template
 
 ## What This Is
-A reusable template for reverse-engineering any website into a clean, modern Next.js codebase using AI coding agents. The Next.js + shadcn/ui + Tailwind v4 base is pre-scaffolded — use **`/launchframe <url> "saas idea"`** for the full pixel-perfect clone plus SaaS landing copy (`src/lib/launchframe-config.ts`, `launchframe.context.json`, `docs/research/LAUNCHFRAME.md`). The agent executing **`/launchframe`** must follow **Step 0a** in that command: run **`npm run inspect:page`** once per reference URL (Playwright: `document.html`, network CSS, `motion-summary.json`) before Phase 1. For a **new empty folder** only, **`npx launchframe@latest`** unpacks this template; then run **`/launchframe`** in that project with your URL and pitch.
+A reusable template for reverse-engineering any website into a clean, modern Next.js codebase using AI coding agents. The Next.js + shadcn/ui + Tailwind v4 base is pre-scaffolded — use **`/launchframe <url> "saas idea"`** for the full pixel-perfect clone plus SaaS landing copy (`src/lib/launchframe-config.ts`, `launchframe.context.json`, `docs/research/LAUNCHFRAME.md`). The agent executing **`/launchframe`** must follow **Step 0a** in that command: run **`npm run inspect:page`** once per reference URL (Playwright: `document.html`, network CSS, `motion-summary.json`) before Phase 1. Use **`/snapshot <url>`** for a **verbatim** local copy: Playwright capture → `public/captured/<host>-document.html` → full-viewport iframe on **`src/app/page.tsx`** (not a React rebuild). For a **new empty folder** only, **`npx launchframe@latest`** unpacks this template; then run **`/launchframe`** in that project with your URL and pitch.
 
 ## Tech Stack
 - **Framework:** Next.js 16 (App Router, React 19, TypeScript strict)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "launchframe",
-  "version": "0.4.12",
+  "version": "0.4.13",
   "private": false,
   "description": "Scaffold a Next.js app from a reference URL plus your SaaS idea — AI-ready website cloning",
   "author": "JCodesMore",

package/src/app/page.tsx

@@ -1,40 +1,9 @@
-import Link from "next/link";
-
-import {
-  LAUNCHFRAME_SAAS_IDEA,
-  LAUNCHFRAME_SOURCE_URL,
-} from "@/lib/launchframe-config";
-
 export default function Home() {
   return (
-    <main className="flex min-h-screen flex-col items-center justify-center gap-8 px-6 py-16">
-      <div className="mx-auto max-w-2xl space-y-6 text-center">
-        <p className="text-xs font-semibold uppercase tracking-[0.2em] text-muted-foreground">
-          SaaS idea
-        </p>
-        <h1 className="text-balance text-3xl font-semibold tracking-tight text-foreground sm:text-4xl whitespace-pre-wrap">
-          {LAUNCHFRAME_SAAS_IDEA}
-        </h1>
-        <p className="text-pretty text-sm text-muted-foreground sm:text-base">
-          Visual reference (clone target):{" "}
-          <Link
-            href={LAUNCHFRAME_SOURCE_URL}
-            className="font-medium text-foreground underline underline-offset-4"
-            target="_blank"
-            rel="noreferrer noopener"
-          >
-            {LAUNCHFRAME_SOURCE_URL}
-          </Link>
-        </p>
-        <p className="text-pretty text-sm text-muted-foreground">
-          Run{" "}
-          <code className="rounded-md bg-muted px-2 py-1 font-mono text-foreground">
-            /launchframe {LAUNCHFRAME_SOURCE_URL} &quot;…your saas idea…&quot;
-          </code>{" "}
-          with your AI agent to rebuild this layout from the reference site while keeping the SaaS
-          positioning above.
-        </p>
-      </div>
-    </main>
+    <iframe
+      src="/captured/example-com-document.html"
+      title="Captured reference page"
+      className="fixed inset-0 h-dvh w-dvw border-0"
+    />
   );
 }