Skip to content

docs: reimagine light theme with an ocean-blue accent and solid block colours#1419

Merged
mathuo merged 3 commits into
v8-branchfrom
claude/screenshot-capability-j0o4x5
Jul 8, 2026
Merged

docs: reimagine light theme with an ocean-blue accent and solid block colours#1419
mathuo merged 3 commits into
v8-branchfrom
claude/screenshot-capability-j0o4x5

Conversation

@mathuo

@mathuo mathuo commented Jul 8, 2026

Copy link
Copy Markdown
Owner

Description

Reworks the documentation website's theme into a modern, consistent design system, layered on top of the current v8-branch docs (all of its additions are preserved — menu colour, richer tables, code-comment contrast fixes, the enterprise badge, hero stats and the CTA section).

Highlights:

  • Ocean-blue accent (#2563eb), aligned with the blue brand mark, applied consistently across links, buttons, active sidebar items, section labels, focus rings, code keywords, the announcement bar and the newsletter widget — in both light and dark themes.
  • Solid block colours throughout — flat colour fields rather than gradients or semi-transparent tints on backgrounds and buttons.
  • Shared design-token layer (radii, elevation, border tokens, accent-soft tints) defined for both themes.
  • Tightened type scale — larger tracked headings, a lighter secondary lead paragraph, more generous and consistent section spacing.
  • Dark "ink" header for the light theme, scoped to the desktop bar (.navbar__inner) so the mobile slide-out menu stays light; the dark theme keeps its own dark navbar.
  • Component polish — solid primary button, feature cards with tinted icon tiles and hover lift, framework cards with hover states, rounded active sidebar pills, bordered inline-code chips, underlined h2s, and softer admonitions and code blocks.

Only two files change: packages/docs/src/css/custom.scss and packages/docs/src/pages/index.scss.

Type of change

  • Documentation

Affected packages

  • docs

How to test

  1. cd packages/docs && yarn start
  2. Open the homepage and any docs page (e.g. /docs/overview/introduction) and toggle light/dark.
  3. Verify: the light theme uses the ocean-blue accent with a dark header and flat block-colour fills; the active sidebar item is a solid pill; the dark theme keeps its own dark header. No gradients or translucent accent tints remain.

Checklist

  • yarn lint:fix passes
  • yarn format passes
  • npm run gen has been run and generated files are up to date
  • yarn test passes
  • I have added or updated tests where applicable
  • Breaking changes are documented

This is a CSS-only docs change; gen/test are not applicable and there are no behavioural or breaking changes. Run yarn lint:fix / yarn format before merge if the repo's style checks cover SCSS.

🤖 Generated with Claude Code


Generated by Claude Code

claude added 3 commits July 8, 2026 18:41
…and ink header

Rework the documentation website's theme into a modern, consistent design
system with a contrasting indigo/violet accent, layered on top of the
v8-branch docs (preserving its additions: menu colour, richer tables,
code-comment contrast fixes, enterprise badge, hero stats and CTA section).

- Contrasting indigo/violet accent applied consistently to links, buttons,
  active sidebar items, section labels, focus rings, code keywords, the
  announcement bar and the newsletter widget.
- Shared design-token layer (radii, elevation, border tokens, accent-soft
  tints and an accent gradient) defined for both light and dark themes.
- Tightened type scale: larger tracked headings, a lighter secondary lead
  paragraph, more generous and consistent section spacing.
- Dark "ink" header for the light theme, scoped to the desktop bar
  (.navbar__inner) so the mobile slide-out menu stays light; dark theme
  keeps its own dark navbar.
- Component polish: gradient primary button, feature cards with tinted icon
  tiles and hover lift, framework cards with hover states, rounded active
  sidebar pills, bordered inline-code chips, underlined h2s, softer
  admonitions and code blocks, and a soft accent glow behind the hero.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UsXiFK46kQJqAv5HtdYGiB
Flatten the theme to solid colour fields per design preference:

- Primary button now a solid accent fill with a solid darker hover, instead
  of the accent gradient and coloured glow shadow.
- Accent-soft background tints (feature icon tiles, active sidebar item,
  hover states, announcement bar) are solid block colours rather than
  semi-transparent rgba, in both light and dark themes.
- Section-label marker is a solid accent bar instead of a gradient.
- Removed the faded radial glow behind the hero.
- Ink-header search field uses a solid block instead of translucent white.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UsXiFK46kQJqAv5HtdYGiB
Change the theme accent to ocean blue (aligned with the blue brand mark)
across both light and dark themes: primary palette, solid block tints,
coloured ink header, code-keyword token, code-line highlight and hover
overlay. Class-name syntax tokens remain their conventional purple.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UsXiFK46kQJqAv5HtdYGiB
@mathuo mathuo merged commit 40605b2 into v8-branch Jul 8, 2026
7 checks passed
@sonarqubecloud

sonarqubecloud Bot commented Jul 8, 2026

Copy link
Copy Markdown

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