Skip to content

Site cohesion: converge on the design-system canon + landing stack section - #2

Merged
NathanFlurry merged 2 commits into
mainfrom
NicholasKissel/site-cohesion-suggestions
Aug 12, 2026
Merged

Site cohesion: converge on the design-system canon + landing stack section#2
NathanFlurry merged 2 commits into
mainfrom
NicholasKissel/site-cohesion-suggestions

Conversation

@NicholasKissel

Copy link
Copy Markdown
Member

Summary

A 10-agent audit of the site against the CLAUDE.md design system (96 findings → 11 verified themes) found the canon had zero adopters: EYEBROW_CLASS, editorial/Eyebrow, and MarketingButton were imported by no page, and every surface hand-rolled its own labels, buttons, cards, and headings. This PR converges the whole site onto the existing canon, then reworks the landing page around a new product-stack section.

Design-system sweep (93cdda6)

  • Eyebrows — all section labels now use EYEBROW_CLASS / new EYEBROW_ON_INK_CLASS (27 off-canon tracking-[0.16em] variants eliminated)
  • Buttons — one metric (rounded-md px-4 py-2 text-sm font-medium) via the PRODUCT_HERO_* constants + new PRIMARY_INK_BUTTON_CLASS; the no-fill border-ink/20 ghost is retired; dead MarketingButton.tsx deleted; button canon documented in CLAUDE.md
  • Shadows — 21 outer drop shadows stripped from marketing cards/tiles/diagrams (inset edge-lights kept; modals/tooltips/dropdowns exempt)
  • Cards — flat bg-white/55 fills, border-ink/10 hairlines, p-7; white gradients removed; pricing tiers unified onto one light surface (InkPanel reserved for code/terminal/data); CatalogCard gains a highlight pine-frame prop
  • Legacy — zinc/shadcn tokens retokenized to ink/paper (ProblemSection, window chromes, TypesenseSearch, Header light branches); #FF4500 + rainbow hues replaced with theme tokens; blog prose now renders Prose surface="paper"
  • Headings — hand-written tracking converged onto HERO_H1_CLASS / SECTION_H2_CLASS / PRODUCT_HERO_H1_CLASS (which now includes depth-wash)
  • Shells — blog gains paper-grain; dynamic-apps/workflows/cloud gain the shared closing CTA; section rhythm unified on py-16 md:py-32; accent-spark rule restored (one ember per page on /startups and /agentos)
  • Shared kit — glow-pill surface and the deploy card/button kit promoted to single modules (glowPill.ts, deployKit.tsx); byte-identical duplicates deleted
  • Dead files removedSTYLING_CONSISTENCY_TODO.md (prescribed the retired dark theme), ArticleHeader, ArticleLayout, LandingHeader, PlatformIcons, CodeEditor (all verified unreferenced)

Landing page (9426070)

  • New StackSection after the hero: indexed catalog of the four products with Actors pine-highlighted as the primitive — Workflows and Dynamic Apps get their first homepage presence
  • Actors/agentOS deep-dive sections unmounted from the landing page (components kept in repo)
  • Workflows and Dynamic Apps get real logo SVGs in the house format (white rounded-square outline + glyph, matching Actors/agentOS), registered in productLogos so ProductLockup, ProductBar, DocsLanding, and the stack cards all upgrade at once

Verification

  • Production build passes: 421 pages
  • Greps: zero remaining tracking-[0.16em], retired ghost buttons, white card gradients, #FF4500, hand-written -0.035em/-0.025em tracking, or zinc tokens on marketing surfaces (sanctioned exceptions: Learn dark-shell branches, functional overlay shadows)
  • Browser pass over every touched page (200s) + screenshot review of the stack section, product heroes, product bar accent tiles, and docs landing

🤖 Generated with Claude Code

NicholasKissel and others added 2 commits August 12, 2026 00:25
A full-site cohesion audit found the design canon (typography.tsx
constants, editorial/* components) had zero adopters — every page
hand-rolled its own labels, buttons, cards, and headings. This sweep
converges the drift onto the existing canon:

- Eyebrows: every section label now uses EYEBROW_CLASS (tracking-[0.18em]);
  new EYEBROW_ON_INK_CLASS sage variant for dark panels
- Buttons: one metric (rounded-md px-4 py-2 text-sm font-medium) via the
  PRODUCT_HERO_* constants + new PRIMARY_INK_BUTTON_CLASS; the no-fill
  border-ink/20 ghost is retired; dead MarketingButton.tsx deleted
- Shadows: outer drop shadows stripped from marketing cards, tiles, and
  diagrams (inset edge-lights kept; functional overlays exempt)
- Cards: flat bg-white/55 fills (no white gradients), border-ink/10
  hairlines, p-7; pricing tiers unified onto one light surface;
  CatalogCard gains a highlight (pine-frame) prop
- Legacy: zinc/shadcn tokens retokenized to the ink/paper family;
  #FF4500 and rainbow hues replaced with theme tokens; blog prose now
  renders via Prose surface="paper"
- Headings: hand-written tracking converged onto HERO_H1_CLASS /
  SECTION_H2_CLASS / PRODUCT_HERO_H1_CLASS (now with depth-wash)
- Shells: blog gains paper-grain; dynamic-apps/workflows/cloud gain the
  shared closing CTA; section rhythm unified on py-16 md:py-32
- Shared kit: glow pill surface and deploy card/button kit promoted to
  single modules (glowPill.ts, deployKit.tsx)
- Deleted dead dark-era files: STYLING_CONSISTENCY_TODO.md,
  ArticleHeader, ArticleLayout, LandingHeader, PlatformIcons, CodeEditor

Verified: production build (421 pages), zero remaining hits for the
retired patterns, browser pass over every touched page.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ned logo

- New StackSection right after the hero: an indexed catalog of the four
  products (Actors highlighted as the primitive), giving Workflows and
  Dynamic Apps their first homepage presence
- Actors and agentOS deep-dive sections unmounted from the landing page
  (components kept); flow is now Hero -> Stack -> Observability ->
  Integrations -> Hosting -> On-Prem -> CTA
- Workflows and Dynamic Apps get real logo SVGs in the house format
  (white rounded-square outline + glyph, matching Actors/agentOS) and
  register in productLogos, upgrading ProductLockup, ProductBar,
  DocsLanding, and the stack cards in one place

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@NathanFlurry
NathanFlurry merged commit 4914264 into main Aug 12, 2026
2 checks passed
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.

2 participants