Skip to content

Landing page: the agent-native positioning, in the reader's language without React #418 (#8) - #64

Merged
doxuta merged 5 commits into
mainfrom
slice/landing-copy
Oct 27, 2026
Merged

doxuta merged 5 commits into
mainfrom
slice/landing-copy

Conversation

@doxuta

@doxuta doxuta commented Oct 22, 2026 •

Copy link
Copy Markdown
Owner

Closes #8

What changed

The landing page (/, components/screens/Landing.tsx) described Nexus as an internal software factory ("nhà máy nội bộ", "90/10", "Bàn giao", "nền tảng nội bộ, không phải SaaS"). It now states the README's positioning, in the same layout and components:

  • Hero: "Agent sửa mô hình của app. Người duyệt và xuất bản." / "Agents edit the app's model. People review and publish." CTAs: sign in to the demo (/login) and the source on GitHub.
  • The loop (the three-step row): an agent proposes → a person applies and publishes → staff use the app (and you roll back a wrong version). The rollback limits (attribute edits not reverted; applied-at-once changes undone one by one with Revert, README:209-211) are on the versions card.
  • What is different (the six-card grid): review one change, not a code diff · draft, publish, roll back · tenant and row access, tested as a non-admin (and that isolation is a convention plus tests, ADR 0005) · agents from outside, over MCP · measured AI · one command to run.
  • Try it (was "Vertical"): the demo login, the README, the write-up "Turning the lights back on".
  • Footer: open source, MIT. The (marketing)/page.tsx title and description follow.

Numbers on the page are only the README's, with its qualifiers: two recorded demo runs (vi and en, since #58) replayed in CI; builder-bench measured on 2026-10-17, 20 requests, pass@1 0.85 for claude-haiku-5-5 (60 attempts) and for claude-opus-5-5 (one attempt per case); MCP tool-use eval 5 of 5, one run per task with claude-opus-5-5. No harness-eval number.

Language and React #418

The copy lives in lib/i18n as a landing.* block in vi.ts and en.ts (38 keys, Vietnamese first, English for every key). The README's English-catalog count now includes them: 1,012 of 6,868.

The server cannot know the reader's language and renders Vietnamese. lib/i18n now exports useHydratedLocale(): Vietnamese on the server and through hydration, so the hydrated text matches the server HTML, then getLocale() right after. It shares useLocaleReady's noSubscription; useLocaleReady stays for AuthShell, which renders nothing until hydration. The landing must show its text before hydration (no-JS, crawlers), so it uses the new hook. With #58 merged, a saved preference, ?lang=en and an English browser all switch it.

Round 2 (verifier round 1)

  • MEDIUM fixed: "Safe by construction" → "Tenant and row access, tested as a non-admin" / "Quyền theo tổ chức và theo dòng, kiểm bằng người không phải admin"; the body says "by rule" and that isolation is a convention plus tests, not database-level security (ADR 0005, SECURITY.md, README).
  • "not 2,000 lines of code" → "not a code diff" / "không phải diff code".
  • Measured AI: "one recorded demo run", measured on 2026-10-17, haiku 60 attempts, opus one attempt per case, MCP one run per task with claude-opus-5-5. No harness number.
  • Rollback limits follow README:209-211 (re-hides newer schema, deletes nothing, attribute edits not reverted, applied-at-once changes undone one by one with Revert); after round 2 they sit on the versions card, and "recorded demo runs" is plural (CI replays the vi and en cassettes).
  • MCP title: "Agents from outside, over MCP" ↔ "Agent bên ngoài, qua MCP"; eyebrow "DÙNG THỬ"; no em dash in the OpenGraph alt.
  • The copy test now also fails on "by construction", "theo cấu tạo" and "2,000/2.000" (red with the old English title, green restored).
  • Merged origin/main (English path for the demo screens: 421 keys measured and translated, ?lang=en, persona follows the user (#6) #58) and moved the hook into lib/i18n as above.

Evidence

Screenshots: node shots.mjs (scratch script with ui-shots.mjs's checks, page errors and horizontal overflow, plus console hydration errors, prefers-reduced-motion so every Reveal section shows; the landing is anonymous, no API needed). Four readers: Vietnamese default, saved English preference, ?lang=en, English browser; 1440 and 390.

  • Before (origin/main 8bc1b94): /private/tmp/claude-501/landing/before/root-vi-1440.png, root-vi-390.png.
  • After, round 2, production build (next build + next start): /private/tmp/claude-501/landing/round2-prod/root-{vi,en-pref,en-query,en-browser}-{1440,390}.png and report.json: shots=8 bad=0, 0 page errors (a production #418 would surface as one), 0 overflow; h1 Vietnamese for vi, English for the three English readers. Server HTML holds the Vietnamese h1 and title.
  • Round 1 browser mutation (rendering with getLocale() directly, as useT() does): pageErrors=1 on every English reader, "Hydration failed because the server rendered text didn't match the client".
  • Click-through on the production build: the hero's "Đăng nhập bản demo" lands on /login; links point at the repo, #readme and the write-up (both 200).

Test components/screens/Landing.test.tsx (7): Vietnamese by default with the four links; English for a reader who chose English; server render (Vietnamese) hydrated for a saved preference, ?lang=en and an English browser with no recoverable error and no hydration log, then English; every landing.* key has English; no factory framing, "by construction", unmeasured number or em dash. Mutation: useHydratedLocale with getLocale as its server snapshot turns the three hydration cases red (Tests 3 failed | 4 passed (7)), green when restored.

Gates

From nexus-web/ after the merge (node_modules symlinked, not committed):

npx tsc --noEmit                                   → exit 0, no output
npx eslint "app/(marketing)/page.tsx" components/screens/Landing.tsx components/screens/Landing.test.tsx lib/i18n/index.ts lib/i18n/vi.ts lib/i18n/en.ts
                                                   → exit 0, no output
npx vitest run components/screens/Landing.test.tsx lib/i18n test/type-scale-gate.test.ts test/studio-style-gate.test.ts components/screens/AuthShell
                                                   → Test Files  5 passed (5) · Tests  36 passed (36)
npx vitest run --changed origin/main               → Test Files  493 passed (493) · Tests  5298 passed (5298)
npm run build                                      → ✓ Compiled successfully in 12.0s · ┌ ○ /  (still static)

Not done

  • /about (AboutScreen.tsx, "nhà máy 8 bước") and lib/help-content.ts still describe the internal factory; not the landing page, so left for another issue.
  • The OpenGraph image is still the CRM crop and the title/description are Vietnamese only (metadata renders on the server).

🤖 Generated with Claude Code

doxuta and others added 5 commits October 22, 2026 11:49
The landing described Nexus as an internal software factory (90/10,
handover, "nền tảng nội bộ"). It now says what the README says, in the
same layout: agents edit a typed, versioned, permissioned model; people
review, publish and roll back. Sections: the loop (propose, apply and
publish, use), what is different (review one change; draft, publish,
roll back; safe by construction; MCP; measured AI with the README's
numbers only; one command), try it (demo login, README, write-up).

The copy moves into lib/i18n as a landing.* block in vi.ts and en.ts.
The server renders Vietnamese, so the locale is read through
useSyncExternalStore with a Vietnamese server snapshot: hydration
matches the server HTML (no React #418), then the page re-renders in
the reader's language.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Verifier round 1 on #64:
- "Safe by construction" contradicted ADR 0005 and SECURITY.md
  (isolation is a convention plus tests). The card is now "Tenant and
  row access, tested as a non-admin" and says that in its body.
- "not 2,000 lines of code" was an unmeasured number: "not a code diff".
- Measured AI: the date, the attempts per model, MCP one run per task,
  and "one recorded demo run" instead of "model runs are recorded".
- The loop's rollback line follows the README: newer schema re-hidden,
  attribute edits not reverted, applied-at-once changes undone one by
  one with Revert.
- MCP title means the same in both languages; "DÙNG THỬ"; no em dash in
  the OpenGraph alt.

The copy test now also fails on "by construction" and on the number.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ng (#8)

The landing kept its own useSyncExternalStore hook beside #58's
useLocaleReady. lib/i18n now exports useHydratedLocale (Vietnamese on
the server and through hydration, then getLocale), sharing
useLocaleReady's noSubscription; useLocaleReady stays for AuthShell,
which renders nothing until hydration.

The hydration test runs the three ways a reader gets English: a saved
preference, ?lang=en, an English browser. The README's English-catalog
count includes the landing keys: 1,012 of 6,868.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Since #58, CI replays a Vietnamese and an English recording, so the
measured-AI card speaks of recorded runs in the plural. The rollback
limits move from the loop's third step into the versions card, which
keeps the step short.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@doxuta
doxuta merged commit 58849e6 into main Oct 27, 2026
7 checks passed
@doxuta
doxuta deleted the slice/landing-copy branch October 27, 2026 04:38
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.

Landing page copy: the new positioning

1 participant