Skip to content

infra: sync site to brand guidelines v2.22#293

Open
raymondk wants to merge 1 commit into
mainfrom
infra/brand-v2.22-sync
Open

infra: sync site to brand guidelines v2.22#293
raymondk wants to merge 1 commit into
mainfrom
infra/brand-v2.22-sync

Conversation

@raymondk

Copy link
Copy Markdown
Collaborator

Summary

Brings the docs site in line with the ICP/DFINITY brand guidelines v2.22 (2026-06-15). The CSS was stamped v2.2 (2026-05-08) and a few things had drifted or were never finished.

Correctness

  • Dark theme no longer auto-switches on system preference. Light is now the default; dark applies only via an explicit stored user choice. Fixed in both ThemeProvider.astro (FOUC-guard inline script) and ThemeSelect.astro (loadTheme), which both previously fell back to prefers-color-scheme: dark. The guidelines are explicit: light default, dark opt-in only, never auto.
  • theme-color meta tags added per the brand head template: #faf9f5 (light) and #14110d (dark).

Token / config polish

  • Dark CTA-bar inverse now stays near-black #1a1a1a (was #ffffff), with white inverse text, matching "CTA bar always near-black in both themes." (No component consumes these tokens yet, so no visual change today; this makes the pair correct for the first CTA bar that lands.)
  • Dark sunk background corrected #1b1812 -> #1f1b14 (sunk bark).
  • Dropped the off-system Inter 700 face (three-face system is Inter 400/500/600); bold/strong now map to 600 so emphasized prose renders a real loaded weight.
  • Bumped the CSS brand stamp to v2.22.

Still needs the design source (not in this PR)

The favicon is currently a base64 PNG wrapped in an SVG. The guidelines require a gradient-infinity vector on a transparent canvas plus raster sizes (16/32/48/192/512), an apple-touch-icon (+ dark variant), and a safari-pinned-tab.svg mask icon. These need the actual brand vector asset before the corresponding <link> head tags can be wired up without 404s.

Verified

  • npm run build passes; both theme-color tags confirmed in built HTML.
  • No remaining inter/700 reference.

- Theme: default to light; never auto-switch from prefers-color-scheme.
  Dark applies only via an explicit stored preference (ThemeProvider + ThemeSelect).
- Tokens: dark CTA-bar inverse stays near-black #1a1a1a (was #ffffff) with
  white inverse text; dark sunk background corrected to #1f1b14.
- Head: add the two brand theme-color meta tags (parchment / deep bark).
- Type: drop the off-system Inter 700 face; map bold/strong to 600.
- Bump CSS brand stamp to v2.22 (2026-06-15).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@raymondk raymondk requested a review from a team as a code owner June 15, 2026 01:36
@github-actions

github-actions Bot commented Jun 15, 2026

Copy link
Copy Markdown

🤖 Here's your preview: https://soxyi-6iaaa-aaaam-ai2ra-cai.icp0.io

@marc0olo

Copy link
Copy Markdown
Member

@raymondk I added the skills to the repo back then:

should we update those accordingly? I think at least the brand voice should stay to be used when docs are added/updated.

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