Skip to content

feat(report): first-visit guide and Tutorials button (ships off, T-024) [rebased #157] - #161

Merged
razel-hash merged 1 commit into
mainfrom
lane/aeo-guide-r2
Nov 10, 2026
Merged

razel-hash merged 1 commit into
mainfrom
lane/aeo-guide-r2

Conversation

@razel-hash

Copy link
Copy Markdown
Collaborator

What

TDD task AEO-T-024 / FR-017 / AC-023: a first-visit guide on the report. It ships off.

  • ReportGuide: adds a Tutorials button to the report header, next to Share and Download PDF, and a card with 3 short steps: your score, what each AI engine said, and unlocking the full report.
  • First visit: the card opens once per browser, 0.6 s after the report paints. The browser remembers it was seen (aeo-report-guide-v1). The Tutorials button replays it.
  • Closing: Skip, Done or Esc closes the card. The card takes focus when it opens.
  • Layout: on desktop the card sits bottom-right. On phones (≤480 px) it spans the screen with a 16 px gutter. It uses design tokens, respects the reduced-motion rule once feat(a11y): input names, reduced motion, tokens on report states (T-023) #156 lands, and uses tabular numbers on the step counter.
  • Off switch: nothing renders unless NEXT_PUBLIC_AEO_GUIDE=on. Turning it on is RJ's call (a Vercel env value plus a redeploy).

Not built: a "What's new" entry, because the AEO site has no What's new feature.

Pipeline: /tdd (ReportGuide.test.ts failed first because the module didn't exist; it checks the flag, the first-visit rule, the button and the step copy) → tsc → full suite

Risk

  • None while the flag is off, because the component renders nothing.
  • When on, visitors see the card once per browser. Clearing site data shows it again.
  • Rollback: unset the flag, or revert the PR.

Code review: self-review only (a small UI component behind a flag).

Not verified: the card in a real browser, including focus, the 390 and 1280 px layouts, and how it sits next to the report's own overlays. That needs the flag on in a preview. It's in the lane handoff as a step for RJ.

Checks: npx vitest run passed 202/202 tests in 15 files. npx tsc --noEmit is clean. eslint is clean on the new files.

🤖 Generated with Claude Code

…LIC_AEO_GUIDE

Three short steps (score, engines, unlock), shown once per browser after the report
paints, replayed from a Tutorials button in the report header; Esc or Skip closes.
Renders nothing unless NEXT_PUBLIC_AEO_GUIDE=on, so it ships dark.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 10, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
campaign-creators-aeo-auditor Ready Ready Preview Nov 10, 2026 1:21pm UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — f87165a2 Deployed Nov 10, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant