feat(seo): homepage landing hero, /zh/ mirrors, ranui design tokens#108
Open
chaxus wants to merge 1 commit into
Open
feat(seo): homepage landing hero, /zh/ mirrors, ranui design tokens#108chaxus wants to merge 1 commit into
chaxus wants to merge 1 commit into
Conversation
- Homepage: add a crawlable landing hero (#landing-hero) in the served HTML, shown on the bare homepage and hidden the moment a document opens; CTAs reuse the existing open/new flows. Add FAQPage + sameAs/isPartOf structured data. - Design system: the hero consumes the ranui design-token layer (public/ran-tokens.css, vendored from ranui/dist and re-synced by bin/build.sh) through --ran-* variables, inheriting ranui's dark theme; drop the hand-written light/dark overrides. - i18n: 8 Chinese /zh/ mirror landing pages with localized copy and JSON-LD, reciprocal hreflang on the 8 English originals, and 8 new sitemap entries. - Review fixes: single H1 (trimmed noscript), correct heading order, centralized landing show/hide in lib/ui.ts, AA-contrast --muted, dead-CSS cleanup, deduped octocat via <symbol>/<use>, and a class-name collision (.ghost watermark vs .btn.ghost) that blew the CTAs up to watermark size. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Deploying document with
|
| Latest commit: |
b82c4eb
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://0279169e.document-7hm.pages.dev |
| Branch Preview URL: | https://feat-seo-landing-hero.document-7hm.pages.dev |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What & why
The homepage was "too plain" for SEO/GEO — for JS users it booted straight into the editor, and the only crawlable content was a
<noscript>block. This adds a real, crawlable landing hero and a Chinese/zh/mirror set, built on the ranui design system so it stays consistent with ran.chaxus.com and the editor.Changes
Homepage hero
#landing-heroin the served HTML (H1, status line, document-window mock, 01/02/03 steps, feature grid, FAQ, GitHub "Open source" badge, ecosystem strip). Shown on the bare homepage; hidden the instant a document opens (all open paths + embed). CTAs reuse the existing open/new flows.FAQPage+sameAs/isPartOfstructured data (FAQ markup matches the visible FAQ verbatim).ranui design system
--ran-*: Geist,#006bffprimary, semantic colors, radius/space/shadow, built-in dark theme).public/ran-tokens.cssis vendored fromranui/dist/ranui.cssand re-synced on every build bybin/build.sh; linked beforehome.cssso tokens resolve on first paint.home.cssmaps its local aliases onto--ran-*and drops the hand-written dark overrides.i18n (
/zh/)hreflang(en / zh-Hans / x-default) on the English originals, and 8 newsitemap.xmlentries. Subdirectory, not subdomain (keeps authority consolidated).Review fixes
<noscript>), correct heading order, landing show/hide centralized inlib/ui.ts, AA-contrast--muted, dead-CSS cleanup, deduped octocat via<symbol>/<use>, and a.ghostclass-name collision (watermark selector was capturing.btn.ghostand blowing the CTAs up to 340px).Verification
pnpm run lint:ts✅ ·pnpm run format:check✅ ·pnpm run test✅ (240/240)Notes
docs/explorations/2026-07-09-seo-geo-traffic-playbook.md.@ranui/preview(fileview) landing page + the same token approach for/zh/are follow-ups, not in this PR.🤖 Generated with Claude Code