Skip to content

site: redesign landing + docs, promote @next install channel#3918

Merged
esengine merged 1 commit into
main-v2from
site/redesign-v3
Jun 11, 2026
Merged

site: redesign landing + docs, promote @next install channel#3918
esengine merged 1 commit into
main-v2from
site/redesign-v3

Conversation

@esengine

Copy link
Copy Markdown
Owner

Redesigns the website (landing + new docs page) on the new visual language, and fixes the install funnel: the old copy was still routing new users into the deprecated 0.53 line.

What changed

Install channel — the actual bug

  • Every install surface now reads npm i -g reasonix@next. The npm latest tag is pinned at v0.53, which is deprecated and unmaintained; the old hero command installed it by default.
  • The channel table marks @next (currently v1.5.0) as the recommended line and strikes through the 0.53 row as deprecated.
  • Desktop cards now serve the 1.x artifacts straight from the R2 latest/ manifest (.dmg universal / .exe / .tar.gz), version resolved at build time and refreshed at runtime. The 0.53 desktop links are gone; legacy versions live on the releases page.

Visual / layout

  • New visual language across both pages: Outfit + JetBrains Mono (self-hosted via fontsource, no external font requests), single blue accent, large-radius cards, pill buttons.
  • Hero: OS-aware download CTA (detects the visitor's OS, deep-links into the desktop tab and flashes the matching card), typewriter headline, terminal playback with live stat counters.
  • Scroll-driven "how the prefix cache works" narrative, bento feature grid, three-step quick start.
  • Community wall: real contributor avatars (linked to their profiles) with live stars / merged-PR counts fetched at build time, plus a baked fallback so a rate-limited build still shows real numbers.
  • New /docs/ page: sticky sidebar with scrollspy, copyable code blocks, content sourced from the real GUIDE/SPEC (config resolution order, permissions vs sandbox, MCP plugins, slash commands).

SEO

  • Per-page canonical + og:url on the reasonix.io domain (the docs page previously had no story here at all).
  • og:image social card, og:site_name/locales, full Twitter card tags.
  • sitemap-index.xml via @astrojs/sitemap, robots.txt, SoftwareApplication JSON-LD, branded 404 with noindex.

Build

Bilingual EN/中文 toggle, all animations behind prefers-reduced-motion, verified with a local astro build + preview pass on both pages.

… channel

The old page buried the install path and still presented v0.53 as the
default line. Rework both pages so the site sells what we actually ship:

- every install surface now says `npm i -g reasonix@next`; the npm
  `latest` tag is pinned at the deprecated 0.53 line and the old copy
  was routing new users into it
- desktop downloads now serve the 1.x artifacts from the R2 `latest/`
  manifest (version resolved at build time, refreshed at runtime);
  the 0.53 desktop links are gone
- community wall renders the real contributor avatars and live
  stars / merged-PR counts at build time, with a baked fallback so an
  unauthenticated or rate-limited build still shows real numbers
- SEO: per-page canonical/og:url on the reasonix.io domain, og:image
  card, sitemap via @astrojs/sitemap, robots.txt, SoftwareApplication
  JSON-LD, branded 404 with noindex
- fonts self-hosted (Outfit + JetBrains Mono via fontsource), no
  external font requests
- pages workflow passes GITHUB_TOKEN to the build so the GitHub API
  fetches are not anonymously rate-limited
@esengine esengine requested a review from SivanCola as a code owner June 11, 2026 02:59
@github-actions github-actions Bot added the v2 Go rewrite (1.x) — main-v2 branch, active development label Jun 11, 2026
@esengine esengine merged commit 9df1e96 into main-v2 Jun 11, 2026
14 checks passed
@esengine esengine deleted the site/redesign-v3 branch June 11, 2026 03:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

v2 Go rewrite (1.x) — main-v2 branch, active development

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant