Sharpen homepage above-the-fold copy and CTA hierarchy#1028
Merged
Conversation
Apply page-cro + marketing-psychology to the homepage hero so the
value prop, audience and primary action are clear within 5 seconds.
- Header: drop the decorative script wordmark and the "Scroll down…"
microline; promote the page title to a real <h1>. Apply across
index, for-teams, terms and privacy for consistency.
- Homepage H1: "The iOS Simulator companion for developers and AI
coding agents."
- Subhead: "RocketSim lets you inspect, test, and debug your app in
the Simulator — without breaking your flow in Xcode, Codex, or
Cursor." (bold mid-sentence, matches existing white emphasis).
- Primary CTA: "Free download" (leverages the Zero-Price Effect).
- Drop the "For Teams →" hero link to give one clear secondary CTA
("Explore features →") and reduce choice paralysis (Hick's Law).
- Add a value-prop microline under the CTAs via a new optional
`microcopy` prop on Navigation: "Get started for free, no signup.
Works with Xcode 16+."
This PR is copy-only: no layout changes, no new components, App
Store install tracking and UTM-rewrite script untouched. The
social-proof restructure (authority strip + trusted-brands logos)
ships in a follow-up PR.
10 tasks
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the docs-site homepage hero (above-the-fold) messaging and CTA hierarchy to better communicate RocketSim’s audience/value and reduce choice overload, with small supporting changes to the shared Header/Navigation components to match the new copy structure.
Changes:
- Replaces the homepage hero title/subhead copy and updates the primary CTA text (“Free download”), removing the “For Teams” hero link.
- Simplifies
Header.astroby removinglogo/logoAlt/scrollTextprops and renderingtitleas a real<h1>. - Adds an optional
microcopyprop toNavigation.astroand uses it on the homepage hero.
Reviewed changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| docs/src/pages/index.astro | Updates hero copy, CTA label, removes extra hero link, and adds navigation microcopy. |
| docs/src/pages/for-teams.astro | Updates Header usage to match the new signature (copy unchanged). |
| docs/src/pages/privacy.astro | Updates Header usage to match the new signature (copy unchanged). |
| docs/src/pages/terms.astro | Updates Header usage to match the new signature (copy unchanged). |
| docs/src/old/components/Navigation.astro | Adds microcopy prop and renders it beneath/alongside hero nav links. |
| docs/src/old/components/Header.astro | Removes logo/scroll text props and changes hero title to <h1>{title}</h1>. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
89
to
96
| <slot /> | ||
| </ul> | ||
| {microcopy && <p class="navigation__microcopy">{microcopy}</p>} | ||
| </nav> |
Owner
Author
There was a problem hiding this comment.
Good catch on both points. Fixed in e5c0dfc:
- The microcopy
<p>now lives outside the<nav aria-label="Hero navigation">landmark, so assistive tech navigating by landmark no longer surfaces non-navigation text alongside the CTA links. - Both the
<nav>and the microcopy are wrapped in a new.navigation__primarycontainer. The wrapper takes thegrid-column: 1 / -2placement and on(min-width: 800px)becomesflex-direction: column, so the microcopy stacks below the CTAs visually as intended.
Address Copilot review feedback on PR 1028: the microcopy paragraph was rendered inside the <nav aria-label="Hero navigation"> landmark, so screen readers navigating by landmark surfaced non-navigation text alongside the CTA links. With (min-width: 800px) the nav was also a flex row, so the paragraph sat beside the link list instead of beneath it. Introduce a .navigation__primary wrapper around the <nav> and the microcopy <p>. The wrapper now takes the grid-column placement and the flex-column layout on desktop, so the microcopy stacks below the CTA list visually, while the <nav> landmark only wraps the link list.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
PR 1 of 2 applying page-cro + marketing-psychology to the homepage above-the-fold. Copy-only — no layout changes, no new components. The social-proof restructure ships in PR 2.
What changes above the fold
Mental models applied
Files
+ "docs/src/old/components/Header.astro" +— drop+ "logo" +/+ "logoAlt" +/+ "scrollText" +props, render+ "title" +as a real+ "" +.+ "docs/src/old/components/Navigation.astro" +— new optional+ "microcopy" +prop, renders the existing (previously orphan)+ ".navigation__microcopy" +class.+ "docs/src/pages/index.astro" +— all the homepage copy + CTA changes.+ "docs/src/pages/for-teams.astro" +,+ "docs/src/pages/terms.astro" +,+ "docs/src/pages/privacy.astro" +— drop the now-removed+ "logo" +/+ "logoAlt" +/+ "scrollText" +props to keep the Header signature consistent. Copy on these pages is unchanged.App Store install tracking (Plausible event names, UTM-rewrite script,
+ "rel="noopener"" +) is untouched.Test plan
+ "Free download" +++ "Explore features →" +→ microcopy.+ "/for-teams" +,+ "/terms" +,+ "/privacy" +render correctly with the new title-only Header (no wordmark, no scroll line).+ "Free download" +button still fires the+ "App+Store+Install" +Plausible event and the UTM-rewriting script still rewrites+ "#js-header-app-store-button" +on load.+ "npm run lint && npm run format:check && npm run typecheck && npm run build" +all pass.Out of scope (PR 2)
+ "AppStore.astro" +into a slim authority strip with honest numbers (★4.8 · Apple Featured · 25K+ developers · 250+ teams).+ "TrustedBrands" +logo strip to the homepage with an optional homepage-specific title.PR 2 will target this branch so both can be tested locally in one go.