- README.md: what this is, how to run and build it, the folder map, how light and dark mode work (@hanzo/appearance, @hanzo/design), where every price and checkout link lives, scripts, and known differences from live - docs/build-notes/: status files, request notes, per-page checklists and reviews, plans - Removed: screenshot galleries, captures of third-party sites used as references, the generated status page and its script, editor config, a personal working-rules file - Code comments point at the new docs paths (no code changes) Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01P5YBdwj33XByFVTvu9bfci
13 KiB
/ide coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/IdePage.jsx (+ .css) · gallery: docs/gallery/ide/ · metric id: cta_click ide.hero
Open copy questions for James: none.
Shared changes requested (docs/build-notes/requests/ide.md): four UI strings for the register (Remember it, Recall, Nothing yet., One thing about your project); the Terminal and PageHero kit parts.
Forks this page deleted: the hand-written hero buttons (now kit Cta), the custom closing section (now kit Band), the tab row shared with /cli and /desktop, the grey code bars, every eyebrow, the indigo, orange, blue and green, springs.
Tick what applies. Strike the rest as n/a: reason. Fill each Done here: line with one or two sentences of evidence (a value, a file, a number). A part counts once its Done here: line has text.
1. Strategy and conversion
- Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
- One solid fill per viewport; label and href from
lib/cta.js - One h1; the page is clear in 5 seconds
No dead or self-looping button; prices fromn/a: no prices on this pagelib/plans.js- Open copy questions for James listed, none decided
Done here: Header lines Persona/Goal/CTA/Metric/Signature/Beyond in IdePage.jsx; one solid: kit Cta "Open the IDE" (ide.hero, thumb) in the hero and the kit Band at the end. lib/cta.js does not exist yet, so the label is Hanzo's own from the page.
2. Information architecture and navigation
- One
<main id="main">; skip link reaches it - Every link through
A,Go,Moreorhref(); every card a real link Breadcrumb at depth 2 or moren/a: depth 1- Link parity: 0 removed, 0 unexpected
Done here: One
(the layout's #main marker and skip link); links via kit A and Cta; parity links 10/10; depth 1, no breadcrumb.3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
PageHero; nothing above the h1- JS off: legible; no
opacity:0on the LCP element - One idea per 100svh; no 3 same-height sections in a row
- Ends in proof strip,
Band, footer - Card-to-page links use Morph; title lands within 12px
Done here: h1 52px cut in by line mask (A2Lines, 700 ms, 60 ms apart); the editor starts under the buttons and settles as you scroll; it moves within 1 s (measured). JS off (round 4, measured with JavaScript disabled at 1470 and 375): 0 hidden text blocks; the stage lies flat with the editor under the ask (html:not(.js) rules). Ends: Get IDE and related cards, then kit Band, then footer. CLI, Playground and Desktop are Morph cards. PageHero is not in the kit yet.
4. Conversion system
<Cta>only; no raw.x-btn- Sticky ask in header and bar after the hero, same label (desktop: the header carries "Open the IDE" after the hero; phone:
usePhoneAskkeeps one solid at a time, but "Open the IDE" does not fit the phone header without clipping, so it stays "Try Hanzo"; request indocs/build-notes/requests/founder.md) - Copy button copies exactly the displayed text; failure never says Copied
data-ctaanddata-thumbon every primary
Done here: Kit Cta only (solid hero, quiet and link secondaries); the ask bar carries "Open the IDE" via data-thumb; Copy copies the exact prompt and script text.
5. Trust and proof
- No logo without documented permission; no seal; no invented number
Every figure traces to Hanzo's copy; qualifier beside the numbern/a: no figures on the pageMarquees pause, freeze under reduced motion, hide duplicatesn/a: no marqueePrivacy link and owner line beside every submitn/a: no form sends anything (the memory demo is local)
Done here: No logos, seals or figures; Apache 2.0, GitHub and Open VSX as Hanzo states them.
6. Content presentation (copy untouched)
- No text under 13px (14px phone) except mono capitals
- Measures held; no orphan word in a heading
- Tables, FAQ, tabs and code use the kit parts
python3 scripts/parity.py /ide: 0 missing
Done here: Deck sizes: h1 52, section 26, H3 17, lede 21, body 16; product render text 13px or more. Parity 75/75 text, 10/10 links. The accordion and the typed script are page-owned until kit parts fit them.
7. Visual design system
python3 scripts/taste.py <files>passes; no literal hex outside tokens- No label, tag, badge or pill above a headline
- Radii, shadows and sizes from tokens; never box plus shadow
- One icon set; no icon in a rounded box
- Differs from neighbours in hero medium and room order
Done here: taste.py passes; brows check: 0 labels above a headline; radii 24/16, no shadows on tiles; hand-drawn glyphs (pause, add, recall) until the Lucide set is in the kit; round 9 keeps the Teach room as one sheet in three hairline-divided columns (no fills on the columns, only on the remembered rows); every off-deck grey literal in IdePage.css (#f5f5f7, #16161a, #1b1b20, #1e1e23, #1c1c1f, #48484e, #d1d1d6, #a1a1a6, #6e6e73, #0b0b0c, #86868b, #26262c, #e9e9ec and the #b5b5b5–#c7c7cc family) replaced in the file by deck values (#fafafa, #171717, #262626, #737373, #a3a3a3, #d4d4d4, #e5e5e5, #ededed) in round 5; the chapter code reads at white 55% on #171717 with whole lines. No three equal boxes: memory kinds 5/4/3, related apps as 72px hairline rows.
8. UI component library
- Every control has hover, press, focus-visible, disabled, loading
- Focus ring visible on every stop of a Tab crawl
Dialogs are native, trap focus and return itn/a: no dialog on this page- Inputs 16px or larger; no bare
:hover - Forks this page deleted: the hand-written hero buttons (now kit Cta), the custom closing section (now kit Band), the tab row shared with /cli and /desktop, the grey code bars, every eyebrow, the indigo, orange, blue and green, springs. listed below
Done here: Buttons press to .97/.98, focus ring from the system; the dark-room rows take a 6% white fill and the plus slides 4px on hover, Pause outlines on hover; the editor's Pause fills white 8%, the memory kinds take a #f5f5f5 fill and darker border, related rows fill #f5f5f5; hover rules only inside (hover: hover); the memory input is 17px.
9. Motion and interaction
- One signature, at most 3 supporting techniques, at most 2 fade-ups
- At least 3 kinds of movement; scroll-linked is half or less
- Something moves without input; every control answers
- Reduced motion shows the final state; no
setInterval - Sound only on the listed moments, through the one kit
Done here: Signature: the editor that remembers (time) in the Stage settle (scroll); supporting: exploded planes, pinned chapters, A2Grow statement, typed script; kinds: time, state, pointer, scroll, arrival; variety.py OK; reduced motion shows final states (0 running animations, chips at opacity 1, measured); no setInterval. Round 9: the editor holds its finished picture 1.5 s after first paint, then the memories leave in order (60 ms apart) and the agent's session in reverse before the replay, so the first painted frame is the first animated frame; it starts at its own size (no 1.04 pop: .ide-obj 1200px wide at 150 ms and at 1000 ms). The hero words are gone (opacity 0 by 19% of the stage) before the rising editor reaches them. The chapter pictures and the Rust plane play short idle loops (memories recalled in turn, the impact radius pulsing, the audit trail ticking, the engine's four parts lighting in turn), each under 5 s and only once on screen: motion.mjs desk reports 0 still screens (it reported 3 before).
10. Media
n/a: no images or films on this pageFilmandPiconly; sizes and posters setAt most 2 videos playing; pause button on loops over 5 sn/a: no videoBudgets met; nothing missing; alt on every imagen/a: no imagesNo dimmed or filtered photo; 4+ real visuals together where the page has themn/a: Hanzo has no IDE media
Done here: No media on this page: the editor and the planes are drawn in the DOM with Hanzo's real text.
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll at 320
- Every target 44px or more; every hover has a tap path
- Primary ask above the fold at 375×667
Done here: 1470x801 and 375x812 checked (no overlap). Round 9 (8 Nov), measured: in the chapter-01 picture each memory now sits in the flow of its own line, so a chip-bearing line's text ends at or before the chip's left edge minus 12px (1470: 1053 vs 1071, 759 vs 935, 851 vs 995; 375: 243 vs 255, 128 vs 259, 221 vs 245), and in the hero editor the text clears chip plus dashed lead (807 vs 939-64 at 1470, 216 vs 275-24 at 375); the start script's long last line wraps instead of being cut at the panel edge. 320 scrollWidth 320; ask bottom at 540px on 375x667; a phone target crawl of
(7 Nov, round 3) finds 0 controls under 44px: View on GitHub, GitHub and Hanzo Cloud now have a 44px box, the app links in the close are 44px rows. Round 5: the memory kinds stack to one column under 900px (the 5/4/3 split is desktop only) and the keychain sits below the sandbox label on phones, re-shot at 375 with no overlap. The gutter memories are no longer focusable (their words are in the caption and the Teach room), so they are not targets.12. Accessibility (WCAG 2.2 AA)
- Contrast measured, text at 4.5:1 or better
- Pause control on every moving item
- Forms labelled; first error focused
- One h1; no heading skips; names start with visible text
- Keyboard reaches every control
Done here: Body and labels use #0a0a0a/#525252/#737373 on white; pause controls on the editor loop and the tier motes (the chapter and plane idle loops stop by themselves in under 5 s, so they need none); the memory input has an accessible name; one h1, then h2 and h3; every control is a button or link.
13. Performance and engineering
- h1 and LCP element in server HTML
- JS and CSS inside budget; every image and video sized
- No poller; no third-party request before consent
- Nothing heavy run on James's laptop
Done here: h1 and editor in server HTML; transform and opacity only; loops stop off screen or when paused; budgets not yet measured (no CI).
14. SEO and machine files
- Title and description match live (or are listed for James)
- Canonical equals og:url equals the live URL
<JsonLd route>parses; no broken URL- Every card is a real link
Done here: app/ide/page.jsx metadata unchanged from content/pages.json; JsonLd route=/ide; cards are real links.
15. Catalogue and product pages
Model card matchesn/a: not a catalogue or model pageSPEC.md(or n/a: not a catalogue or model page)- Every card opens by Morph
Every maker and model page linked in the DOMn/a: not a catalogueOne price figure everywheren/a: no prices
Done here: Not a catalogue; the related app cards open into their pages by Morph.
16. Developer experience
- One
CodeBlock; copy equals display (or n/a: no code on the page) Config blocks parse on their ownn/a: no config on this page- Terminal pauses and ends on a static frame
- No hand-typed version number
Done here: The paste strip and the start script copy exactly what they show; the script types once and ends on its full text; no version numbers. Page-owned until the kit Terminal lands.
17. States and resilience
- Loading, empty, error and offline states designed
- Blocked live data leaves a complete page, no console errors
A failed submit keeps its values and shows no successn/a: no submit- A thrown island does not blank the page
Done here: The memory demo has an empty state (an em dash named Nothing yet.); no live data, so nothing can fail; no error boundary of its own yet.
18. Measurement and handover
data-ctaon every primary; events only throughlib/track.js- Nothing identifier-bearing before consent; no field value in a payload
V2: <score>/10 <one line>in the page file's top comment- Review read:
docs/build-notes/review/ide.mdverdict 8 or more
Done here: data-cta on ide.hero; the kit Band's button has no data-cta yet (requested); Cta sends cta_click through the system event; V2 line in the header; reviews read: 6/10, 6/10, 7/10, 6/10 (7 Nov). Round 9 (8 Nov) answers review round 8: chips can no longer cover code (they sit in the flow of their line in the chapter picture, and the hero lines reserve chip plus lead, measured at 1470 and 375); no arrival pop or wipe (Stage starts at scale 1; the editor holds the finished picture 1.5 s, then the memories leave in order); the stage shadow is the deck's floating shadow with overflow: clip; overflow-clip-margin: 64px, so no straight cut at a 1443px scroll; the Teach tiles are one hairline sheet; the kit Band items are re-filed in docs/build-notes/requests/ide.md. Round 7 answered the one before: phone chapter items end at x 359 at 375 (round 6 had pushed them to 554), the editor rests under the ask in normal flow (top at y 490 at 1470 from first paint), the h1 cuts in by CSS from the first paint, and the page's own Lines and Room replace the shared A2Lines and A2Room so reduced motion hydrates with 0 errors (measured at 1470 and 375). Round 6 answered the one before it (whole code lines, reduced motion lays the stage flat, less air, hovers, Teach placeholder).