Skip to content

Dark mode polish, colophon, favicon, emoji sweep#29

Merged
spMohanty merged 4 commits intomainfrom
dev/website-editorial-theme-refresh
Apr 19, 2026
Merged

Dark mode polish, colophon, favicon, emoji sweep#29
spMohanty merged 4 commits intomainfrom
dev/website-editorial-theme-refresh

Conversation

@spMohanty
Copy link
Copy Markdown
Contributor

Summary

Follow-up pass after the initial design-system alignment landed on main. Four commits, all on top of d8ef4e51:

  • Dark-mode contrast fixesHeroHeadline now uses text-gray-900 dark:text-gray-100 (was hard-coded var(--gray-900), invisible on near-black). Sidebar active item in dark mode swapped from color-mix(--coral-light 50%, transparent) (muddy on dark) to color-mix(--coral 18%, transparent) with coral text. Also vendored /logo-dark.png from /design-system/brand/logo-current-dark.png and added a dark:hidden / hidden dark:block sibling pair so the hero brush mark swaps automatically.
  • Footer colophon — rewrote the credit line to "Whest. is built and maintained by AIcrowd and the Alignment Research Center." with external links to aicrowd.com and alignment.org (target=_blank rel="noreferrer noopener"). Wordmark rendered via .whest-wordmark, coral period intact.
  • Favicon — new public/favicon.svg (single coral #F0524D circle on transparent), per /design-system/brand/logo-system.html §03 size ladder which prescribes "< 16px · dot only" for favicons. Wired via icons.icon = [SVG, PNG fallback] in app/layout.tsx; logo.png retained as the Apple touch icon.
  • Emoji sweep — stripped all non-spec emojis from MDX headings across 8 files. The design system (README.md §Voice) permits exactly one emoji, U+2713 for copy/confirmation affordance; the two in-prose glyphs are preserved.

One notable gotcha documented during this pass (recorded in /design-system/IMPLEMENTATION_NOTES.md §20): Tailwind v4's @custom-variant dark (&:is(.dark *)); directive causes Lightning CSS to silently drop raw .dark <selector> rules from any file that declares the variant. The sidebar dark override had to move out of global.css (which declares the variant) into app/design-system/docs-surface.css.

Test plan

  • npm --prefix website test — 82/82 pass
  • Full hook suite (3283 core + 7865 numpy compat + 23 client-server parity) green during push
  • Visual: light + dark mode on /, /docs/getting-started/quickstart/, /docs/api/ops/histogram2d/
  • Favicon renders in browser tab on both themes
  • Footer links open in new tab with no referrer

- public/logo-dark.png: copied from design-system/brand/logo-current-dark.png.
  Hero renders /logo.png in light and /logo-dark.png in dark via
  dark:hidden / hidden dark:block sibling pair.
- HeroHeadline: replace inline color: var(--gray-900) with Tailwind
  text-gray-900 dark:text-gray-100 so the headline is legible on both
  surfaces. Coral period pulled from --coral token.
- Sidebar active item (dark mode): Tailwind v4's @custom-variant dark
  directive at the top of global.css caused raw .dark selectors there
  to be dropped by Lightning CSS. Move the override into
  docs-surface.css where the custom-variant is not declared.
  Rule applies color-mix(--coral 18%, transparent) and color: var(--coral)
  so the active leaf keeps a warm tint and pops against the near-black
  ground instead of reading muddy.
Footer now reads 'Whest. is built and maintained by AIcrowd and the
Alignment Research Center.' with external links to aicrowd.com and
alignment.org (target=_blank, rel=noreferrer noopener). Wordmark
renders upright via the .whest-wordmark utility class with the coral
period; surrounding prose stays in the paper-italic register.
Per /design-system/brand/logo-system.html §03 size ladder:
"< 16px · dot only — the whole identity compresses to the glyph."

- website/public/favicon.svg: minimal SVG, coral dot on transparent.
- app/layout.tsx: icons.icon is now an array — SVG first (scales cleanly
  for all favicon sizes), logo.png as PNG fallback. Apple touch icon
  stays on the brush logo.
- layout.shared.test.mjs: update favicon assertion to match the new
  metadata shape.
The design system permits exactly one emoji (U+2713 ✓, for copy/
confirmation affordance). Swept website/content/docs/**/*.mdx for any
character in the emoji ranges (U+2300-U+23FF, U+2600-U+27BF except
U+2713, U+2B00-U+2BFF, U+1F000-U+1FAFF) and removed them, normalizing
the two-space artifact on heading lines.

8 files / 21 codepoints stripped. Previously-decorative heading
prefixes like ✅, 🔍, ⚠️, 📎, 🟢, 🟡, 🔴 are gone. The two in-prose ✓
glyphs in contributing.mdx and flop-counting-model.mdx stay — both
are load-bearing per spec voice rules.
@spMohanty spMohanty merged commit 2aec67d into main Apr 19, 2026
16 checks passed
@spMohanty spMohanty deleted the dev/website-editorial-theme-refresh branch April 19, 2026 07:17
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.

1 participant