docs: surface the install-with-AI prompt on the iOS install page, refresh Meta Ads screenshot

[DreamingInBinary]

Two unrelated docs changes, split into commits.

1. Install-with-AI prompt on the iOS install page

The one-line agent prompt (Install Superwall into my app using the skill at github.com/superwall/skills) only lived in the INSTALL WITH AI section of the superwall.com homepage. Anyone landing straight on the install page from search, a shared link, or the sidebar never saw it and started hand-rolling SPM/CocoaPods steps.

This came from customer feedback. They only knew the prompt existed because they'd browsed the homepage days earlier, hit enough friction during setup to abandon the install, and told us so.

• Adds src/components/InstallWithAI.tsx, registered globally so any SDK install page can drop it in with one line.
• A platform prop keeps the prompt specific: iOS renders "into my iOS app" rather than the homepage's generic "my app".
• Reuses the repo's existing useCopyButton hook and GridIcon rather than a bespoke copy button.
• Wired into iOS only for now. Android, Flutter, Expo, KMP, Unity, and Web have the same gap and are a trivial follow-up once the wording settles.

One thing worth a reviewer's eye: the line "Prefer to do it by hand? The steps are below" is mine, not the homepage's. It's there to keep the block from reading as though the manual path is being deprecated.

2. Meta Ads screenshots refreshed for install.link

The generated ad link moved to install.link and the page copy was updated, but the screenshots still showed mmp.superwall.com. I audited all nine mmp_* images on the page rather than only the obvious ones; three were stale and are now replaced, each resized to 2000px wide per the repo image rule.

Image	Step	Change
mmp_meta_events_to_send	3	replaced (2000x1291)
mmp_meta_ad_links	4	replaced (2000x1222, dimensions unchanged)
mmp_meta_ad_website_url	5	replaced (2000x1163, was 2000x1918)

The remaining six (mmp_performance_marketing_section, mmp_meta_dataset_token, mmp_meta_events_confirmed, mmp_meta_campaign_objective, mmp_meta_adset_conversion, mmp_advertising_chart_section) contain no ad link and needed no change. No other docs page carries MMP screenshots.

The Step 3 one was the easiest to miss: its alt text describes the "Events to send" card, but the capture extends far enough down the page to include the Ads links section underneath, where the old domain was still visible.

The page copy was already clean; mmp.superwall.com appears nowhere in content/. Only the images lagged.

Two notes for the reviewer

Step 5 shows a different link shape than Steps 3 and 4. Steps 3 and 4 both show https://install.link/link/pk_... (with /link/); Step 5 shows https://install.link/pk_... (without). The copy only ever references the bare install.link domain for the allow list, so nothing in the docs contradicts either, but it's worth confirming which is current.

Unrelated product/docs mismatch, not fixed here. The docs tell people to allow-list install.link (lines 101 and 244). The dashboard's own instructional text, visible in mmp_meta_dataset_token.jpg and in the fresh Step 3 capture, says "Type the domain superwall.com and add it to the allow list." That's current product copy rather than a stale screenshot, so one of the two is wrong. It gates whether Meta accepts the traffic, so probably worth a paywall-next fix.

Verification

• Copy button copies exactly Install Superwall into my iOS app using the skill at github.com/superwall/skills, confirmed by intercepting clipboard.writeText rather than by eye. Button flips to "Copied".
• Caught mid-build: a raw <a> rendered /dashboard/guides/superwall-skill without the /docs basePath and would have 404'd. Now routed through normalizeDocsInternalHref + TanStack Link, matching <Card>, and resolving to /docs/dashboard/guides/superwall-skill.
• Renders correctly in both light and dark. At 375px the prompt wraps with no horizontal overflow.
• All nine images confirmed serving at their expected dimensions on the running page.
• bun test 64/64. oxlint 0 errors, no new warnings.
• bun run build:cf green, all pages prerendered, search index written.
• types:check reports 256 errors, but clean main reports the identical 256. None are new. Pre-existing debt worth its own pass.

Rebased onto current main (#173).

🤖 Generated with Claude Code

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	superwall-docs	340512f	Commit Preview URL Branch Preview URL	Aug 26 2026, 07:33 PM