feat(marketing): redesign website and product showcase

[maria-rcks]

What Changed

• Redesigned the marketing homepage around the simpler visual system, shared atmospheric hero treatment, and updated product showcase.
• Reworked the download page with a cleaner release-channel switch, ordered platform rows, mobile store links, and official store artwork.
• Simplified the privacy and security pages to match the homepage, including quieter typography, white bullets, and streamlined navigation.
• Added deterministic web-demo fixtures and screenshot tooling for marketing assets, along with mobile documentation and refreshed Open Graph imagery.
• Linked the iOS and Android downloads directly from the README introduction, incorporating the README treatment from docs: link iOS and Android app store downloads #4902 alongside the dedicated mobile-app section.

Why

The marketing and legal surfaces had diverged visually, while the download experience mixed oversized store actions, icon-heavy release controls, and inconsistent page chrome. This brings those surfaces into one restrained design system and makes the product itself the focus.

UI Changes

Each comparison uses the same 1440 × 900 viewport and a slow, eased full-page scroll. “Before” is the current live t3.codes page; “After” is this redesign.

Page	Before	After
Homepage	old-home.webm	new-home.webm
Download	old-download.webm	new-download.webm
Privacy	old-privacy.webm	new-privacy.webm
Security	old-security.webm	new-security.webm

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes
• I included a video for animation/interaction changes

Validation:

• pnpm --filter @t3tools/marketing typecheck
• pnpm --filter @t3tools/web typecheck
• pnpm --filter @t3tools/web test -- src/branding.test.ts (186 files, 1,666 tests)
• pnpm exec vitest run apps/marketing/src/lib/releases.test.ts (2 tests)

Built with GPT-5.6 Sol via the T3 Code Codex harness.

---

Note

Medium Risk
Large marketing surface area and a workflow that pushes commits to the default branch with release-app credentials; marketing builds now depend on Chromium/Playwright and the web sidebar-demo build, increasing CI and local build time and failure modes.

Overview
Redesigns the marketing site around a shared layout with release-channel switching (Latest / Nightly / Dev), platform-aware behavior, Open Graph metadata, and a refreshed nav/footer.

The download page gains channel-specific GitHub release resolution (including nightly selection and macOS arch-aware asset URLs), a Dev “build from source” path, and clearer mobile store links. Legal pages can use a simplified layout without the on-page section nav.

Asset pipeline:dev/build now run the web sidebar demo build plus a Playwright capture script that produces feature crops and a WebGL-composited og-image.png. A CI job on the default branch copies dark mobile showcase screenshots into apps/marketing/public/mobile-states and auto-commits when they change.

README adds mobile app links and a mobile-app doc entry; store logos and mobile preview metadata are added under public/.

