Skip to content

Dark-mode color contrast — Shiki comment token + homepage accents #299

Description

@Aliserag

T9 Lighthouse rerun A11y: 8/8 pages PASS (≥95). One remaining color-contrast issue on /, /docs/language/resources, /docs/ai-tools/mcp-server — score still 96 (was 76).

Specifics

  1. Shiki #6A737D comment token vs dark background #0a0a0a measures 3.65:1 (need 4.5:1 for normal text). Affects every code block in dark mode.
  2. Homepage text-[10px] text-green-600 accent labels measure 4.18:1 (need 4.5:1).

Phase 6.2 F-002 partial bumped light-theme --muted to #5d5d65 (4.85:1) but didn't touch dark-mode tokens.

Fix template

first-steps lands color-contrast = 1, so the same approach extends:

  • Override Shiki dark theme's comment color to #8a929d (5.0:1) via shiki.transformers or the dark theme override
  • Bump the homepage accent label color one stop darker

Acceptance

A11y category score 100 across all 8 page×form-factor combos in T9 fixture set.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions