launchframe 0.2.5 → 0.2.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/template/.amazonq/cli-agents/clone-website.json +1 -1
- package/template/.amazonq/rules/project.md +28 -18
- package/template/.augment/commands/clone-website.md +25 -25
- package/template/.claude/skills/clone-website/SKILL.md +25 -25
- package/template/.claude/skills/marketing-social-proof-motion/SKILL.md +47 -0
- package/template/.clinerules +33 -19
- package/template/.codex/skills/clone-website/SKILL.md +25 -25
- package/template/.continue/commands/clone-website.md +25 -25
- package/template/.continue/rules/project.md +28 -18
- package/template/.cursor/commands/clone-website.md +25 -25
- package/template/.cursor/commands/marketing-social-proof-motion.md +42 -0
- package/template/.cursor/rules/project.mdc +1 -4
- package/template/.gemini/commands/clone-website.toml +25 -25
- package/template/.github/copilot-instructions.md +28 -18
- package/template/.github/skills/clone-website/SKILL.md +25 -25
- package/template/.opencode/commands/clone-website.md +25 -25
- package/template/.windsurf/workflows/clone-website.md +25 -25
- package/template/AGENTS.md +24 -12
- package/template/docs/research/INSPECTION_GUIDE.md +11 -8
- package/template/package-lock.json +8795 -0
- package/template/scripts/recon-playwright.mjs +90 -17
- package/template/src/components/marketing/scribewise-landing.tsx +34 -0
- package/template/.claude/skills/marketing-landing-production/SKILL.md +0 -36
- package/template/.cursor/commands/marketing-landing-production.md +0 -31
|
@@ -36,7 +36,7 @@ If the user provides additional instructions (specific fidelity level, deeper cu
|
|
|
36
36
|
## Pre-Flight
|
|
37
37
|
|
|
38
38
|
1. **Read `launchframe.config.json`** (see Step 0 above). After a fresh `npx launchframe` scaffold, proceed immediately — only echo `url`/`idea` for confirmation if the config looks wrong or the user asked to verify.
|
|
39
|
-
2. **Browser automation.** Prefer an MCP (Chrome DevTools MCP, Playwright MCP, Browserbase MCP, etc.) when it is healthy. **If MCP is missing or in an error state, run `npm run recon` (Playwright)** — see `scripts/recon-playwright.mjs`. It writes
|
|
39
|
+
2. **Browser automation.** Prefer an MCP (Chrome DevTools MCP, Playwright MCP, Browserbase MCP, etc.) when it is healthy. **If MCP is missing or in an error state, run `npm run recon` (Playwright)** — see `scripts/recon-playwright.mjs`. It performs **stabilized full-document scrolling** at desktop and mobile, writes merged **`computed-snapshot.json`** + **`MEDIA_MANIFEST.md`**, and **full-page** screenshots under `docs/design-references/`. Use `npm run recon:headed` if headless hits a WAF/challenge page. One-time install: `npx playwright install chromium`. Do not skip extraction — adapt the pipeline to the tools that work.
|
|
40
40
|
3. Validate the resolved URL(s). Normalize and verify each is accessible via your browser MCP tool. If any are invalid, ask the user to correct `launchframe.config.json` (or pass an override) before proceeding.
|
|
41
41
|
4. Verify the base project builds: `npm run build`. The Next.js + shadcn/ui + Tailwind v4 scaffold should already be in place. If not, tell the user to run `npm install` first.
|
|
42
42
|
5. Create the output directories if they don't exist: `docs/research/`, `docs/research/components/`, `docs/design-references/`, `scripts/`. Plan `docs/research/MEDIA_MANIFEST.md` as soon as media is inventoried. For multiple clones, also prepare per-site folders like `docs/research/<hostname>/` and `docs/design-references/<hostname>/`.
|
|
@@ -52,7 +52,7 @@ These are the truths that separate a successful clone from a "close enough" mess
|
|
|
52
52
|
|
|
53
53
|
**Motion defaults to Framer Motion.** This template lists `framer-motion` as a dependency. After foundation tokens, ensure `import { motion } from "framer-motion"` (and related APIs: `useScroll`, `useTransform`, `AnimatePresence`, `LayoutGroup`, **`useReducedMotion`**) for: scroll-triggered reveals, staggered children, layout transitions, and gestures — anything beyond a trivial one-property CSS `transition`. In each spec file, add a **Motion** subsection: trigger, duration, easing, delay/stagger, **tier A–E coverage** (see `AGENTS.md` production polish table), reduced-motion fallback, and **implementation: CSS | framer-motion**. Prefer CSS only when it matches the target exactly without JS.
|
|
54
54
|
|
|
55
|
-
**Illustration & pixel art are production inputs.** Where the target (or post-rebrand layout) lacks convincing visuals, specs MUST
|
|
55
|
+
**Illustration & pixel art are production inputs.** Where the target (or post-rebrand layout) lacks convincing visuals, specs MUST allocate **idea-tailored SVG scenes** — metaphors drawn from `launchframe.config.json#idea`, documented with **Idea tie-in** per asset — not generic gray placeholders or unrelated clipart. Pixel-art motifs require concept justification plus palette table in the spec.
|
|
56
56
|
|
|
57
57
|
### 1. Completeness Beats Speed
|
|
58
58
|
|
|
@@ -139,10 +139,12 @@ Every builder agent must verify `npx tsc --noEmit` passes before finishing. Afte
|
|
|
139
139
|
|
|
140
140
|
Navigate to the target URL with browser MCP.
|
|
141
141
|
|
|
142
|
-
### Screenshots
|
|
143
|
-
-
|
|
144
|
-
-
|
|
145
|
-
-
|
|
142
|
+
### Screenshots *(entire landing — never “above the fold” only)*
|
|
143
|
+
- Capture the **whole marketing surface**: hero through footer (single-page landings). Do **not** stop after the first viewport — lazy-loaded sections, footer nav, and bottom CTAs are required context.
|
|
144
|
+
- Before **every** full-page capture (MCP or Playwright): **slow scroll top → bottom → top** once or twice until `scrollHeight` stops growing, so lazy images/`srcset`/`data-src` resolve where possible.
|
|
145
|
+
- Take **`fullPage: true`** (or MCP equivalent) screenshots at desktop (**1440px**) and mobile (**390px**); save under `docs/design-references/` with descriptive names.
|
|
146
|
+
- **`npm run recon`** already performs stabilized full-document scrolling + merged desktop/mobile asset inventory — prefer running it when automation must match full-page depth reliably.
|
|
147
|
+
- These masters are references — builders still get section crops later, but those crops must exist because **you** scrolled and documented every band first.
|
|
146
148
|
|
|
147
149
|
### Global Extraction
|
|
148
150
|
Extract these from the page before doing anything else:
|
|
@@ -372,10 +374,12 @@ For each section (or sub-component, if you're breaking it up), create a spec fil
|
|
|
372
374
|
- **Library:** <`framer-motion` | CSS-only — justify if CSS-only>
|
|
373
375
|
- **Keyframes / springs:** <if any — match target curve>
|
|
374
376
|
|
|
375
|
-
## Illustration & pixel art *(production uplift)*
|
|
377
|
+
## Illustration & pixel art *(production uplift — idea-native)*
|
|
378
|
+
- **Idea tie-in:** <one sentence — why this asset belongs only to this product>
|
|
379
|
+
- **Metaphor link:** <which keyword from `idea` / metaphor list this illustrates>
|
|
376
380
|
- **SVG components:** <named exports, paths using currentColor vs fixed fills>
|
|
377
381
|
- **Pixel motif:** <palette hex table, grid, scaling — or N/A>
|
|
378
|
-
- **Motif thread:** <how
|
|
382
|
+
- **Motif thread:** <how this echoes logo / OG / favicon for this SaaS>
|
|
379
383
|
|
|
380
384
|
## Per-State Content (if applicable)
|
|
381
385
|
|
|
@@ -457,11 +461,7 @@ For every section, replace:
|
|
|
457
461
|
3. **Feature/section copy** — rewrite each feature card, callout, stat, and testimonial to fit the SaaS idea. Preserve the count and shape of items (3 feature cards stay 3 feature cards; a 4-column logo bar stays 4 columns). Generate plausible customer-logo names — never use real company names you haven't been authorized to use.
|
|
458
462
|
4. **CTA labels** — adapt button text to the SaaS idea ("Start free", "Get a demo", "Try it free", etc.). Keep the CTA hierarchy (primary/secondary) identical to the original.
|
|
459
463
|
5. **Mock data** — for product UI mockups embedded in marketing screenshots (e.g., a fake dashboard inside a hero), generate mock data shaped for the SaaS idea: realistic-looking but fictional rows, charts, conversation logs, etc.
|
|
460
|
-
6. **Imagery** —
|
|
461
|
-
- A neutral abstract gradient / shape composition you generate with CSS or SVG
|
|
462
|
-
- A Lucide icon arrangement
|
|
463
|
-
- Placeholder service URLs only if explicitly allowed by the user
|
|
464
|
-
Keep dimensions, aspect ratios, drop shadows, and surrounding spacing identical to the original.
|
|
464
|
+
6. **Imagery** — Replace photography/screenshots that depict the original brand with visuals **authored for this SaaS idea**, not interchangeable decoration. Before designing: derive a **metaphor list** from `idea` (3–6 concrete hooks). Each hero/feature/OG asset gets an **Idea tie-in** sentence in `docs/research/REBRAND.md`. Prefer bespoke SVG scenes (`src/components/marketing/art/`) or raster under `public/images/marketing/` that preserve dimensions/aspect/shadows from the cloned layout. **Avoid:** unrelated filler (e.g. apparel, random lifestyle props when the product is notes/voice), generic gradient-only heroes, Lucide-icon piles unless the reference was already that minimal — those fail the uniqueness bar in `AGENTS.md`.
|
|
465
465
|
7. **Metadata** — update `<title>`, meta description, OG tags, and favicon manifest in `src/app/layout.tsx` to reflect the new SaaS. Generate a simple favicon (initial letter on a brand-colored square) if no asset is provided.
|
|
466
466
|
|
|
467
467
|
What you must NOT change in this pass:
|
|
@@ -472,25 +472,24 @@ What you must NOT change in this pass:
|
|
|
472
472
|
|
|
473
473
|
After the rebrand pass, the codebase should look like the original site visually but read like the user's SaaS at a glance. Save a short `docs/research/REBRAND.md` summarizing the product name you chose, the headline rewrites, and any assets you swapped — so the user can audit what's clone-derived vs. authored.
|
|
474
474
|
|
|
475
|
-
## Phase 4.6: Production uplift *(sparse references /
|
|
475
|
+
## Phase 4.6: Production uplift *(sparse references / stronger idea-specific art)*
|
|
476
476
|
|
|
477
477
|
Run this pass when **any** of the following is true:
|
|
478
478
|
|
|
479
479
|
- The cloned reference is mostly typography with weak imagery (internal demos, minimalist SaaS shells).
|
|
480
|
-
- The user asks for **more
|
|
481
|
-
- Visual QA feels “correct but dead” — layout matches but
|
|
480
|
+
- The user asks for **more unique images**, **illustration tailored to the idea**, **stronger visuals**, motion, pixel art, or production polish.
|
|
481
|
+
- Visual QA feels “correct but dead” — layout matches but art is generic, unrelated, or repeated stock metaphors.
|
|
482
482
|
|
|
483
|
-
**Do not contradict pixel-perfect emulation when cloning a rich reference** — this phase *adds*
|
|
483
|
+
**Do not contradict pixel-perfect emulation when cloning a rich reference** — this phase *adds* or swaps **idea-native** imagery only where the brief allows uplift or the reference was inherently flat.
|
|
484
484
|
|
|
485
|
-
Checklist (mirror `AGENTS.md`):
|
|
485
|
+
Checklist (mirror `AGENTS.md` — **uniqueness first**):
|
|
486
486
|
|
|
487
|
-
1. **
|
|
488
|
-
2. **
|
|
489
|
-
3. **
|
|
487
|
+
1. **Idea-tailored imagery** — Metaphor list from `idea`; replace any asset that could belong to another vertical. Per-asset **Idea tie-in** in `docs/research/PRODUCTION_UPLIFT.md` alongside SVG/raster paths.
|
|
488
|
+
2. **Density** — Layered hero + distinct scene per feature card in **one shared visual language** (stroke/accent/grid), still idea-specific.
|
|
489
|
+
3. **Motion tiers** — Implement at minimum **A + B + one of C/D**, optionally **E**: staggered hero load, `whileInView` sections + card stagger, looping ambient (marquee / caret / SVG dash loop), hover lifts / nav scroll shrink, optional light parallax. Gate loops with **`useReducedMotion()`**.
|
|
490
|
+
4. **Brand** — Motif thread + accent tokens in `:root`; favicon / OG echo **this** product narrative.
|
|
490
491
|
|
|
491
|
-
Document deltas in `docs/research/PRODUCTION_UPLIFT.md
|
|
492
|
-
|
|
493
|
-
Invoke `.claude/skills/marketing-landing-production/SKILL.md` as a focused playbook for this pass.
|
|
492
|
+
Document deltas in `docs/research/PRODUCTION_UPLIFT.md`.
|
|
494
493
|
|
|
495
494
|
## Phase 5: Visual QA Diff
|
|
496
495
|
|
|
@@ -521,7 +520,7 @@ Before dispatching ANY builder agent, verify you can check every box. If you can
|
|
|
521
520
|
- [ ] All images in the section are identified (including overlays and layered compositions)
|
|
522
521
|
- [ ] Any `<video>` (and poster), Lottie, or canvas-driven hero is identified — not approximated as a static div
|
|
523
522
|
- [ ] **Motion** subsection filled: tiers **A–E** coverage (see `AGENTS.md`), CSS vs **framer-motion**, durations, easings, stagger, scroll triggers, **reduced-motion** fallback
|
|
524
|
-
- [ ] **Illustration** subsection filled when uplift applies:
|
|
523
|
+
- [ ] **Illustration** subsection filled when uplift applies: **Idea tie-in** + metaphor link per asset, SVG/pixel detail — or explicit **N/A** with justification only on strict clone parity jobs
|
|
525
524
|
- [ ] Responsive behavior is documented for at least desktop and mobile
|
|
526
525
|
- [ ] Text content is verbatim from the site, not paraphrased
|
|
527
526
|
- [ ] The builder prompt is under ~150 lines of spec; if over, the section needs to be split
|
|
@@ -544,6 +543,7 @@ These are lessons from previous failed clones — each one cost hours of rework:
|
|
|
544
543
|
- **Don't bundle unrelated sections into one agent.** A CTA section and a footer are different components with different designs — don't hand them both to one agent and hope for the best.
|
|
545
544
|
- **Don't skip responsive extraction.** If you only inspect at desktop width, the clone will break at tablet and mobile. Test at 1440, 768, and 390 during extraction.
|
|
546
545
|
- **Don't forget smooth scroll libraries.** Check for Lenis (`.lenis` class), Locomotive Scroll, or similar. Default browser scrolling feels noticeably different and the user will spot it immediately.
|
|
546
|
+
- **Don't ship interchangeable marketing art.** Random objects, unrelated lifestyle stock, or generic gradients that could match any SaaS violate the **idea-tailored** rule in `AGENTS.md` — every major visual needs a metaphor from `launchframe.config.json#idea`.
|
|
547
547
|
- **Don't dispatch builders without a spec file.** The spec file forces exhaustive extraction and creates an auditable artifact. Skipping it means the builder gets whatever you can fit in a prompt from memory.
|
|
548
548
|
|
|
549
549
|
## Completion
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
<!-- Canonical source: `.claude/skills/marketing-social-proof-motion/SKILL.md` — edit there first, then mirror here if needed. -->
|
|
2
|
+
|
|
3
|
+
# Marketing social proof, logos & motion
|
|
4
|
+
|
|
5
|
+
Ship sections that **feel alive**: named companies, visible marks, and **layered animation**. Generic gray blobs and static stacks fail this skill.
|
|
6
|
+
|
|
7
|
+
## Named companies & copy
|
|
8
|
+
|
|
9
|
+
- **Name real companies** where they strengthen the story: integrations (“Works with Slack, Salesforce…”), ecosystems, categories, or illustrative comparables the user allows.
|
|
10
|
+
- **Do not invent endorsements.** Prefer truthful framings — “integrations,” “compatible with,” “shared stack,” “customers like” — unless the user supplied verified quotes/customers.
|
|
11
|
+
- **Keep lists purposeful.** Match companies to `launchframe.config.json#idea` when present; avoid unrelated mega-brand name-dropping.
|
|
12
|
+
|
|
13
|
+
## Logo marks & imagery
|
|
14
|
+
|
|
15
|
+
- **Prefer real marks** when implementation-ready: monochrome SVG or PNG from vendor press/media kits, neutral compatibility strips, or OSS icon sets where license permits. Normalize to one visual system (single height, consistent padding, grayscale or duotone).
|
|
16
|
+
- **Store assets** under `public/images/logos/` or `public/images/partners/` with predictable filenames; reference **local paths** in components — no hotlinked SVGs from third-party CDNs in production UI.
|
|
17
|
+
- **If a mark is missing, blocked, or unclear:**
|
|
18
|
+
- Generate **original** imagery (image-generation tool or hand-authored SVG) — illustrated tiles, abstract glyphs, or metaphor icons tied to the **idea** — **not** counterfeit logos.
|
|
19
|
+
- Or ship **clean text lockups** (company wordmark as styled type) where safer than guessing trademark artwork.
|
|
20
|
+
|
|
21
|
+
## Motion emphasis (non-negotiable bar)
|
|
22
|
+
|
|
23
|
+
Motion sells credibility — implement several layers using **`framer-motion`** + CSS loops where appropriate; honor **`prefers-reduced-motion`**.
|
|
24
|
+
|
|
25
|
+
| Layer | Goal | Typical implementation |
|
|
26
|
+
|-------|------|-------------------------|
|
|
27
|
+
| **Entrance** | Logos/testimonials **stagger in** | Parent `variants` + `staggerChildren`; opacity + `y` or blur-in on type |
|
|
28
|
+
| **Scroll** | Proof bands **ease up / fade** on first view | `whileInView` + `viewport.once`; sensible `margin` so reveals feel early |
|
|
29
|
+
| **Ambient** | Strip feels “live” | **Infinite marquee** (slow), gradient drift, subtle opacity pulse on logos |
|
|
30
|
+
| **Hover / focus** | Cards lift; logos brighten | `whileHover` / CSS transitions on transforms + shadow |
|
|
31
|
+
| **Depth** | Premium polish | Light pointer **parallax** on hero/logo cluster (small ranges) or scroll-linked `useTransform` |
|
|
32
|
+
|
|
33
|
+
Also align tier **A–E** choreography and reduced-motion fallbacks described in **`AGENTS.md`** (Production polish → Motion choreography).
|
|
34
|
+
|
|
35
|
+
## Hand-off checklist
|
|
36
|
+
|
|
37
|
+
- [ ] Companies named in copy match user intent and truthful framing
|
|
38
|
+
- [ ] Every logo path documented; placeholders explained if generated
|
|
39
|
+
- [ ] At least **two** motion layers beyond a single fade (e.g., stagger + marquee, or scroll reveal + hover lift)
|
|
40
|
+
- [ ] Reduced-motion path removes loops and tightens entrances
|
|
41
|
+
|
|
42
|
+
When cloning an existing page, **extract** logo SVGs/rasters like any other asset; when authoring from scratch, follow this skill instead of shipping motionless filler.
|
|
@@ -13,10 +13,7 @@ When the user says **Build it**, **Go**, **Ship it**, **Clone the site**, **Run
|
|
|
13
13
|
2. Execute the **full** workflow described in `AGENTS.md` and in `.cursor/commands/clone-website.md` (recon → foundation → component specs → build → SaaS rebrand pass → assembly → QA).
|
|
14
14
|
3. Continue until `npm run build` passes unless the user stops you.
|
|
15
15
|
|
|
16
|
-
Do **not** ask the user to re-type the URL or idea unless the config is missing or broken. Optional slash commands:
|
|
17
|
-
|
|
18
|
-
- **`/clone-website`** — full recon → clone → rebrand pipeline (`launchframe.config.json`).
|
|
19
|
-
- **`/marketing-landing-production`** — production polish pass: SVG illustration density, pixel-art accents, choreographed motion tiers A–E, accent tokens, OG/favicon cohesion (see `AGENTS.md`).
|
|
16
|
+
Do **not** ask the user to re-type the URL or idea unless the config is missing or broken. Optional slash commands: **`/clone-website`** (full clone pipeline from `launchframe.config.json`), **`/marketing-social-proof-motion`** (named companies + logos + motion-heavy proof sections — see `.claude/skills/marketing-social-proof-motion/SKILL.md`). **Idea-tailored imagery** (unique art per `idea`) is required guidance in **`AGENTS.md`** — encoded in rebrand **Imagery** + **Phase 4.6**, not a separate skill.
|
|
20
17
|
|
|
21
18
|
## Browser automation
|
|
22
19
|
|
|
@@ -40,7 +40,7 @@ If the user provides additional instructions (specific fidelity level, deeper cu
|
|
|
40
40
|
## Pre-Flight
|
|
41
41
|
|
|
42
42
|
1. **Read `launchframe.config.json`** (see Step 0 above). After a fresh `npx launchframe` scaffold, proceed immediately — only echo `url`/`idea` for confirmation if the config looks wrong or the user asked to verify.
|
|
43
|
-
2. **Browser automation.** Prefer an MCP (Chrome DevTools MCP, Playwright MCP, Browserbase MCP, etc.) when it is healthy. **If MCP is missing or in an error state, run `npm run recon` (Playwright)** — see `scripts/recon-playwright.mjs`. It writes
|
|
43
|
+
2. **Browser automation.** Prefer an MCP (Chrome DevTools MCP, Playwright MCP, Browserbase MCP, etc.) when it is healthy. **If MCP is missing or in an error state, run `npm run recon` (Playwright)** — see `scripts/recon-playwright.mjs`. It performs **stabilized full-document scrolling** at desktop and mobile, writes merged **`computed-snapshot.json`** + **`MEDIA_MANIFEST.md`**, and **full-page** screenshots under `docs/design-references/`. Use `npm run recon:headed` if headless hits a WAF/challenge page. One-time install: `npx playwright install chromium`. Do not skip extraction — adapt the pipeline to the tools that work.
|
|
44
44
|
3. Validate the resolved URL(s). Normalize and verify each is accessible via your browser MCP tool. If any are invalid, ask the user to correct `launchframe.config.json` (or pass an override) before proceeding.
|
|
45
45
|
4. Verify the base project builds: `npm run build`. The Next.js + shadcn/ui + Tailwind v4 scaffold should already be in place. If not, tell the user to run `npm install` first.
|
|
46
46
|
5. Create the output directories if they don't exist: `docs/research/`, `docs/research/components/`, `docs/design-references/`, `scripts/`. Plan `docs/research/MEDIA_MANIFEST.md` as soon as media is inventoried. For multiple clones, also prepare per-site folders like `docs/research/<hostname>/` and `docs/design-references/<hostname>/`.
|
|
@@ -56,7 +56,7 @@ These are the truths that separate a successful clone from a "close enough" mess
|
|
|
56
56
|
|
|
57
57
|
**Motion defaults to Framer Motion.** This template lists `framer-motion` as a dependency. After foundation tokens, ensure `import { motion } from "framer-motion"` (and related APIs: `useScroll`, `useTransform`, `AnimatePresence`, `LayoutGroup`, **`useReducedMotion`**) for: scroll-triggered reveals, staggered children, layout transitions, and gestures — anything beyond a trivial one-property CSS `transition`. In each spec file, add a **Motion** subsection: trigger, duration, easing, delay/stagger, **tier A–E coverage** (see `AGENTS.md` production polish table), reduced-motion fallback, and **implementation: CSS | framer-motion**. Prefer CSS only when it matches the target exactly without JS.
|
|
58
58
|
|
|
59
|
-
**Illustration & pixel art are production inputs.** Where the target (or post-rebrand layout) lacks convincing visuals, specs MUST
|
|
59
|
+
**Illustration & pixel art are production inputs.** Where the target (or post-rebrand layout) lacks convincing visuals, specs MUST allocate **idea-tailored SVG scenes** — metaphors drawn from `launchframe.config.json#idea`, documented with **Idea tie-in** per asset — not generic gray placeholders or unrelated clipart. Pixel-art motifs require concept justification plus palette table in the spec.
|
|
60
60
|
|
|
61
61
|
### 1. Completeness Beats Speed
|
|
62
62
|
|
|
@@ -143,10 +143,12 @@ Every builder agent must verify `npx tsc --noEmit` passes before finishing. Afte
|
|
|
143
143
|
|
|
144
144
|
Navigate to the target URL with browser MCP.
|
|
145
145
|
|
|
146
|
-
### Screenshots
|
|
147
|
-
-
|
|
148
|
-
-
|
|
149
|
-
-
|
|
146
|
+
### Screenshots *(entire landing — never “above the fold” only)*
|
|
147
|
+
- Capture the **whole marketing surface**: hero through footer (single-page landings). Do **not** stop after the first viewport — lazy-loaded sections, footer nav, and bottom CTAs are required context.
|
|
148
|
+
- Before **every** full-page capture (MCP or Playwright): **slow scroll top → bottom → top** once or twice until `scrollHeight` stops growing, so lazy images/`srcset`/`data-src` resolve where possible.
|
|
149
|
+
- Take **`fullPage: true`** (or MCP equivalent) screenshots at desktop (**1440px**) and mobile (**390px**); save under `docs/design-references/` with descriptive names.
|
|
150
|
+
- **`npm run recon`** already performs stabilized full-document scrolling + merged desktop/mobile asset inventory — prefer running it when automation must match full-page depth reliably.
|
|
151
|
+
- These masters are references — builders still get section crops later, but those crops must exist because **you** scrolled and documented every band first.
|
|
150
152
|
|
|
151
153
|
### Global Extraction
|
|
152
154
|
Extract these from the page before doing anything else:
|
|
@@ -376,10 +378,12 @@ For each section (or sub-component, if you're breaking it up), create a spec fil
|
|
|
376
378
|
- **Library:** <`framer-motion` | CSS-only — justify if CSS-only>
|
|
377
379
|
- **Keyframes / springs:** <if any — match target curve>
|
|
378
380
|
|
|
379
|
-
## Illustration & pixel art *(production uplift)*
|
|
381
|
+
## Illustration & pixel art *(production uplift — idea-native)*
|
|
382
|
+
- **Idea tie-in:** <one sentence — why this asset belongs only to this product>
|
|
383
|
+
- **Metaphor link:** <which keyword from `idea` / metaphor list this illustrates>
|
|
380
384
|
- **SVG components:** <named exports, paths using currentColor vs fixed fills>
|
|
381
385
|
- **Pixel motif:** <palette hex table, grid, scaling — or N/A>
|
|
382
|
-
- **Motif thread:** <how
|
|
386
|
+
- **Motif thread:** <how this echoes logo / OG / favicon for this SaaS>
|
|
383
387
|
|
|
384
388
|
## Per-State Content (if applicable)
|
|
385
389
|
|
|
@@ -461,11 +465,7 @@ For every section, replace:
|
|
|
461
465
|
3. **Feature/section copy** — rewrite each feature card, callout, stat, and testimonial to fit the SaaS idea. Preserve the count and shape of items (3 feature cards stay 3 feature cards; a 4-column logo bar stays 4 columns). Generate plausible customer-logo names — never use real company names you haven't been authorized to use.
|
|
462
466
|
4. **CTA labels** — adapt button text to the SaaS idea ("Start free", "Get a demo", "Try it free", etc.). Keep the CTA hierarchy (primary/secondary) identical to the original.
|
|
463
467
|
5. **Mock data** — for product UI mockups embedded in marketing screenshots (e.g., a fake dashboard inside a hero), generate mock data shaped for the SaaS idea: realistic-looking but fictional rows, charts, conversation logs, etc.
|
|
464
|
-
6. **Imagery** —
|
|
465
|
-
- A neutral abstract gradient / shape composition you generate with CSS or SVG
|
|
466
|
-
- A Lucide icon arrangement
|
|
467
|
-
- Placeholder service URLs only if explicitly allowed by the user
|
|
468
|
-
Keep dimensions, aspect ratios, drop shadows, and surrounding spacing identical to the original.
|
|
468
|
+
6. **Imagery** — Replace photography/screenshots that depict the original brand with visuals **authored for this SaaS idea**, not interchangeable decoration. Before designing: derive a **metaphor list** from `idea` (3–6 concrete hooks). Each hero/feature/OG asset gets an **Idea tie-in** sentence in `docs/research/REBRAND.md`. Prefer bespoke SVG scenes (`src/components/marketing/art/`) or raster under `public/images/marketing/` that preserve dimensions/aspect/shadows from the cloned layout. **Avoid:** unrelated filler (e.g. apparel, random lifestyle props when the product is notes/voice), generic gradient-only heroes, Lucide-icon piles unless the reference was already that minimal — those fail the uniqueness bar in `AGENTS.md`.
|
|
469
469
|
7. **Metadata** — update `<title>`, meta description, OG tags, and favicon manifest in `src/app/layout.tsx` to reflect the new SaaS. Generate a simple favicon (initial letter on a brand-colored square) if no asset is provided.
|
|
470
470
|
|
|
471
471
|
What you must NOT change in this pass:
|
|
@@ -476,25 +476,24 @@ What you must NOT change in this pass:
|
|
|
476
476
|
|
|
477
477
|
After the rebrand pass, the codebase should look like the original site visually but read like the user's SaaS at a glance. Save a short `docs/research/REBRAND.md` summarizing the product name you chose, the headline rewrites, and any assets you swapped — so the user can audit what's clone-derived vs. authored.
|
|
478
478
|
|
|
479
|
-
## Phase 4.6: Production uplift *(sparse references /
|
|
479
|
+
## Phase 4.6: Production uplift *(sparse references / stronger idea-specific art)*
|
|
480
480
|
|
|
481
481
|
Run this pass when **any** of the following is true:
|
|
482
482
|
|
|
483
483
|
- The cloned reference is mostly typography with weak imagery (internal demos, minimalist SaaS shells).
|
|
484
|
-
- The user asks for **more
|
|
485
|
-
- Visual QA feels “correct but dead” — layout matches but
|
|
484
|
+
- The user asks for **more unique images**, **illustration tailored to the idea**, **stronger visuals**, motion, pixel art, or production polish.
|
|
485
|
+
- Visual QA feels “correct but dead” — layout matches but art is generic, unrelated, or repeated stock metaphors.
|
|
486
486
|
|
|
487
|
-
**Do not contradict pixel-perfect emulation when cloning a rich reference** — this phase *adds*
|
|
487
|
+
**Do not contradict pixel-perfect emulation when cloning a rich reference** — this phase *adds* or swaps **idea-native** imagery only where the brief allows uplift or the reference was inherently flat.
|
|
488
488
|
|
|
489
|
-
Checklist (mirror `AGENTS.md`):
|
|
489
|
+
Checklist (mirror `AGENTS.md` — **uniqueness first**):
|
|
490
490
|
|
|
491
|
-
1. **
|
|
492
|
-
2. **
|
|
493
|
-
3. **
|
|
491
|
+
1. **Idea-tailored imagery** — Metaphor list from `idea`; replace any asset that could belong to another vertical. Per-asset **Idea tie-in** in `docs/research/PRODUCTION_UPLIFT.md` alongside SVG/raster paths.
|
|
492
|
+
2. **Density** — Layered hero + distinct scene per feature card in **one shared visual language** (stroke/accent/grid), still idea-specific.
|
|
493
|
+
3. **Motion tiers** — Implement at minimum **A + B + one of C/D**, optionally **E**: staggered hero load, `whileInView` sections + card stagger, looping ambient (marquee / caret / SVG dash loop), hover lifts / nav scroll shrink, optional light parallax. Gate loops with **`useReducedMotion()`**.
|
|
494
|
+
4. **Brand** — Motif thread + accent tokens in `:root`; favicon / OG echo **this** product narrative.
|
|
494
495
|
|
|
495
|
-
Document deltas in `docs/research/PRODUCTION_UPLIFT.md
|
|
496
|
-
|
|
497
|
-
Invoke `.claude/skills/marketing-landing-production/SKILL.md` as a focused playbook for this pass.
|
|
496
|
+
Document deltas in `docs/research/PRODUCTION_UPLIFT.md`.
|
|
498
497
|
|
|
499
498
|
## Phase 5: Visual QA Diff
|
|
500
499
|
|
|
@@ -525,7 +524,7 @@ Before dispatching ANY builder agent, verify you can check every box. If you can
|
|
|
525
524
|
- [ ] All images in the section are identified (including overlays and layered compositions)
|
|
526
525
|
- [ ] Any `<video>` (and poster), Lottie, or canvas-driven hero is identified — not approximated as a static div
|
|
527
526
|
- [ ] **Motion** subsection filled: tiers **A–E** coverage (see `AGENTS.md`), CSS vs **framer-motion**, durations, easings, stagger, scroll triggers, **reduced-motion** fallback
|
|
528
|
-
- [ ] **Illustration** subsection filled when uplift applies:
|
|
527
|
+
- [ ] **Illustration** subsection filled when uplift applies: **Idea tie-in** + metaphor link per asset, SVG/pixel detail — or explicit **N/A** with justification only on strict clone parity jobs
|
|
529
528
|
- [ ] Responsive behavior is documented for at least desktop and mobile
|
|
530
529
|
- [ ] Text content is verbatim from the site, not paraphrased
|
|
531
530
|
- [ ] The builder prompt is under ~150 lines of spec; if over, the section needs to be split
|
|
@@ -548,6 +547,7 @@ These are lessons from previous failed clones — each one cost hours of rework:
|
|
|
548
547
|
- **Don't bundle unrelated sections into one agent.** A CTA section and a footer are different components with different designs — don't hand them both to one agent and hope for the best.
|
|
549
548
|
- **Don't skip responsive extraction.** If you only inspect at desktop width, the clone will break at tablet and mobile. Test at 1440, 768, and 390 during extraction.
|
|
550
549
|
- **Don't forget smooth scroll libraries.** Check for Lenis (`.lenis` class), Locomotive Scroll, or similar. Default browser scrolling feels noticeably different and the user will spot it immediately.
|
|
550
|
+
- **Don't ship interchangeable marketing art.** Random objects, unrelated lifestyle stock, or generic gradients that could match any SaaS violate the **idea-tailored** rule in `AGENTS.md` — every major visual needs a metaphor from `launchframe.config.json#idea`.
|
|
551
551
|
- **Don't dispatch builders without a spec file.** The spec file forces exhaustive extraction and creates an auditable artifact. Skipping it means the builder gets whatever you can fit in a prompt from memory.
|
|
552
552
|
|
|
553
553
|
## Completion
|
|
@@ -40,15 +40,25 @@ Treat these as **first-class deliverables**, not polish at the end.
|
|
|
40
40
|
2. **Motion** — Match the target’s feel: easing, duration, stagger, scroll triggers. Prefer **`motion` from `framer-motion`** for entrance sequences, viewport-driven animations, shared-layout-style transitions, and anything beyond a one-off CSS transition. Note in each component spec whether behavior is **CSS-only** vs **Framer Motion**.
|
|
41
41
|
3. **Illustration & brand marks** — Inline **SVG React components** (not only Lucide) for motifs that repeat across sections: logo glyph variants, dividers, grain/noise overlays, hero “scene” shapes, feature-card mini-compositions. Prefer **`currentColor`** + CSS variables so SVGs inherit theme tokens. For **pixel art**, keep a tight palette (4–8 fills), consistent pixel grid logic, and use `style={{ imageRendering: "pixelated" }}` on upscaled raster OR build pixel SVG paths intentionally — never blurry upscale.
|
|
42
42
|
|
|
43
|
-
## Production polish for marketing landings *(
|
|
43
|
+
## Production polish for marketing landings *(idea-tailored visuals + motion + brand)*
|
|
44
44
|
|
|
45
|
-
Use this whenever the page is **authored or minimalist** (internal templates, rebranded clones that still feel flat, or targets that are mostly typography). “Looks OK” is not ship-ready — **production landings** stack multiple visual layers, choreographed motion, and
|
|
45
|
+
Use this whenever the page is **authored or minimalist** (internal templates, rebranded clones that still feel flat, or targets that are mostly typography). “Looks OK” is not ship-ready — **production landings** stack multiple visual layers, choreographed motion, and cues that clearly belong to **this** product (`launchframe.config.json#idea`), not any SaaS.
|
|
46
|
+
|
|
47
|
+
### Idea-tailored imagery *(uniqueness bar)*
|
|
48
|
+
|
|
49
|
+
Generic decoration fails review. Apply this to **every** hero composition, feature-card illustration, OG image sketch, and major `public/` marketing raster.
|
|
50
|
+
|
|
51
|
+
1. **Derive metaphors from the idea** — Read `idea` (and product name). List 3–6 concrete nouns/verbs the product owns (e.g. voice → waveform, mic; notes → folded page, margin line; sync → paired arrows). Every bespoke visual must trace back to that list — **not** interchangeable clipart (random apparel, unrelated lifestyle objects, vague “business” silhouettes unless the idea demands them).
|
|
52
|
+
2. **Could this ship on another site unchanged?** If yes, redesign until **no** — different silhouette story, palette accent, or composition so the asset “only fits” this narrative.
|
|
53
|
+
3. **One tie-in sentence per asset** — In specs or `docs/research/REBRAND.md`, each image/SVG scene gets **Idea tie-in:** `<why this belongs to this product>`.
|
|
54
|
+
4. **Prefer authored scenes** — Custom SVG narratives (several shapes telling one moment), optional pixel mascot **on-brand** for the category, or composed raster under `public/images/marketing/` when illustration needs texture. Lucide-only piles and neutral blobs are **last resort**, not default.
|
|
55
|
+
5. **Distinct accents** — Pick accent hues/shapes suggested by the idea’s personality (precise studio vs warm companion vs rugged utility); avoid default gray-only SaaS anonymity unless the brief is explicitly brutalist.
|
|
46
56
|
|
|
47
57
|
### Imagery density (every fold earns a visual idea)
|
|
48
58
|
|
|
49
|
-
- **Hero** — Never headline-only on white: add at least two of — soft gradient mesh / radial spotlight,
|
|
50
|
-
- **Between sections** — Optional
|
|
51
|
-
- **Feature rows** —
|
|
59
|
+
- **Hero** — Never headline-only on white: add at least two of — soft gradient mesh / radial spotlight, **idea-specific** SVG cluster (metaphors from the list above), notebook/grid lines when the idea is docs, waveform device frame when the idea is capture, masked **purpose-built** raster in `public/images/marketing/`, geometric frame echoing **this** logo shape.
|
|
60
|
+
- **Between sections** — Optional dividers whose pattern/stroke **echoes the product motif** (not a stock wave).
|
|
61
|
+
- **Feature rows** — Each card illustration is a **different** moment in the same visual language (shared stroke weight, accent, or grid) — all still **idea-native** (e.g. capture → transcript lines; workspace → shared cursors; publish → export channels). No unrelated filler.
|
|
52
62
|
- **Social proof** — Logo strip may use grayscale marks; add **slow infinite marquee** or gentle opacity drift — motion sells “living product.”
|
|
53
63
|
|
|
54
64
|
### Motion choreography *(ship several layers; respect `prefers-reduced-motion`)*
|
|
@@ -80,9 +90,7 @@ Always gate looping motion: **`useReducedMotion()`** from Framer Motion — swap
|
|
|
80
90
|
|
|
81
91
|
### Spec requirement *(hand-off quality)*
|
|
82
92
|
|
|
83
|
-
When writing `docs/research/components/*.spec.md`, add sections **Illustration** (layers, SVG components, raster paths) and expand **Motion** with tier **A–E** coverage and reduced-motion fallback. Builders should not invent motion ad hoc — the spec states durations and triggers.
|
|
84
|
-
|
|
85
|
-
Invoke **`marketing-landing-production`** (`.claude/skills/marketing-landing-production/SKILL.md`) when the user asks for **prod-ready polish**, **more motion**, **SVG/pixel art**, or **stronger branding** on an existing landing.
|
|
93
|
+
When writing `docs/research/components/*.spec.md`, add sections **Illustration** (**Idea tie-in** per asset, layers, SVG components, raster paths) and expand **Motion** with tier **A–E** coverage and reduced-motion fallback. Builders should not invent motion ad hoc — the spec states durations and triggers.
|
|
86
94
|
|
|
87
95
|
## Commands
|
|
88
96
|
- `npm run dev` — Start dev server
|
|
@@ -112,7 +120,8 @@ Prefer **Playwright** for repeatable extraction in-repo — do **not** rely on C
|
|
|
112
120
|
## Design Principles
|
|
113
121
|
- **Images & video fidelity** — prefer real downloaded assets; preserve aspect ratio, `object-fit`, layering, and poster frames. Rebrand pass may **swap** URLs for IP-safe alternates but must keep layout identical.
|
|
114
122
|
- **Motion fidelity** — timing and easing matter as much as color; use Framer Motion when CSS alone cannot match staggered or scroll-driven behavior.
|
|
115
|
-
- **
|
|
123
|
+
- **Idea-specific imagery** — Marketing art (SVG, raster, OG) must be **tailored to `launchframe.config.json#idea`**: explicit metaphors, per-asset **Idea tie-in** notes, and **no interchangeable filler** that could belong to any generic SaaS.
|
|
124
|
+
- **Production landing density** — For authored/minimal pages, deliberately add **idea-specific** illustration (not generic SaaS filler), **pixel-art accents** when they reinforce the metaphor, and **tiered motion (A–E)** per “Production polish” above; static monochrome layouts are incomplete unless the user explicitly wants extreme minimalism.
|
|
116
125
|
- **Pixel-perfect emulation** — match the target's spacing, colors, typography exactly
|
|
117
126
|
- **No personal aesthetic changes during emulation phase** — match 1:1 first, rebrand later
|
|
118
127
|
- **Real content during extraction** — use actual text and assets from the target site so the clone scaffolds against real shapes
|
|
@@ -146,7 +155,6 @@ scripts/ # Asset download scripts
|
|
|
146
155
|
- When launching Claude Code agent teams, ALWAYS have each teammate work in their own worktree branch and merge everyone's work at the end, resolving any merge conflicts smartly since you are basically serving the orchestrator role and have full context to our goals, work given, work achieved, and desired outcomes.
|
|
147
156
|
- After editing `AGENTS.md`, run `bash scripts/sync-agent-rules.sh` to regenerate platform-specific instruction files.
|
|
148
157
|
- After editing `.claude/skills/clone-website/SKILL.md`, run `node scripts/sync-skills.mjs` to regenerate the skill for all platforms.
|
|
149
|
-
- After editing `.claude/skills/marketing-landing-production/SKILL.md`, update `.cursor/commands/marketing-landing-production.md` to match (Cursor command is maintained beside the Claude skill until sync-skills grows multi-skill support).
|
|
150
158
|
|
|
151
159
|
# Website Inspection Guide
|
|
152
160
|
|
|
@@ -173,17 +181,19 @@ If automation hits a bot wall, **do not pretend extraction succeeded** — captu
|
|
|
173
181
|
- [ ] **Gestures** — drag, pan, hover follow (often Framer Motion)
|
|
174
182
|
- [ ] **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.
|
|
175
183
|
|
|
176
|
-
### 3.
|
|
184
|
+
### 3. Idea-tailored illustration & motifs *(production landings)*
|
|
177
185
|
|
|
178
|
-
When the reference page is **sparse** (mostly type + gray boxes) or after a **rebrand** the UI still reads generic,
|
|
186
|
+
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.
|
|
179
187
|
|
|
180
|
-
- [ ] **
|
|
181
|
-
- [ ] **
|
|
182
|
-
- [ ] **
|
|
183
|
-
- [ ] **
|
|
184
|
-
- [ ] **
|
|
188
|
+
- [ ] **Metaphor list** — 3–6 nouns/verbs derived from `idea`; every bespoke asset maps to ≥ one entry
|
|
189
|
+
- [ ] **Uniqueness check** — If the scene works unchanged for another product category, revise
|
|
190
|
+
- [ ] **Inline SVG** — hero shapes, dividers, card mini-scenes; note `viewBox`, **`currentColor`** vs fixed fills, **Idea tie-in** sentence per asset
|
|
191
|
+
- [ ] **Pixel art / sprites** — only when character reinforces the metaphor; palette hex table; `imageRendering` / grid discipline
|
|
192
|
+
- [ ] **Motif thread** — recurring element echoing hero + OG + favicon **for this product**, not a random geometric pattern
|
|
193
|
+
- [ ] **Accent tokens** — primary/secondary roles aligned with idea personality (extract from reference or define in `:root`)
|
|
194
|
+
- [ ] **Motion tiers A–E** — document with **reduced-motion** fallback (`prefers-reduced-motion`)
|
|
185
195
|
|
|
186
|
-
See **`AGENTS.md` → Production polish for marketing landings** for tier definitions and
|
|
196
|
+
See **`AGENTS.md` → Production polish for marketing landings** for tier definitions and folders (`src/components/marketing/art/`, `public/images/marketing/`).
|
|
187
197
|
|
|
188
198
|
---
|
|
189
199
|
|
|
@@ -39,7 +39,7 @@ If the user provides additional instructions (specific fidelity level, deeper cu
|
|
|
39
39
|
## Pre-Flight
|
|
40
40
|
|
|
41
41
|
1. **Read `launchframe.config.json`** (see Step 0 above). After a fresh `npx launchframe` scaffold, proceed immediately — only echo `url`/`idea` for confirmation if the config looks wrong or the user asked to verify.
|
|
42
|
-
2. **Browser automation.** Prefer an MCP (Chrome DevTools MCP, Playwright MCP, Browserbase MCP, etc.) when it is healthy. **If MCP is missing or in an error state, run `npm run recon` (Playwright)** — see `scripts/recon-playwright.mjs`. It writes
|
|
42
|
+
2. **Browser automation.** Prefer an MCP (Chrome DevTools MCP, Playwright MCP, Browserbase MCP, etc.) when it is healthy. **If MCP is missing or in an error state, run `npm run recon` (Playwright)** — see `scripts/recon-playwright.mjs`. It performs **stabilized full-document scrolling** at desktop and mobile, writes merged **`computed-snapshot.json`** + **`MEDIA_MANIFEST.md`**, and **full-page** screenshots under `docs/design-references/`. Use `npm run recon:headed` if headless hits a WAF/challenge page. One-time install: `npx playwright install chromium`. Do not skip extraction — adapt the pipeline to the tools that work.
|
|
43
43
|
3. Validate the resolved URL(s). Normalize and verify each is accessible via your browser MCP tool. If any are invalid, ask the user to correct `launchframe.config.json` (or pass an override) before proceeding.
|
|
44
44
|
4. Verify the base project builds: `npm run build`. The Next.js + shadcn/ui + Tailwind v4 scaffold should already be in place. If not, tell the user to run `npm install` first.
|
|
45
45
|
5. Create the output directories if they don't exist: `docs/research/`, `docs/research/components/`, `docs/design-references/`, `scripts/`. Plan `docs/research/MEDIA_MANIFEST.md` as soon as media is inventoried. For multiple clones, also prepare per-site folders like `docs/research/<hostname>/` and `docs/design-references/<hostname>/`.
|
|
@@ -55,7 +55,7 @@ These are the truths that separate a successful clone from a "close enough" mess
|
|
|
55
55
|
|
|
56
56
|
**Motion defaults to Framer Motion.** This template lists `framer-motion` as a dependency. After foundation tokens, ensure `import { motion } from "framer-motion"` (and related APIs: `useScroll`, `useTransform`, `AnimatePresence`, `LayoutGroup`, **`useReducedMotion`**) for: scroll-triggered reveals, staggered children, layout transitions, and gestures — anything beyond a trivial one-property CSS `transition`. In each spec file, add a **Motion** subsection: trigger, duration, easing, delay/stagger, **tier A–E coverage** (see `AGENTS.md` production polish table), reduced-motion fallback, and **implementation: CSS | framer-motion**. Prefer CSS only when it matches the target exactly without JS.
|
|
57
57
|
|
|
58
|
-
**Illustration & pixel art are production inputs.** Where the target (or post-rebrand layout) lacks convincing visuals, specs MUST
|
|
58
|
+
**Illustration & pixel art are production inputs.** Where the target (or post-rebrand layout) lacks convincing visuals, specs MUST allocate **idea-tailored SVG scenes** — metaphors drawn from `launchframe.config.json#idea`, documented with **Idea tie-in** per asset — not generic gray placeholders or unrelated clipart. Pixel-art motifs require concept justification plus palette table in the spec.
|
|
59
59
|
|
|
60
60
|
### 1. Completeness Beats Speed
|
|
61
61
|
|
|
@@ -142,10 +142,12 @@ Every builder agent must verify `npx tsc --noEmit` passes before finishing. Afte
|
|
|
142
142
|
|
|
143
143
|
Navigate to the target URL with browser MCP.
|
|
144
144
|
|
|
145
|
-
### Screenshots
|
|
146
|
-
-
|
|
147
|
-
-
|
|
148
|
-
-
|
|
145
|
+
### Screenshots *(entire landing — never “above the fold” only)*
|
|
146
|
+
- Capture the **whole marketing surface**: hero through footer (single-page landings). Do **not** stop after the first viewport — lazy-loaded sections, footer nav, and bottom CTAs are required context.
|
|
147
|
+
- Before **every** full-page capture (MCP or Playwright): **slow scroll top → bottom → top** once or twice until `scrollHeight` stops growing, so lazy images/`srcset`/`data-src` resolve where possible.
|
|
148
|
+
- Take **`fullPage: true`** (or MCP equivalent) screenshots at desktop (**1440px**) and mobile (**390px**); save under `docs/design-references/` with descriptive names.
|
|
149
|
+
- **`npm run recon`** already performs stabilized full-document scrolling + merged desktop/mobile asset inventory — prefer running it when automation must match full-page depth reliably.
|
|
150
|
+
- These masters are references — builders still get section crops later, but those crops must exist because **you** scrolled and documented every band first.
|
|
149
151
|
|
|
150
152
|
### Global Extraction
|
|
151
153
|
Extract these from the page before doing anything else:
|
|
@@ -375,10 +377,12 @@ For each section (or sub-component, if you're breaking it up), create a spec fil
|
|
|
375
377
|
- **Library:** <`framer-motion` | CSS-only — justify if CSS-only>
|
|
376
378
|
- **Keyframes / springs:** <if any — match target curve>
|
|
377
379
|
|
|
378
|
-
## Illustration & pixel art *(production uplift)*
|
|
380
|
+
## Illustration & pixel art *(production uplift — idea-native)*
|
|
381
|
+
- **Idea tie-in:** <one sentence — why this asset belongs only to this product>
|
|
382
|
+
- **Metaphor link:** <which keyword from `idea` / metaphor list this illustrates>
|
|
379
383
|
- **SVG components:** <named exports, paths using currentColor vs fixed fills>
|
|
380
384
|
- **Pixel motif:** <palette hex table, grid, scaling — or N/A>
|
|
381
|
-
- **Motif thread:** <how
|
|
385
|
+
- **Motif thread:** <how this echoes logo / OG / favicon for this SaaS>
|
|
382
386
|
|
|
383
387
|
## Per-State Content (if applicable)
|
|
384
388
|
|
|
@@ -460,11 +464,7 @@ For every section, replace:
|
|
|
460
464
|
3. **Feature/section copy** — rewrite each feature card, callout, stat, and testimonial to fit the SaaS idea. Preserve the count and shape of items (3 feature cards stay 3 feature cards; a 4-column logo bar stays 4 columns). Generate plausible customer-logo names — never use real company names you haven't been authorized to use.
|
|
461
465
|
4. **CTA labels** — adapt button text to the SaaS idea ("Start free", "Get a demo", "Try it free", etc.). Keep the CTA hierarchy (primary/secondary) identical to the original.
|
|
462
466
|
5. **Mock data** — for product UI mockups embedded in marketing screenshots (e.g., a fake dashboard inside a hero), generate mock data shaped for the SaaS idea: realistic-looking but fictional rows, charts, conversation logs, etc.
|
|
463
|
-
6. **Imagery** —
|
|
464
|
-
- A neutral abstract gradient / shape composition you generate with CSS or SVG
|
|
465
|
-
- A Lucide icon arrangement
|
|
466
|
-
- Placeholder service URLs only if explicitly allowed by the user
|
|
467
|
-
Keep dimensions, aspect ratios, drop shadows, and surrounding spacing identical to the original.
|
|
467
|
+
6. **Imagery** — Replace photography/screenshots that depict the original brand with visuals **authored for this SaaS idea**, not interchangeable decoration. Before designing: derive a **metaphor list** from `idea` (3–6 concrete hooks). Each hero/feature/OG asset gets an **Idea tie-in** sentence in `docs/research/REBRAND.md`. Prefer bespoke SVG scenes (`src/components/marketing/art/`) or raster under `public/images/marketing/` that preserve dimensions/aspect/shadows from the cloned layout. **Avoid:** unrelated filler (e.g. apparel, random lifestyle props when the product is notes/voice), generic gradient-only heroes, Lucide-icon piles unless the reference was already that minimal — those fail the uniqueness bar in `AGENTS.md`.
|
|
468
468
|
7. **Metadata** — update `<title>`, meta description, OG tags, and favicon manifest in `src/app/layout.tsx` to reflect the new SaaS. Generate a simple favicon (initial letter on a brand-colored square) if no asset is provided.
|
|
469
469
|
|
|
470
470
|
What you must NOT change in this pass:
|
|
@@ -475,25 +475,24 @@ What you must NOT change in this pass:
|
|
|
475
475
|
|
|
476
476
|
After the rebrand pass, the codebase should look like the original site visually but read like the user's SaaS at a glance. Save a short `docs/research/REBRAND.md` summarizing the product name you chose, the headline rewrites, and any assets you swapped — so the user can audit what's clone-derived vs. authored.
|
|
477
477
|
|
|
478
|
-
## Phase 4.6: Production uplift *(sparse references /
|
|
478
|
+
## Phase 4.6: Production uplift *(sparse references / stronger idea-specific art)*
|
|
479
479
|
|
|
480
480
|
Run this pass when **any** of the following is true:
|
|
481
481
|
|
|
482
482
|
- The cloned reference is mostly typography with weak imagery (internal demos, minimalist SaaS shells).
|
|
483
|
-
- The user asks for **more
|
|
484
|
-
- Visual QA feels “correct but dead” — layout matches but
|
|
483
|
+
- The user asks for **more unique images**, **illustration tailored to the idea**, **stronger visuals**, motion, pixel art, or production polish.
|
|
484
|
+
- Visual QA feels “correct but dead” — layout matches but art is generic, unrelated, or repeated stock metaphors.
|
|
485
485
|
|
|
486
|
-
**Do not contradict pixel-perfect emulation when cloning a rich reference** — this phase *adds*
|
|
486
|
+
**Do not contradict pixel-perfect emulation when cloning a rich reference** — this phase *adds* or swaps **idea-native** imagery only where the brief allows uplift or the reference was inherently flat.
|
|
487
487
|
|
|
488
|
-
Checklist (mirror `AGENTS.md`):
|
|
488
|
+
Checklist (mirror `AGENTS.md` — **uniqueness first**):
|
|
489
489
|
|
|
490
|
-
1. **
|
|
491
|
-
2. **
|
|
492
|
-
3. **
|
|
490
|
+
1. **Idea-tailored imagery** — Metaphor list from `idea`; replace any asset that could belong to another vertical. Per-asset **Idea tie-in** in `docs/research/PRODUCTION_UPLIFT.md` alongside SVG/raster paths.
|
|
491
|
+
2. **Density** — Layered hero + distinct scene per feature card in **one shared visual language** (stroke/accent/grid), still idea-specific.
|
|
492
|
+
3. **Motion tiers** — Implement at minimum **A + B + one of C/D**, optionally **E**: staggered hero load, `whileInView` sections + card stagger, looping ambient (marquee / caret / SVG dash loop), hover lifts / nav scroll shrink, optional light parallax. Gate loops with **`useReducedMotion()`**.
|
|
493
|
+
4. **Brand** — Motif thread + accent tokens in `:root`; favicon / OG echo **this** product narrative.
|
|
493
494
|
|
|
494
|
-
Document deltas in `docs/research/PRODUCTION_UPLIFT.md
|
|
495
|
-
|
|
496
|
-
Invoke `.claude/skills/marketing-landing-production/SKILL.md` as a focused playbook for this pass.
|
|
495
|
+
Document deltas in `docs/research/PRODUCTION_UPLIFT.md`.
|
|
497
496
|
|
|
498
497
|
## Phase 5: Visual QA Diff
|
|
499
498
|
|
|
@@ -524,7 +523,7 @@ Before dispatching ANY builder agent, verify you can check every box. If you can
|
|
|
524
523
|
- [ ] All images in the section are identified (including overlays and layered compositions)
|
|
525
524
|
- [ ] Any `<video>` (and poster), Lottie, or canvas-driven hero is identified — not approximated as a static div
|
|
526
525
|
- [ ] **Motion** subsection filled: tiers **A–E** coverage (see `AGENTS.md`), CSS vs **framer-motion**, durations, easings, stagger, scroll triggers, **reduced-motion** fallback
|
|
527
|
-
- [ ] **Illustration** subsection filled when uplift applies:
|
|
526
|
+
- [ ] **Illustration** subsection filled when uplift applies: **Idea tie-in** + metaphor link per asset, SVG/pixel detail — or explicit **N/A** with justification only on strict clone parity jobs
|
|
528
527
|
- [ ] Responsive behavior is documented for at least desktop and mobile
|
|
529
528
|
- [ ] Text content is verbatim from the site, not paraphrased
|
|
530
529
|
- [ ] The builder prompt is under ~150 lines of spec; if over, the section needs to be split
|
|
@@ -547,6 +546,7 @@ These are lessons from previous failed clones — each one cost hours of rework:
|
|
|
547
546
|
- **Don't bundle unrelated sections into one agent.** A CTA section and a footer are different components with different designs — don't hand them both to one agent and hope for the best.
|
|
548
547
|
- **Don't skip responsive extraction.** If you only inspect at desktop width, the clone will break at tablet and mobile. Test at 1440, 768, and 390 during extraction.
|
|
549
548
|
- **Don't forget smooth scroll libraries.** Check for Lenis (`.lenis` class), Locomotive Scroll, or similar. Default browser scrolling feels noticeably different and the user will spot it immediately.
|
|
549
|
+
- **Don't ship interchangeable marketing art.** Random objects, unrelated lifestyle stock, or generic gradients that could match any SaaS violate the **idea-tailored** rule in `AGENTS.md` — every major visual needs a metaphor from `launchframe.config.json#idea`.
|
|
550
550
|
- **Don't dispatch builders without a spec file.** The spec file forces exhaustive extraction and creates an auditable artifact. Skipping it means the builder gets whatever you can fit in a prompt from memory.
|
|
551
551
|
|
|
552
552
|
## Completion
|