^{Reviewed by Cursor Bugbot for commit 47a4777. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Redesign marketing website with stage-aware downloads, live demo embed, and mobile app showcase

• Rebuilds the homepage (index.astro) with a live interactive demo iframe, a dynamic hero section, a new Remote+mobile section with iOS/Android store links, an FAQ section, and a redesigned CTA; removes the old harnesses/Git/open-source sections.
• Adds a release channel picker (Latest/Nightly/Dev) to the download page and homepage; download buttons resolve platform-specific asset URLs or copy a git clone command in Dev stage; selections persist via localStorage and sync across the page via a t3-marketing-stage-change custom event.
• Overhauls Layout.astro with Open Graph/Twitter/canonical metadata, stage-aware favicons, a layered blur nav, an expanded three-column footer, and an inline script that sets data-stage/data-platform on <html> at load time.
• Adds fetchNightlyRelease, findReleaseAssetUrl, selectNightlyRelease, and a 5-minute session cache to releases.ts to support nightly asset resolution.
• Introduces a standalone sidebar demo build (vite.demo.config.ts) that emits into marketing/public/sidebar-demo, a Playwright screenshot capture script, and a CI workflow step that auto-publishes mobile screenshots to the repo.
• Adds mobile app links to the Connections settings panel and user documentation.
• Risk: dev and build scripts now run build:sidebar-demo and Playwright screenshot capture before Astro, increasing build time and adding a Playwright dependency.

📊 Macroscope summarized 47a4777. 37 files reviewed, 0 issues evaluated, 0 issues filtered, 0 comments posted

🗂️ Filtered Issues

No issues evaluated.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 33e670f6-8118-4cf1-b840-009f61ddca2a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[t3-code]

maria confirmed this redesign already covers the app-store work in #4902: the shared store URLs, README mobile links, and mobile download section. #4902 should not be merged separately.

[macroscopeapp]

Approvability

Verdict: Needs human review

5 blocking correctness issues found. Diff is too large for automated approval analysis. A human reviewer should evaluate this PR.

^{You can customize Macroscope's approvability policy. Learn more.}

[macroscopeapp]

Reviewed the new Effect code in apps/web/src/demo/* (in-browser demo RPC backend, layers, fixtures, seeding) plus the touched web/marketing TypeScript against the Effect service conventions.

Namespace subpath imports, layer composition, WsRpcGroup.toLayer handler wiring, and the Effect.runFork(Layer.launch(...)) application boundary all look consistent with the conventions. One finding on error modeling at the dispatch boundary in apps/web/src/demo/server.ts.

^{Posted via Macroscope — Effect Service Conventions}

[StiensWout]

looking good! I like the style :)

[macroscopeapp]

🟡 Mediumlib/showcase-spec.json:15

All four showcase help links lead to invalid documentation targets: the encyclopedia.md and source-control-providers.md paths 404, while keybindings.md#defaults lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the href values to existing documentation paths and anchors, such as docs/user/source-control.md, or add the referenced pages.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/marketing/src/lib/showcase-spec.json around line 15:
All four showcase help links lead to invalid documentation targets: the `encyclopedia.md` and `source-control-providers.md` paths 404, while `keybindings.md#defaults` lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the `href` values to existing documentation paths and anchors, such as `docs/user/source-control.md`, or add the referenced pages.

[macroscopeapp]

🟡 Mediumdemo/fixtures.ts:680

DEMO_COMPOSER_DIFF is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares -6 +9 but contains -3 +6 lines, the second declares -7 +16 but contains -2 +12, and the DropOverlay.tsx hunk declares +11 but contains +7; update the hunk counts or add the missing fixture lines.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/fixtures.ts around line 680:
`DEMO_COMPOSER_DIFF` is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares `-6 +9` but contains `-3 +6` lines, the second declares `-7 +16` but contains `-2 +12`, and the `DropOverlay.tsx` hunk declares `+11` but contains `+7`; update the hunk counts or add the missing fixture lines.

[macroscopeapp]

🟡 Mediumdemo/main.tsx:56

The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe Window during capture, before this document listener is reached; register the handler on window instead so it runs at the window phase.

- document.addEventListener(+ window.addEventListener(

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/main.tsx around line 56:
The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe `Window` during capture, before this `document` listener is reached; register the handler on `window` instead so it runs at the window phase.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:82

Overlapping runs can commit stale screenshots and source.json to the default branch, regressing a newer preview. publish_marketing_preview checks out the branch after capture but never verifies that github.sha is still current, and git pull --rebase can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 82:
Overlapping runs can commit stale screenshots and `source.json` to the default branch, regressing a newer preview. `publish_marketing_preview` checks out the branch after capture but never verifies that `github.sha` is still current, and `git pull --rebase` can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:150

The publisher leaves threads-light.png and the four ios-*-light.png assets stale, so light-color-scheme visitors see outdated screenshots after a default appearance: both capture. preview_sources includes only dark paths; add the corresponding light mappings so both halves are refreshed.

 ["ios-environments.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/dark/environments.png"
+ ["threads-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/threads.png"+ ["ios-thread-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/thread.png"+ ["ios-terminal-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/terminal.png"+ ["ios-review-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/review.png"+ ["ios-environments-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/environments.png"

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 150:
The publisher leaves `threads-light.png` and the four `ios-*-light.png` assets stale, so light-color-scheme visitors see outdated screenshots after a default `appearance: both` capture. `preview_sources` includes only `dark` paths; add the corresponding `light` mappings so both halves are refreshed.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Demo wheel hijacks inner scrolling

Medium Severity

The homepage attaches a capture-phase wheel listener on the demo iframe window that always calls preventDefault and stopImmediatePropagation, then scrolls the outer page. That runs before the demo’s own wheel handler, so sidebar, thread, and other inner surfaces never receive trackpad or mouse wheel input in the embedded hero.

Additional Locations (1)

• apps/web/src/demo/main.tsx#L50-L71

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Publish job skips light screenshots

Low Severity

publish_marketing_preview runs for dark and default both captures, but it only copies .../dark/... files into mobile-states. The homepage serves matching *-light.png assets in light mode, and those files are never refreshed by this job.

Additional Locations (1)

• .github/workflows/mobile-showcase-screenshots.yml#L83-L90

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[maria-rcks]

What Changed

• Redesigned the marketing homepage around the simpler visual system, shared atmospheric hero treatment, and updated product showcase.
• Reworked the download page with a cleaner release-channel switch, ordered platform rows, mobile store links, and official store artwork.
• Simplified the privacy and security pages to match the homepage, including quieter typography, white bullets, and streamlined navigation.
• Added deterministic web-demo fixtures and screenshot tooling for marketing assets, along with mobile documentation and refreshed Open Graph imagery.
• Linked the iOS and Android downloads directly from the README introduction, incorporating the README treatment from docs: link iOS and Android app store downloads #4902 alongside the dedicated mobile-app section.

Why

The marketing and legal surfaces had diverged visually, while the download experience mixed oversized store actions, icon-heavy release controls, and inconsistent page chrome. This brings those surfaces into one restrained design system and makes the product itself the focus.

UI Changes

Each comparison uses the same 1440 × 900 viewport and a slow, eased full-page scroll. “Before” is the current live t3.codes page; “After” is this redesign.

Page	Before	After
Homepage	old-home.webm	new-home.webm
Download	old-download.webm	new-download.webm
Privacy	old-privacy.webm	new-privacy.webm
Security	old-security.webm	new-security.webm

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes
• I included a video for animation/interaction changes

Validation:

• pnpm --filter @t3tools/marketing typecheck
• pnpm --filter @t3tools/web typecheck
• pnpm --filter @t3tools/web test -- src/branding.test.ts (186 files, 1,666 tests)
• pnpm exec vitest run apps/marketing/src/lib/releases.test.ts (2 tests)

Built with GPT-5.6 Sol via the T3 Code Codex harness.

---

Note

Medium Risk
Large marketing surface area and a workflow that pushes commits to the default branch with release-app credentials; marketing builds now depend on Chromium/Playwright and the web sidebar-demo build, increasing CI and local build time and failure modes.

Overview
Redesigns the marketing site around a shared layout with release-channel switching (Latest / Nightly / Dev), platform-aware behavior, Open Graph metadata, and a refreshed nav/footer.

The download page gains channel-specific GitHub release resolution (including nightly selection and macOS arch-aware asset URLs), a Dev “build from source” path, and clearer mobile store links. Legal pages can use a simplified layout without the on-page section nav.

Asset pipeline:dev/build now run the web sidebar demo build plus a Playwright capture script that produces feature crops and a WebGL-composited og-image.png. A CI job on the default branch copies dark mobile showcase screenshots into apps/marketing/public/mobile-states and auto-commits when they change.

README adds mobile app links and a mobile-app doc entry; store logos and mobile preview metadata are added under public/.

^{Reviewed by Cursor Bugbot for commit 47a4777. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Redesign marketing website with stage-aware downloads, live demo embed, and mobile app showcase

• Rebuilds the homepage (index.astro) with a live interactive demo iframe, a dynamic hero section, a new Remote+mobile section with iOS/Android store links, an FAQ section, and a redesigned CTA; removes the old harnesses/Git/open-source sections.
• Adds a release channel picker (Latest/Nightly/Dev) to the download page and homepage; download buttons resolve platform-specific asset URLs or copy a git clone command in Dev stage; selections persist via localStorage and sync across the page via a t3-marketing-stage-change custom event.
• Overhauls Layout.astro with Open Graph/Twitter/canonical metadata, stage-aware favicons, a layered blur nav, an expanded three-column footer, and an inline script that sets data-stage/data-platform on <html> at load time.
• Adds fetchNightlyRelease, findReleaseAssetUrl, selectNightlyRelease, and a 5-minute session cache to releases.ts to support nightly asset resolution.
• Introduces a standalone sidebar demo build (vite.demo.config.ts) that emits into marketing/public/sidebar-demo, a Playwright screenshot capture script, and a CI workflow step that auto-publishes mobile screenshots to the repo.
• Adds mobile app links to the Connections settings panel and user documentation.
• Risk: dev and build scripts now run build:sidebar-demo and Playwright screenshot capture before Astro, increasing build time and adding a Playwright dependency.

📊 Macroscope summarized 47a4777. 37 files reviewed, 0 issues evaluated, 0 issues filtered, 0 comments posted

🗂️ Filtered Issues

No issues evaluated.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 33e670f6-8118-4cf1-b840-009f61ddca2a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[t3-code]

maria confirmed this redesign already covers the app-store work in #4902: the shared store URLs, README mobile links, and mobile download section. #4902 should not be merged separately.

[macroscopeapp]

Approvability

Verdict: Needs human review

5 blocking correctness issues found. Diff is too large for automated approval analysis. A human reviewer should evaluate this PR.

^{You can customize Macroscope's approvability policy. Learn more.}

[macroscopeapp]

Reviewed the new Effect code in apps/web/src/demo/* (in-browser demo RPC backend, layers, fixtures, seeding) plus the touched web/marketing TypeScript against the Effect service conventions.

Namespace subpath imports, layer composition, WsRpcGroup.toLayer handler wiring, and the Effect.runFork(Layer.launch(...)) application boundary all look consistent with the conventions. One finding on error modeling at the dispatch boundary in apps/web/src/demo/server.ts.

^{Posted via Macroscope — Effect Service Conventions}

[StiensWout]

looking good! I like the style :)

[macroscopeapp]

🟡 Mediumlib/showcase-spec.json:15

All four showcase help links lead to invalid documentation targets: the encyclopedia.md and source-control-providers.md paths 404, while keybindings.md#defaults lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the href values to existing documentation paths and anchors, such as docs/user/source-control.md, or add the referenced pages.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/marketing/src/lib/showcase-spec.json around line 15:
All four showcase help links lead to invalid documentation targets: the `encyclopedia.md` and `source-control-providers.md` paths 404, while `keybindings.md#defaults` lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the `href` values to existing documentation paths and anchors, such as `docs/user/source-control.md`, or add the referenced pages.

[macroscopeapp]

🟡 Mediumdemo/fixtures.ts:680

DEMO_COMPOSER_DIFF is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares -6 +9 but contains -3 +6 lines, the second declares -7 +16 but contains -2 +12, and the DropOverlay.tsx hunk declares +11 but contains +7; update the hunk counts or add the missing fixture lines.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/fixtures.ts around line 680:
`DEMO_COMPOSER_DIFF` is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares `-6 +9` but contains `-3 +6` lines, the second declares `-7 +16` but contains `-2 +12`, and the `DropOverlay.tsx` hunk declares `+11` but contains `+7`; update the hunk counts or add the missing fixture lines.

[macroscopeapp]

🟡 Mediumdemo/main.tsx:56

The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe Window during capture, before this document listener is reached; register the handler on window instead so it runs at the window phase.

- document.addEventListener(+ window.addEventListener(

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/main.tsx around line 56:
The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe `Window` during capture, before this `document` listener is reached; register the handler on `window` instead so it runs at the window phase.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:82

Overlapping runs can commit stale screenshots and source.json to the default branch, regressing a newer preview. publish_marketing_preview checks out the branch after capture but never verifies that github.sha is still current, and git pull --rebase can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 82:
Overlapping runs can commit stale screenshots and `source.json` to the default branch, regressing a newer preview. `publish_marketing_preview` checks out the branch after capture but never verifies that `github.sha` is still current, and `git pull --rebase` can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:150

The publisher leaves threads-light.png and the four ios-*-light.png assets stale, so light-color-scheme visitors see outdated screenshots after a default appearance: both capture. preview_sources includes only dark paths; add the corresponding light mappings so both halves are refreshed.

 ["ios-environments.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/dark/environments.png"
+ ["threads-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/threads.png"+ ["ios-thread-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/thread.png"+ ["ios-terminal-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/terminal.png"+ ["ios-review-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/review.png"+ ["ios-environments-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/environments.png"

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 150:
The publisher leaves `threads-light.png` and the four `ios-*-light.png` assets stale, so light-color-scheme visitors see outdated screenshots after a default `appearance: both` capture. `preview_sources` includes only `dark` paths; add the corresponding `light` mappings so both halves are refreshed.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Demo wheel hijacks inner scrolling

Medium Severity

The homepage attaches a capture-phase wheel listener on the demo iframe window that always calls preventDefault and stopImmediatePropagation, then scrolls the outer page. That runs before the demo’s own wheel handler, so sidebar, thread, and other inner surfaces never receive trackpad or mouse wheel input in the embedded hero.

Additional Locations (1)

• apps/web/src/demo/main.tsx#L50-L71

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Publish job skips light screenshots

Low Severity

publish_marketing_preview runs for dark and default both captures, but it only copies .../dark/... files into mobile-states. The homepage serves matching *-light.png assets in light mode, and those files are never refreshed by this job.

Additional Locations (1)

• .github/workflows/mobile-showcase-screenshots.yml#L83-L90

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[maria-rcks]

What Changed

• Redesigned the marketing homepage around the simpler visual system, shared atmospheric hero treatment, and updated product showcase.
• Reworked the download page with a cleaner release-channel switch, ordered platform rows, mobile store links, and official store artwork.
• Simplified the privacy and security pages to match the homepage, including quieter typography, white bullets, and streamlined navigation.
• Added deterministic web-demo fixtures and screenshot tooling for marketing assets, along with mobile documentation and refreshed Open Graph imagery.
• Linked the iOS and Android downloads directly from the README introduction, incorporating the README treatment from docs: link iOS and Android app store downloads #4902 alongside the dedicated mobile-app section.

Why

The marketing and legal surfaces had diverged visually, while the download experience mixed oversized store actions, icon-heavy release controls, and inconsistent page chrome. This brings those surfaces into one restrained design system and makes the product itself the focus.

UI Changes

Each comparison uses the same 1440 × 900 viewport and a slow, eased full-page scroll. “Before” is the current live t3.codes page; “After” is this redesign.

Page	Before	After
Homepage	old-home.webm	new-home.webm
Download	old-download.webm	new-download.webm
Privacy	old-privacy.webm	new-privacy.webm
Security	old-security.webm	new-security.webm

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes
• I included a video for animation/interaction changes

Validation:

• pnpm --filter @t3tools/marketing typecheck
• pnpm --filter @t3tools/web typecheck
• pnpm --filter @t3tools/web test -- src/branding.test.ts (186 files, 1,666 tests)
• pnpm exec vitest run apps/marketing/src/lib/releases.test.ts (2 tests)

Built with GPT-5.6 Sol via the T3 Code Codex harness.

---

Note

Medium Risk
Large marketing surface area and a workflow that pushes commits to the default branch with release-app credentials; marketing builds now depend on Chromium/Playwright and the web sidebar-demo build, increasing CI and local build time and failure modes.

Overview
Redesigns the marketing site around a shared layout with release-channel switching (Latest / Nightly / Dev), platform-aware behavior, Open Graph metadata, and a refreshed nav/footer.

The download page gains channel-specific GitHub release resolution (including nightly selection and macOS arch-aware asset URLs), a Dev “build from source” path, and clearer mobile store links. Legal pages can use a simplified layout without the on-page section nav.

Asset pipeline:dev/build now run the web sidebar demo build plus a Playwright capture script that produces feature crops and a WebGL-composited og-image.png. A CI job on the default branch copies dark mobile showcase screenshots into apps/marketing/public/mobile-states and auto-commits when they change.

README adds mobile app links and a mobile-app doc entry; store logos and mobile preview metadata are added under public/.

^{Reviewed by Cursor Bugbot for commit 47a4777. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Redesign marketing website with stage-aware downloads, live demo embed, and mobile app showcase

• Rebuilds the homepage (index.astro) with a live interactive demo iframe, a dynamic hero section, a new Remote+mobile section with iOS/Android store links, an FAQ section, and a redesigned CTA; removes the old harnesses/Git/open-source sections.
• Adds a release channel picker (Latest/Nightly/Dev) to the download page and homepage; download buttons resolve platform-specific asset URLs or copy a git clone command in Dev stage; selections persist via localStorage and sync across the page via a t3-marketing-stage-change custom event.
• Overhauls Layout.astro with Open Graph/Twitter/canonical metadata, stage-aware favicons, a layered blur nav, an expanded three-column footer, and an inline script that sets data-stage/data-platform on <html> at load time.
• Adds fetchNightlyRelease, findReleaseAssetUrl, selectNightlyRelease, and a 5-minute session cache to releases.ts to support nightly asset resolution.
• Introduces a standalone sidebar demo build (vite.demo.config.ts) that emits into marketing/public/sidebar-demo, a Playwright screenshot capture script, and a CI workflow step that auto-publishes mobile screenshots to the repo.
• Adds mobile app links to the Connections settings panel and user documentation.
• Risk: dev and build scripts now run build:sidebar-demo and Playwright screenshot capture before Astro, increasing build time and adding a Playwright dependency.

📊 Macroscope summarized 47a4777. 37 files reviewed, 0 issues evaluated, 0 issues filtered, 0 comments posted

🗂️ Filtered Issues

No issues evaluated.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 33e670f6-8118-4cf1-b840-009f61ddca2a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[t3-code]

maria confirmed this redesign already covers the app-store work in #4902: the shared store URLs, README mobile links, and mobile download section. #4902 should not be merged separately.

[macroscopeapp]

Approvability

Verdict: Needs human review

5 blocking correctness issues found. Diff is too large for automated approval analysis. A human reviewer should evaluate this PR.

^{You can customize Macroscope's approvability policy. Learn more.}

[macroscopeapp]

Reviewed the new Effect code in apps/web/src/demo/* (in-browser demo RPC backend, layers, fixtures, seeding) plus the touched web/marketing TypeScript against the Effect service conventions.

Namespace subpath imports, layer composition, WsRpcGroup.toLayer handler wiring, and the Effect.runFork(Layer.launch(...)) application boundary all look consistent with the conventions. One finding on error modeling at the dispatch boundary in apps/web/src/demo/server.ts.

^{Posted via Macroscope — Effect Service Conventions}

[StiensWout]

looking good! I like the style :)

[macroscopeapp]

🟡 Mediumlib/showcase-spec.json:15

All four showcase help links lead to invalid documentation targets: the encyclopedia.md and source-control-providers.md paths 404, while keybindings.md#defaults lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the href values to existing documentation paths and anchors, such as docs/user/source-control.md, or add the referenced pages.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/marketing/src/lib/showcase-spec.json around line 15:
All four showcase help links lead to invalid documentation targets: the `encyclopedia.md` and `source-control-providers.md` paths 404, while `keybindings.md#defaults` lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the `href` values to existing documentation paths and anchors, such as `docs/user/source-control.md`, or add the referenced pages.

[macroscopeapp]

🟡 Mediumdemo/fixtures.ts:680

DEMO_COMPOSER_DIFF is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares -6 +9 but contains -3 +6 lines, the second declares -7 +16 but contains -2 +12, and the DropOverlay.tsx hunk declares +11 but contains +7; update the hunk counts or add the missing fixture lines.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/fixtures.ts around line 680:
`DEMO_COMPOSER_DIFF` is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares `-6 +9` but contains `-3 +6` lines, the second declares `-7 +16` but contains `-2 +12`, and the `DropOverlay.tsx` hunk declares `+11` but contains `+7`; update the hunk counts or add the missing fixture lines.

[macroscopeapp]

🟡 Mediumdemo/main.tsx:56

The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe Window during capture, before this document listener is reached; register the handler on window instead so it runs at the window phase.

- document.addEventListener(+ window.addEventListener(

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/main.tsx around line 56:
The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe `Window` during capture, before this `document` listener is reached; register the handler on `window` instead so it runs at the window phase.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:82

Overlapping runs can commit stale screenshots and source.json to the default branch, regressing a newer preview. publish_marketing_preview checks out the branch after capture but never verifies that github.sha is still current, and git pull --rebase can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 82:
Overlapping runs can commit stale screenshots and `source.json` to the default branch, regressing a newer preview. `publish_marketing_preview` checks out the branch after capture but never verifies that `github.sha` is still current, and `git pull --rebase` can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:150

The publisher leaves threads-light.png and the four ios-*-light.png assets stale, so light-color-scheme visitors see outdated screenshots after a default appearance: both capture. preview_sources includes only dark paths; add the corresponding light mappings so both halves are refreshed.

 ["ios-environments.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/dark/environments.png"
+ ["threads-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/threads.png"+ ["ios-thread-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/thread.png"+ ["ios-terminal-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/terminal.png"+ ["ios-review-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/review.png"+ ["ios-environments-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/environments.png"

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 150:
The publisher leaves `threads-light.png` and the four `ios-*-light.png` assets stale, so light-color-scheme visitors see outdated screenshots after a default `appearance: both` capture. `preview_sources` includes only `dark` paths; add the corresponding `light` mappings so both halves are refreshed.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Demo wheel hijacks inner scrolling

Medium Severity

The homepage attaches a capture-phase wheel listener on the demo iframe window that always calls preventDefault and stopImmediatePropagation, then scrolls the outer page. That runs before the demo’s own wheel handler, so sidebar, thread, and other inner surfaces never receive trackpad or mouse wheel input in the embedded hero.

Additional Locations (1)

• apps/web/src/demo/main.tsx#L50-L71

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Publish job skips light screenshots

Low Severity

publish_marketing_preview runs for dark and default both captures, but it only copies .../dark/... files into mobile-states. The homepage serves matching *-light.png assets in light mode, and those files are never refreshed by this job.

Additional Locations (1)

• .github/workflows/mobile-showcase-screenshots.yml#L83-L90

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[maria-rcks]

What Changed

• Redesigned the marketing homepage around the simpler visual system, shared atmospheric hero treatment, and updated product showcase.
• Reworked the download page with a cleaner release-channel switch, ordered platform rows, mobile store links, and official store artwork.
• Simplified the privacy and security pages to match the homepage, including quieter typography, white bullets, and streamlined navigation.
• Added deterministic web-demo fixtures and screenshot tooling for marketing assets, along with mobile documentation and refreshed Open Graph imagery.
• Linked the iOS and Android downloads directly from the README introduction, incorporating the README treatment from docs: link iOS and Android app store downloads #4902 alongside the dedicated mobile-app section.

Why

The marketing and legal surfaces had diverged visually, while the download experience mixed oversized store actions, icon-heavy release controls, and inconsistent page chrome. This brings those surfaces into one restrained design system and makes the product itself the focus.

UI Changes

Each comparison uses the same 1440 × 900 viewport and a slow, eased full-page scroll. “Before” is the current live t3.codes page; “After” is this redesign.

Page	Before	After
Homepage	old-home.webm	new-home.webm
Download	old-download.webm	new-download.webm
Privacy	old-privacy.webm	new-privacy.webm
Security	old-security.webm	new-security.webm

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes
• I included a video for animation/interaction changes

Validation:

• pnpm --filter @t3tools/marketing typecheck
• pnpm --filter @t3tools/web typecheck
• pnpm --filter @t3tools/web test -- src/branding.test.ts (186 files, 1,666 tests)
• pnpm exec vitest run apps/marketing/src/lib/releases.test.ts (2 tests)

Built with GPT-5.6 Sol via the T3 Code Codex harness.

---

Note

Medium Risk
Large marketing surface area and a workflow that pushes commits to the default branch with release-app credentials; marketing builds now depend on Chromium/Playwright and the web sidebar-demo build, increasing CI and local build time and failure modes.

Overview
Redesigns the marketing site around a shared layout with release-channel switching (Latest / Nightly / Dev), platform-aware behavior, Open Graph metadata, and a refreshed nav/footer.

The download page gains channel-specific GitHub release resolution (including nightly selection and macOS arch-aware asset URLs), a Dev “build from source” path, and clearer mobile store links. Legal pages can use a simplified layout without the on-page section nav.

Asset pipeline:dev/build now run the web sidebar demo build plus a Playwright capture script that produces feature crops and a WebGL-composited og-image.png. A CI job on the default branch copies dark mobile showcase screenshots into apps/marketing/public/mobile-states and auto-commits when they change.

README adds mobile app links and a mobile-app doc entry; store logos and mobile preview metadata are added under public/.

^{Reviewed by Cursor Bugbot for commit 47a4777. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Redesign marketing website with stage-aware downloads, live demo embed, and mobile app showcase

• Rebuilds the homepage (index.astro) with a live interactive demo iframe, a dynamic hero section, a new Remote+mobile section with iOS/Android store links, an FAQ section, and a redesigned CTA; removes the old harnesses/Git/open-source sections.
• Adds a release channel picker (Latest/Nightly/Dev) to the download page and homepage; download buttons resolve platform-specific asset URLs or copy a git clone command in Dev stage; selections persist via localStorage and sync across the page via a t3-marketing-stage-change custom event.
• Overhauls Layout.astro with Open Graph/Twitter/canonical metadata, stage-aware favicons, a layered blur nav, an expanded three-column footer, and an inline script that sets data-stage/data-platform on <html> at load time.
• Adds fetchNightlyRelease, findReleaseAssetUrl, selectNightlyRelease, and a 5-minute session cache to releases.ts to support nightly asset resolution.
• Introduces a standalone sidebar demo build (vite.demo.config.ts) that emits into marketing/public/sidebar-demo, a Playwright screenshot capture script, and a CI workflow step that auto-publishes mobile screenshots to the repo.
• Adds mobile app links to the Connections settings panel and user documentation.
• Risk: dev and build scripts now run build:sidebar-demo and Playwright screenshot capture before Astro, increasing build time and adding a Playwright dependency.

📊 Macroscope summarized 47a4777. 37 files reviewed, 0 issues evaluated, 0 issues filtered, 0 comments posted

🗂️ Filtered Issues

No issues evaluated.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 33e670f6-8118-4cf1-b840-009f61ddca2a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[t3-code]

maria confirmed this redesign already covers the app-store work in #4902: the shared store URLs, README mobile links, and mobile download section. #4902 should not be merged separately.

[macroscopeapp]

Approvability

Verdict: Needs human review

5 blocking correctness issues found. Diff is too large for automated approval analysis. A human reviewer should evaluate this PR.

^{You can customize Macroscope's approvability policy. Learn more.}

[macroscopeapp]

Reviewed the new Effect code in apps/web/src/demo/* (in-browser demo RPC backend, layers, fixtures, seeding) plus the touched web/marketing TypeScript against the Effect service conventions.

Namespace subpath imports, layer composition, WsRpcGroup.toLayer handler wiring, and the Effect.runFork(Layer.launch(...)) application boundary all look consistent with the conventions. One finding on error modeling at the dispatch boundary in apps/web/src/demo/server.ts.

^{Posted via Macroscope — Effect Service Conventions}

[StiensWout]

looking good! I like the style :)

[macroscopeapp]

🟡 Mediumlib/showcase-spec.json:15

All four showcase help links lead to invalid documentation targets: the encyclopedia.md and source-control-providers.md paths 404, while keybindings.md#defaults lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the href values to existing documentation paths and anchors, such as docs/user/source-control.md, or add the referenced pages.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/marketing/src/lib/showcase-spec.json around line 15:
All four showcase help links lead to invalid documentation targets: the `encyclopedia.md` and `source-control-providers.md` paths 404, while `keybindings.md#defaults` lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the `href` values to existing documentation paths and anchors, such as `docs/user/source-control.md`, or add the referenced pages.

[macroscopeapp]

🟡 Mediumdemo/fixtures.ts:680

DEMO_COMPOSER_DIFF is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares -6 +9 but contains -3 +6 lines, the second declares -7 +16 but contains -2 +12, and the DropOverlay.tsx hunk declares +11 but contains +7; update the hunk counts or add the missing fixture lines.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/fixtures.ts around line 680:
`DEMO_COMPOSER_DIFF` is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares `-6 +9` but contains `-3 +6` lines, the second declares `-7 +16` but contains `-2 +12`, and the `DropOverlay.tsx` hunk declares `+11` but contains `+7`; update the hunk counts or add the missing fixture lines.

[macroscopeapp]

🟡 Mediumdemo/main.tsx:56

The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe Window during capture, before this document listener is reached; register the handler on window instead so it runs at the window phase.

- document.addEventListener(+ window.addEventListener(

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/main.tsx around line 56:
The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe `Window` during capture, before this `document` listener is reached; register the handler on `window` instead so it runs at the window phase.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:82

Overlapping runs can commit stale screenshots and source.json to the default branch, regressing a newer preview. publish_marketing_preview checks out the branch after capture but never verifies that github.sha is still current, and git pull --rebase can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 82:
Overlapping runs can commit stale screenshots and `source.json` to the default branch, regressing a newer preview. `publish_marketing_preview` checks out the branch after capture but never verifies that `github.sha` is still current, and `git pull --rebase` can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:150

The publisher leaves threads-light.png and the four ios-*-light.png assets stale, so light-color-scheme visitors see outdated screenshots after a default appearance: both capture. preview_sources includes only dark paths; add the corresponding light mappings so both halves are refreshed.

 ["ios-environments.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/dark/environments.png"
+ ["threads-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/threads.png"+ ["ios-thread-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/thread.png"+ ["ios-terminal-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/terminal.png"+ ["ios-review-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/review.png"+ ["ios-environments-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/environments.png"

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 150:
The publisher leaves `threads-light.png` and the four `ios-*-light.png` assets stale, so light-color-scheme visitors see outdated screenshots after a default `appearance: both` capture. `preview_sources` includes only `dark` paths; add the corresponding `light` mappings so both halves are refreshed.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Demo wheel hijacks inner scrolling

Medium Severity

The homepage attaches a capture-phase wheel listener on the demo iframe window that always calls preventDefault and stopImmediatePropagation, then scrolls the outer page. That runs before the demo’s own wheel handler, so sidebar, thread, and other inner surfaces never receive trackpad or mouse wheel input in the embedded hero.

Additional Locations (1)

• apps/web/src/demo/main.tsx#L50-L71

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Publish job skips light screenshots

Low Severity

publish_marketing_preview runs for dark and default both captures, but it only copies .../dark/... files into mobile-states. The homepage serves matching *-light.png assets in light mode, and those files are never refreshed by this job.

Additional Locations (1)

• .github/workflows/mobile-showcase-screenshots.yml#L83-L90

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[maria-rcks]

What Changed

• Redesigned the marketing homepage around the simpler visual system, shared atmospheric hero treatment, and updated product showcase.
• Reworked the download page with a cleaner release-channel switch, ordered platform rows, mobile store links, and official store artwork.
• Simplified the privacy and security pages to match the homepage, including quieter typography, white bullets, and streamlined navigation.
• Added deterministic web-demo fixtures and screenshot tooling for marketing assets, along with mobile documentation and refreshed Open Graph imagery.
• Linked the iOS and Android downloads directly from the README introduction, incorporating the README treatment from docs: link iOS and Android app store downloads #4902 alongside the dedicated mobile-app section.

Why

The marketing and legal surfaces had diverged visually, while the download experience mixed oversized store actions, icon-heavy release controls, and inconsistent page chrome. This brings those surfaces into one restrained design system and makes the product itself the focus.

UI Changes

Each comparison uses the same 1440 × 900 viewport and a slow, eased full-page scroll. “Before” is the current live t3.codes page; “After” is this redesign.

Page	Before	After
Homepage	old-home.webm	new-home.webm
Download	old-download.webm	new-download.webm
Privacy	old-privacy.webm	new-privacy.webm
Security	old-security.webm	new-security.webm

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes
• I included a video for animation/interaction changes

Validation:

• pnpm --filter @t3tools/marketing typecheck
• pnpm --filter @t3tools/web typecheck
• pnpm --filter @t3tools/web test -- src/branding.test.ts (186 files, 1,666 tests)
• pnpm exec vitest run apps/marketing/src/lib/releases.test.ts (2 tests)

Built with GPT-5.6 Sol via the T3 Code Codex harness.

---

Note

Medium Risk
Large marketing surface area and a workflow that pushes commits to the default branch with release-app credentials; marketing builds now depend on Chromium/Playwright and the web sidebar-demo build, increasing CI and local build time and failure modes.

Overview
Redesigns the marketing site around a shared layout with release-channel switching (Latest / Nightly / Dev), platform-aware behavior, Open Graph metadata, and a refreshed nav/footer.

The download page gains channel-specific GitHub release resolution (including nightly selection and macOS arch-aware asset URLs), a Dev “build from source” path, and clearer mobile store links. Legal pages can use a simplified layout without the on-page section nav.

Asset pipeline:dev/build now run the web sidebar demo build plus a Playwright capture script that produces feature crops and a WebGL-composited og-image.png. A CI job on the default branch copies dark mobile showcase screenshots into apps/marketing/public/mobile-states and auto-commits when they change.

README adds mobile app links and a mobile-app doc entry; store logos and mobile preview metadata are added under public/.

^{Reviewed by Cursor Bugbot for commit 47a4777. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Redesign marketing website with stage-aware downloads, live demo embed, and mobile app showcase

• Rebuilds the homepage (index.astro) with a live interactive demo iframe, a dynamic hero section, a new Remote+mobile section with iOS/Android store links, an FAQ section, and a redesigned CTA; removes the old harnesses/Git/open-source sections.
• Adds a release channel picker (Latest/Nightly/Dev) to the download page and homepage; download buttons resolve platform-specific asset URLs or copy a git clone command in Dev stage; selections persist via localStorage and sync across the page via a t3-marketing-stage-change custom event.
• Overhauls Layout.astro with Open Graph/Twitter/canonical metadata, stage-aware favicons, a layered blur nav, an expanded three-column footer, and an inline script that sets data-stage/data-platform on <html> at load time.
• Adds fetchNightlyRelease, findReleaseAssetUrl, selectNightlyRelease, and a 5-minute session cache to releases.ts to support nightly asset resolution.
• Introduces a standalone sidebar demo build (vite.demo.config.ts) that emits into marketing/public/sidebar-demo, a Playwright screenshot capture script, and a CI workflow step that auto-publishes mobile screenshots to the repo.
• Adds mobile app links to the Connections settings panel and user documentation.
• Risk: dev and build scripts now run build:sidebar-demo and Playwright screenshot capture before Astro, increasing build time and adding a Playwright dependency.

📊 Macroscope summarized 47a4777. 37 files reviewed, 0 issues evaluated, 0 issues filtered, 0 comments posted

🗂️ Filtered Issues

No issues evaluated.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 33e670f6-8118-4cf1-b840-009f61ddca2a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[t3-code]

maria confirmed this redesign already covers the app-store work in #4902: the shared store URLs, README mobile links, and mobile download section. #4902 should not be merged separately.

[macroscopeapp]

Approvability

Verdict: Needs human review

5 blocking correctness issues found. Diff is too large for automated approval analysis. A human reviewer should evaluate this PR.

^{You can customize Macroscope's approvability policy. Learn more.}

[macroscopeapp]

Reviewed the new Effect code in apps/web/src/demo/* (in-browser demo RPC backend, layers, fixtures, seeding) plus the touched web/marketing TypeScript against the Effect service conventions.

Namespace subpath imports, layer composition, WsRpcGroup.toLayer handler wiring, and the Effect.runFork(Layer.launch(...)) application boundary all look consistent with the conventions. One finding on error modeling at the dispatch boundary in apps/web/src/demo/server.ts.

^{Posted via Macroscope — Effect Service Conventions}

[StiensWout]

looking good! I like the style :)

[macroscopeapp]

🟡 Mediumlib/showcase-spec.json:15

All four showcase help links lead to invalid documentation targets: the encyclopedia.md and source-control-providers.md paths 404, while keybindings.md#defaults lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the href values to existing documentation paths and anchors, such as docs/user/source-control.md, or add the referenced pages.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/marketing/src/lib/showcase-spec.json around line 15:
All four showcase help links lead to invalid documentation targets: the `encyclopedia.md` and `source-control-providers.md` paths 404, while `keybindings.md#defaults` lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the `href` values to existing documentation paths and anchors, such as `docs/user/source-control.md`, or add the referenced pages.

[macroscopeapp]

🟡 Mediumdemo/fixtures.ts:680

DEMO_COMPOSER_DIFF is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares -6 +9 but contains -3 +6 lines, the second declares -7 +16 but contains -2 +12, and the DropOverlay.tsx hunk declares +11 but contains +7; update the hunk counts or add the missing fixture lines.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/fixtures.ts around line 680:
`DEMO_COMPOSER_DIFF` is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares `-6 +9` but contains `-3 +6` lines, the second declares `-7 +16` but contains `-2 +12`, and the `DropOverlay.tsx` hunk declares `+11` but contains `+7`; update the hunk counts or add the missing fixture lines.

[macroscopeapp]

🟡 Mediumdemo/main.tsx:56

The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe Window during capture, before this document listener is reached; register the handler on window instead so it runs at the window phase.

- document.addEventListener(+ window.addEventListener(

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/main.tsx around line 56:
The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe `Window` during capture, before this `document` listener is reached; register the handler on `window` instead so it runs at the window phase.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:82

Overlapping runs can commit stale screenshots and source.json to the default branch, regressing a newer preview. publish_marketing_preview checks out the branch after capture but never verifies that github.sha is still current, and git pull --rebase can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 82:
Overlapping runs can commit stale screenshots and `source.json` to the default branch, regressing a newer preview. `publish_marketing_preview` checks out the branch after capture but never verifies that `github.sha` is still current, and `git pull --rebase` can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:150

The publisher leaves threads-light.png and the four ios-*-light.png assets stale, so light-color-scheme visitors see outdated screenshots after a default appearance: both capture. preview_sources includes only dark paths; add the corresponding light mappings so both halves are refreshed.

 ["ios-environments.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/dark/environments.png"
+ ["threads-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/threads.png"+ ["ios-thread-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/thread.png"+ ["ios-terminal-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/terminal.png"+ ["ios-review-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/review.png"+ ["ios-environments-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/environments.png"

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 150:
The publisher leaves `threads-light.png` and the four `ios-*-light.png` assets stale, so light-color-scheme visitors see outdated screenshots after a default `appearance: both` capture. `preview_sources` includes only `dark` paths; add the corresponding `light` mappings so both halves are refreshed.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Demo wheel hijacks inner scrolling

Medium Severity

The homepage attaches a capture-phase wheel listener on the demo iframe window that always calls preventDefault and stopImmediatePropagation, then scrolls the outer page. That runs before the demo’s own wheel handler, so sidebar, thread, and other inner surfaces never receive trackpad or mouse wheel input in the embedded hero.

Additional Locations (1)

• apps/web/src/demo/main.tsx#L50-L71

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Publish job skips light screenshots

Low Severity

publish_marketing_preview runs for dark and default both captures, but it only copies .../dark/... files into mobile-states. The homepage serves matching *-light.png assets in light mode, and those files are never refreshed by this job.

Additional Locations (1)

• .github/workflows/mobile-showcase-screenshots.yml#L83-L90

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[maria-rcks]

What Changed

• Redesigned the marketing homepage around the simpler visual system, shared atmospheric hero treatment, and updated product showcase.
• Reworked the download page with a cleaner release-channel switch, ordered platform rows, mobile store links, and official store artwork.
• Simplified the privacy and security pages to match the homepage, including quieter typography, white bullets, and streamlined navigation.
• Added deterministic web-demo fixtures and screenshot tooling for marketing assets, along with mobile documentation and refreshed Open Graph imagery.
• Linked the iOS and Android downloads directly from the README introduction, incorporating the README treatment from docs: link iOS and Android app store downloads #4902 alongside the dedicated mobile-app section.

Why

The marketing and legal surfaces had diverged visually, while the download experience mixed oversized store actions, icon-heavy release controls, and inconsistent page chrome. This brings those surfaces into one restrained design system and makes the product itself the focus.

UI Changes

Each comparison uses the same 1440 × 900 viewport and a slow, eased full-page scroll. “Before” is the current live t3.codes page; “After” is this redesign.

Page	Before	After
Homepage	old-home.webm	new-home.webm
Download	old-download.webm	new-download.webm
Privacy	old-privacy.webm	new-privacy.webm
Security	old-security.webm	new-security.webm

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes
• I included a video for animation/interaction changes

Validation:

• pnpm --filter @t3tools/marketing typecheck
• pnpm --filter @t3tools/web typecheck
• pnpm --filter @t3tools/web test -- src/branding.test.ts (186 files, 1,666 tests)
• pnpm exec vitest run apps/marketing/src/lib/releases.test.ts (2 tests)

Built with GPT-5.6 Sol via the T3 Code Codex harness.

---

Note

Medium Risk
Large marketing surface area and a workflow that pushes commits to the default branch with release-app credentials; marketing builds now depend on Chromium/Playwright and the web sidebar-demo build, increasing CI and local build time and failure modes.

Overview
Redesigns the marketing site around a shared layout with release-channel switching (Latest / Nightly / Dev), platform-aware behavior, Open Graph metadata, and a refreshed nav/footer.

The download page gains channel-specific GitHub release resolution (including nightly selection and macOS arch-aware asset URLs), a Dev “build from source” path, and clearer mobile store links. Legal pages can use a simplified layout without the on-page section nav.

Asset pipeline:dev/build now run the web sidebar demo build plus a Playwright capture script that produces feature crops and a WebGL-composited og-image.png. A CI job on the default branch copies dark mobile showcase screenshots into apps/marketing/public/mobile-states and auto-commits when they change.

README adds mobile app links and a mobile-app doc entry; store logos and mobile preview metadata are added under public/.

^{Reviewed by Cursor Bugbot for commit 47a4777. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Redesign marketing website with stage-aware downloads, live demo embed, and mobile app showcase

• Rebuilds the homepage (index.astro) with a live interactive demo iframe, a dynamic hero section, a new Remote+mobile section with iOS/Android store links, an FAQ section, and a redesigned CTA; removes the old harnesses/Git/open-source sections.
• Adds a release channel picker (Latest/Nightly/Dev) to the download page and homepage; download buttons resolve platform-specific asset URLs or copy a git clone command in Dev stage; selections persist via localStorage and sync across the page via a t3-marketing-stage-change custom event.
• Overhauls Layout.astro with Open Graph/Twitter/canonical metadata, stage-aware favicons, a layered blur nav, an expanded three-column footer, and an inline script that sets data-stage/data-platform on <html> at load time.
• Adds fetchNightlyRelease, findReleaseAssetUrl, selectNightlyRelease, and a 5-minute session cache to releases.ts to support nightly asset resolution.
• Introduces a standalone sidebar demo build (vite.demo.config.ts) that emits into marketing/public/sidebar-demo, a Playwright screenshot capture script, and a CI workflow step that auto-publishes mobile screenshots to the repo.
• Adds mobile app links to the Connections settings panel and user documentation.
• Risk: dev and build scripts now run build:sidebar-demo and Playwright screenshot capture before Astro, increasing build time and adding a Playwright dependency.

📊 Macroscope summarized 47a4777. 37 files reviewed, 0 issues evaluated, 0 issues filtered, 0 comments posted

🗂️ Filtered Issues

No issues evaluated.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 33e670f6-8118-4cf1-b840-009f61ddca2a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[t3-code]

maria confirmed this redesign already covers the app-store work in #4902: the shared store URLs, README mobile links, and mobile download section. #4902 should not be merged separately.

[macroscopeapp]

Approvability

Verdict: Needs human review

5 blocking correctness issues found. Diff is too large for automated approval analysis. A human reviewer should evaluate this PR.

^{You can customize Macroscope's approvability policy. Learn more.}

[macroscopeapp]

Reviewed the new Effect code in apps/web/src/demo/* (in-browser demo RPC backend, layers, fixtures, seeding) plus the touched web/marketing TypeScript against the Effect service conventions.

Namespace subpath imports, layer composition, WsRpcGroup.toLayer handler wiring, and the Effect.runFork(Layer.launch(...)) application boundary all look consistent with the conventions. One finding on error modeling at the dispatch boundary in apps/web/src/demo/server.ts.

^{Posted via Macroscope — Effect Service Conventions}

[StiensWout]

looking good! I like the style :)

[macroscopeapp]

🟡 Mediumlib/showcase-spec.json:15

All four showcase help links lead to invalid documentation targets: the encyclopedia.md and source-control-providers.md paths 404, while keybindings.md#defaults lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the href values to existing documentation paths and anchors, such as docs/user/source-control.md, or add the referenced pages.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/marketing/src/lib/showcase-spec.json around line 15:
All four showcase help links lead to invalid documentation targets: the `encyclopedia.md` and `source-control-providers.md` paths 404, while `keybindings.md#defaults` lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the `href` values to existing documentation paths and anchors, such as `docs/user/source-control.md`, or add the referenced pages.

[macroscopeapp]

🟡 Mediumdemo/fixtures.ts:680

DEMO_COMPOSER_DIFF is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares -6 +9 but contains -3 +6 lines, the second declares -7 +16 but contains -2 +12, and the DropOverlay.tsx hunk declares +11 but contains +7; update the hunk counts or add the missing fixture lines.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/fixtures.ts around line 680:
`DEMO_COMPOSER_DIFF` is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares `-6 +9` but contains `-3 +6` lines, the second declares `-7 +16` but contains `-2 +12`, and the `DropOverlay.tsx` hunk declares `+11` but contains `+7`; update the hunk counts or add the missing fixture lines.

[macroscopeapp]

🟡 Mediumdemo/main.tsx:56

The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe Window during capture, before this document listener is reached; register the handler on window instead so it runs at the window phase.

- document.addEventListener(+ window.addEventListener(

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/main.tsx around line 56:
The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe `Window` during capture, before this `document` listener is reached; register the handler on `window` instead so it runs at the window phase.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:82

Overlapping runs can commit stale screenshots and source.json to the default branch, regressing a newer preview. publish_marketing_preview checks out the branch after capture but never verifies that github.sha is still current, and git pull --rebase can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 82:
Overlapping runs can commit stale screenshots and `source.json` to the default branch, regressing a newer preview. `publish_marketing_preview` checks out the branch after capture but never verifies that `github.sha` is still current, and `git pull --rebase` can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:150

The publisher leaves threads-light.png and the four ios-*-light.png assets stale, so light-color-scheme visitors see outdated screenshots after a default appearance: both capture. preview_sources includes only dark paths; add the corresponding light mappings so both halves are refreshed.

 ["ios-environments.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/dark/environments.png"
+ ["threads-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/threads.png"+ ["ios-thread-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/thread.png"+ ["ios-terminal-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/terminal.png"+ ["ios-review-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/review.png"+ ["ios-environments-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/environments.png"

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 150:
The publisher leaves `threads-light.png` and the four `ios-*-light.png` assets stale, so light-color-scheme visitors see outdated screenshots after a default `appearance: both` capture. `preview_sources` includes only `dark` paths; add the corresponding `light` mappings so both halves are refreshed.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Demo wheel hijacks inner scrolling

Medium Severity

The homepage attaches a capture-phase wheel listener on the demo iframe window that always calls preventDefault and stopImmediatePropagation, then scrolls the outer page. That runs before the demo’s own wheel handler, so sidebar, thread, and other inner surfaces never receive trackpad or mouse wheel input in the embedded hero.

Additional Locations (1)

• apps/web/src/demo/main.tsx#L50-L71

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Publish job skips light screenshots

Low Severity

publish_marketing_preview runs for dark and default both captures, but it only copies .../dark/... files into mobile-states. The homepage serves matching *-light.png assets in light mode, and those files are never refreshed by this job.

Additional Locations (1)

• .github/workflows/mobile-showcase-screenshots.yml#L83-L90

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[maria-rcks]

What Changed

• Redesigned the marketing homepage around the simpler visual system, shared atmospheric hero treatment, and updated product showcase.
• Reworked the download page with a cleaner release-channel switch, ordered platform rows, mobile store links, and official store artwork.
• Simplified the privacy and security pages to match the homepage, including quieter typography, white bullets, and streamlined navigation.
• Added deterministic web-demo fixtures and screenshot tooling for marketing assets, along with mobile documentation and refreshed Open Graph imagery.
• Linked the iOS and Android downloads directly from the README introduction, incorporating the README treatment from docs: link iOS and Android app store downloads #4902 alongside the dedicated mobile-app section.

Why

The marketing and legal surfaces had diverged visually, while the download experience mixed oversized store actions, icon-heavy release controls, and inconsistent page chrome. This brings those surfaces into one restrained design system and makes the product itself the focus.

UI Changes

Each comparison uses the same 1440 × 900 viewport and a slow, eased full-page scroll. “Before” is the current live t3.codes page; “After” is this redesign.

Page	Before	After
Homepage	old-home.webm	new-home.webm
Download	old-download.webm	new-download.webm
Privacy	old-privacy.webm	new-privacy.webm
Security	old-security.webm	new-security.webm

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes
• I included a video for animation/interaction changes

Validation:

• pnpm --filter @t3tools/marketing typecheck
• pnpm --filter @t3tools/web typecheck
• pnpm --filter @t3tools/web test -- src/branding.test.ts (186 files, 1,666 tests)
• pnpm exec vitest run apps/marketing/src/lib/releases.test.ts (2 tests)

Built with GPT-5.6 Sol via the T3 Code Codex harness.

---

Note

Medium Risk
Large marketing surface area and a workflow that pushes commits to the default branch with release-app credentials; marketing builds now depend on Chromium/Playwright and the web sidebar-demo build, increasing CI and local build time and failure modes.

Overview
Redesigns the marketing site around a shared layout with release-channel switching (Latest / Nightly / Dev), platform-aware behavior, Open Graph metadata, and a refreshed nav/footer.

The download page gains channel-specific GitHub release resolution (including nightly selection and macOS arch-aware asset URLs), a Dev “build from source” path, and clearer mobile store links. Legal pages can use a simplified layout without the on-page section nav.

Asset pipeline:dev/build now run the web sidebar demo build plus a Playwright capture script that produces feature crops and a WebGL-composited og-image.png. A CI job on the default branch copies dark mobile showcase screenshots into apps/marketing/public/mobile-states and auto-commits when they change.

README adds mobile app links and a mobile-app doc entry; store logos and mobile preview metadata are added under public/.

^{Reviewed by Cursor Bugbot for commit 47a4777. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Redesign marketing website with stage-aware downloads, live demo embed, and mobile app showcase

• Rebuilds the homepage (index.astro) with a live interactive demo iframe, a dynamic hero section, a new Remote+mobile section with iOS/Android store links, an FAQ section, and a redesigned CTA; removes the old harnesses/Git/open-source sections.
• Adds a release channel picker (Latest/Nightly/Dev) to the download page and homepage; download buttons resolve platform-specific asset URLs or copy a git clone command in Dev stage; selections persist via localStorage and sync across the page via a t3-marketing-stage-change custom event.
• Overhauls Layout.astro with Open Graph/Twitter/canonical metadata, stage-aware favicons, a layered blur nav, an expanded three-column footer, and an inline script that sets data-stage/data-platform on <html> at load time.
• Adds fetchNightlyRelease, findReleaseAssetUrl, selectNightlyRelease, and a 5-minute session cache to releases.ts to support nightly asset resolution.
• Introduces a standalone sidebar demo build (vite.demo.config.ts) that emits into marketing/public/sidebar-demo, a Playwright screenshot capture script, and a CI workflow step that auto-publishes mobile screenshots to the repo.
• Adds mobile app links to the Connections settings panel and user documentation.
• Risk: dev and build scripts now run build:sidebar-demo and Playwright screenshot capture before Astro, increasing build time and adding a Playwright dependency.

📊 Macroscope summarized 47a4777. 37 files reviewed, 0 issues evaluated, 0 issues filtered, 0 comments posted

🗂️ Filtered Issues

No issues evaluated.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 33e670f6-8118-4cf1-b840-009f61ddca2a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[t3-code]

maria confirmed this redesign already covers the app-store work in #4902: the shared store URLs, README mobile links, and mobile download section. #4902 should not be merged separately.

[macroscopeapp]

Approvability

Verdict: Needs human review

5 blocking correctness issues found. Diff is too large for automated approval analysis. A human reviewer should evaluate this PR.

^{You can customize Macroscope's approvability policy. Learn more.}

[macroscopeapp]

Reviewed the new Effect code in apps/web/src/demo/* (in-browser demo RPC backend, layers, fixtures, seeding) plus the touched web/marketing TypeScript against the Effect service conventions.

Namespace subpath imports, layer composition, WsRpcGroup.toLayer handler wiring, and the Effect.runFork(Layer.launch(...)) application boundary all look consistent with the conventions. One finding on error modeling at the dispatch boundary in apps/web/src/demo/server.ts.

^{Posted via Macroscope — Effect Service Conventions}

[StiensWout]

looking good! I like the style :)

[macroscopeapp]

🟡 Mediumlib/showcase-spec.json:15

All four showcase help links lead to invalid documentation targets: the encyclopedia.md and source-control-providers.md paths 404, while keybindings.md#defaults lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the href values to existing documentation paths and anchors, such as docs/user/source-control.md, or add the referenced pages.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/marketing/src/lib/showcase-spec.json around line 15:
All four showcase help links lead to invalid documentation targets: the `encyclopedia.md` and `source-control-providers.md` paths 404, while `keybindings.md#defaults` lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the `href` values to existing documentation paths and anchors, such as `docs/user/source-control.md`, or add the referenced pages.

[macroscopeapp]

🟡 Mediumdemo/fixtures.ts:680

DEMO_COMPOSER_DIFF is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares -6 +9 but contains -3 +6 lines, the second declares -7 +16 but contains -2 +12, and the DropOverlay.tsx hunk declares +11 but contains +7; update the hunk counts or add the missing fixture lines.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/fixtures.ts around line 680:
`DEMO_COMPOSER_DIFF` is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares `-6 +9` but contains `-3 +6` lines, the second declares `-7 +16` but contains `-2 +12`, and the `DropOverlay.tsx` hunk declares `+11` but contains `+7`; update the hunk counts or add the missing fixture lines.

[macroscopeapp]

🟡 Mediumdemo/main.tsx:56

The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe Window during capture, before this document listener is reached; register the handler on window instead so it runs at the window phase.

- document.addEventListener(+ window.addEventListener(

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/main.tsx around line 56:
The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe `Window` during capture, before this `document` listener is reached; register the handler on `window` instead so it runs at the window phase.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:82

Overlapping runs can commit stale screenshots and source.json to the default branch, regressing a newer preview. publish_marketing_preview checks out the branch after capture but never verifies that github.sha is still current, and git pull --rebase can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 82:
Overlapping runs can commit stale screenshots and `source.json` to the default branch, regressing a newer preview. `publish_marketing_preview` checks out the branch after capture but never verifies that `github.sha` is still current, and `git pull --rebase` can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:150

The publisher leaves threads-light.png and the four ios-*-light.png assets stale, so light-color-scheme visitors see outdated screenshots after a default appearance: both capture. preview_sources includes only dark paths; add the corresponding light mappings so both halves are refreshed.

 ["ios-environments.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/dark/environments.png"
+ ["threads-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/threads.png"+ ["ios-thread-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/thread.png"+ ["ios-terminal-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/terminal.png"+ ["ios-review-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/review.png"+ ["ios-environments-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/environments.png"

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 150:
The publisher leaves `threads-light.png` and the four `ios-*-light.png` assets stale, so light-color-scheme visitors see outdated screenshots after a default `appearance: both` capture. `preview_sources` includes only `dark` paths; add the corresponding `light` mappings so both halves are refreshed.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Demo wheel hijacks inner scrolling

Medium Severity

The homepage attaches a capture-phase wheel listener on the demo iframe window that always calls preventDefault and stopImmediatePropagation, then scrolls the outer page. That runs before the demo’s own wheel handler, so sidebar, thread, and other inner surfaces never receive trackpad or mouse wheel input in the embedded hero.

Additional Locations (1)

• apps/web/src/demo/main.tsx#L50-L71

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Publish job skips light screenshots

Low Severity

publish_marketing_preview runs for dark and default both captures, but it only copies .../dark/... files into mobile-states. The homepage serves matching *-light.png assets in light mode, and those files are never refreshed by this job.

Additional Locations (1)

• .github/workflows/mobile-showcase-screenshots.yml#L83-L90

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[maria-rcks]

What Changed

• Redesigned the marketing homepage around the simpler visual system, shared atmospheric hero treatment, and updated product showcase.
• Reworked the download page with a cleaner release-channel switch, ordered platform rows, mobile store links, and official store artwork.
• Simplified the privacy and security pages to match the homepage, including quieter typography, white bullets, and streamlined navigation.
• Added deterministic web-demo fixtures and screenshot tooling for marketing assets, along with mobile documentation and refreshed Open Graph imagery.
• Linked the iOS and Android downloads directly from the README introduction, incorporating the README treatment from docs: link iOS and Android app store downloads #4902 alongside the dedicated mobile-app section.

Why

The marketing and legal surfaces had diverged visually, while the download experience mixed oversized store actions, icon-heavy release controls, and inconsistent page chrome. This brings those surfaces into one restrained design system and makes the product itself the focus.

UI Changes

Each comparison uses the same 1440 × 900 viewport and a slow, eased full-page scroll. “Before” is the current live t3.codes page; “After” is this redesign.

Page	Before	After
Homepage	old-home.webm	new-home.webm
Download	old-download.webm	new-download.webm
Privacy	old-privacy.webm	new-privacy.webm
Security	old-security.webm	new-security.webm

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes
• I included a video for animation/interaction changes

Validation:

• pnpm --filter @t3tools/marketing typecheck
• pnpm --filter @t3tools/web typecheck
• pnpm --filter @t3tools/web test -- src/branding.test.ts (186 files, 1,666 tests)
• pnpm exec vitest run apps/marketing/src/lib/releases.test.ts (2 tests)

Built with GPT-5.6 Sol via the T3 Code Codex harness.

---

Note

Medium Risk
Large marketing surface area and a workflow that pushes commits to the default branch with release-app credentials; marketing builds now depend on Chromium/Playwright and the web sidebar-demo build, increasing CI and local build time and failure modes.

Overview
Redesigns the marketing site around a shared layout with release-channel switching (Latest / Nightly / Dev), platform-aware behavior, Open Graph metadata, and a refreshed nav/footer.

The download page gains channel-specific GitHub release resolution (including nightly selection and macOS arch-aware asset URLs), a Dev “build from source” path, and clearer mobile store links. Legal pages can use a simplified layout without the on-page section nav.

Asset pipeline:dev/build now run the web sidebar demo build plus a Playwright capture script that produces feature crops and a WebGL-composited og-image.png. A CI job on the default branch copies dark mobile showcase screenshots into apps/marketing/public/mobile-states and auto-commits when they change.

README adds mobile app links and a mobile-app doc entry; store logos and mobile preview metadata are added under public/.

^{Reviewed by Cursor Bugbot for commit 47a4777. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Redesign marketing website with stage-aware downloads, live demo embed, and mobile app showcase

• Rebuilds the homepage (index.astro) with a live interactive demo iframe, a dynamic hero section, a new Remote+mobile section with iOS/Android store links, an FAQ section, and a redesigned CTA; removes the old harnesses/Git/open-source sections.
• Adds a release channel picker (Latest/Nightly/Dev) to the download page and homepage; download buttons resolve platform-specific asset URLs or copy a git clone command in Dev stage; selections persist via localStorage and sync across the page via a t3-marketing-stage-change custom event.
• Overhauls Layout.astro with Open Graph/Twitter/canonical metadata, stage-aware favicons, a layered blur nav, an expanded three-column footer, and an inline script that sets data-stage/data-platform on <html> at load time.
• Adds fetchNightlyRelease, findReleaseAssetUrl, selectNightlyRelease, and a 5-minute session cache to releases.ts to support nightly asset resolution.
• Introduces a standalone sidebar demo build (vite.demo.config.ts) that emits into marketing/public/sidebar-demo, a Playwright screenshot capture script, and a CI workflow step that auto-publishes mobile screenshots to the repo.
• Adds mobile app links to the Connections settings panel and user documentation.
• Risk: dev and build scripts now run build:sidebar-demo and Playwright screenshot capture before Astro, increasing build time and adding a Playwright dependency.

📊 Macroscope summarized 47a4777. 37 files reviewed, 0 issues evaluated, 0 issues filtered, 0 comments posted

🗂️ Filtered Issues

No issues evaluated.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 33e670f6-8118-4cf1-b840-009f61ddca2a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[t3-code]

maria confirmed this redesign already covers the app-store work in #4902: the shared store URLs, README mobile links, and mobile download section. #4902 should not be merged separately.

[macroscopeapp]

Approvability

Verdict: Needs human review

5 blocking correctness issues found. Diff is too large for automated approval analysis. A human reviewer should evaluate this PR.

^{You can customize Macroscope's approvability policy. Learn more.}

[macroscopeapp]

Reviewed the new Effect code in apps/web/src/demo/* (in-browser demo RPC backend, layers, fixtures, seeding) plus the touched web/marketing TypeScript against the Effect service conventions.

Namespace subpath imports, layer composition, WsRpcGroup.toLayer handler wiring, and the Effect.runFork(Layer.launch(...)) application boundary all look consistent with the conventions. One finding on error modeling at the dispatch boundary in apps/web/src/demo/server.ts.

^{Posted via Macroscope — Effect Service Conventions}

[StiensWout]

looking good! I like the style :)

[macroscopeapp]

🟡 Mediumlib/showcase-spec.json:15

All four showcase help links lead to invalid documentation targets: the encyclopedia.md and source-control-providers.md paths 404, while keybindings.md#defaults lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the href values to existing documentation paths and anchors, such as docs/user/source-control.md, or add the referenced pages.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/marketing/src/lib/showcase-spec.json around line 15:
All four showcase help links lead to invalid documentation targets: the `encyclopedia.md` and `source-control-providers.md` paths 404, while `keybindings.md#defaults` lacks that heading, so every link either shows a GitHub 404 or misses the promised section. Update the `href` values to existing documentation paths and anchors, such as `docs/user/source-control.md`, or add the referenced pages.

[macroscopeapp]

🟡 Mediumdemo/fixtures.ts:680

DEMO_COMPOSER_DIFF is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares -6 +9 but contains -3 +6 lines, the second declares -7 +16 but contains -2 +12, and the DropOverlay.tsx hunk declares +11 but contains +7; update the hunk counts or add the missing fixture lines.

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/fixtures.ts around line 680:
`DEMO_COMPOSER_DIFF` is not a valid unified diff, so the demo parser can truncate, merge, or reject the showcased composer changes instead of rendering them reliably. The first hunk declares `-6 +9` but contains `-3 +6` lines, the second declares `-7 +16` but contains `-2 +12`, and the `DropOverlay.tsx` hunk declares `+11` but contains `+7`; update the hunk counts or add the missing fixture lines.

[macroscopeapp]

🟡 Mediumdemo/main.tsx:56

The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe Window during capture, before this document listener is reached; register the handler on window instead so it runs at the window phase.

- document.addEventListener(+ window.addEventListener(

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/web/src/demo/main.tsx around line 56:
The demo's wheel handler never runs when embedded, so vertical gestures scroll the marketing page and internal demo surfaces cannot be scrolled. The embedding page stops propagation at the iframe `Window` during capture, before this `document` listener is reached; register the handler on `window` instead so it runs at the window phase.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:82

Overlapping runs can commit stale screenshots and source.json to the default branch, regressing a newer preview. publish_marketing_preview checks out the branch after capture but never verifies that github.sha is still current, and git pull --rebase can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 82:
Overlapping runs can commit stale screenshots and `source.json` to the default branch, regressing a newer preview. `publish_marketing_preview` checks out the branch after capture but never verifies that `github.sha` is still current, and `git pull --rebase` can successfully rebase and push the older assets. Serialize this publisher or abort when the branch has advanced before committing.

[macroscopeapp]

🟡 Mediumworkflows/mobile-showcase-screenshots.yml:150

The publisher leaves threads-light.png and the four ios-*-light.png assets stale, so light-color-scheme visitors see outdated screenshots after a default appearance: both capture. preview_sources includes only dark paths; add the corresponding light mappings so both halves are refreshed.

 ["ios-environments.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/dark/environments.png"
+ ["threads-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/threads.png"+ ["ios-thread-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/thread.png"+ ["ios-terminal-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/terminal.png"+ ["ios-review-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/review.png"+ ["ios-environments-light.png"]="$RUNNER_TEMP/mobile-showcase/iphone-6.9/light/environments.png"

🤖 Copy this AI Prompt to have your agent fix this:

In file @.github/workflows/mobile-showcase-screenshots.yml around line 150:
The publisher leaves `threads-light.png` and the four `ios-*-light.png` assets stale, so light-color-scheme visitors see outdated screenshots after a default `appearance: both` capture. `preview_sources` includes only `dark` paths; add the corresponding `light` mappings so both halves are refreshed.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Demo wheel hijacks inner scrolling

Medium Severity

The homepage attaches a capture-phase wheel listener on the demo iframe window that always calls preventDefault and stopImmediatePropagation, then scrolls the outer page. That runs before the demo’s own wheel handler, so sidebar, thread, and other inner surfaces never receive trackpad or mouse wheel input in the embedded hero.

Additional Locations (1)

• apps/web/src/demo/main.tsx#L50-L71

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}

[cursor]

Publish job skips light screenshots

Low Severity

publish_marketing_preview runs for dark and default both captures, but it only copies .../dark/... files into mobile-states. The homepage serves matching *-light.png assets in light mode, and those files are never refreshed by this job.

Additional Locations (1)

• .github/workflows/mobile-showcase-screenshots.yml#L83-L90

^{Reviewed by Cursor Bugbot for commit 47a4777. Configure here.}