Skip to content

chore: refresh sei-docs to match new Sei brand (logo, favicons, fonts)#4

Merged
alexander-sei merged 2 commits into
mainfrom
chore/brand-refresh-fonts-logo-favicons
May 20, 2026
Merged

chore: refresh sei-docs to match new Sei brand (logo, favicons, fonts)#4
alexander-sei merged 2 commits into
mainfrom
chore/brand-refresh-fonts-logo-favicons

Conversation

@alexander-sei
Copy link
Copy Markdown
Collaborator

What is the purpose of the change?

Bring the docs visually in line with sei-website, sei-brand, and brand.sei.io. The current docs ship the legacy #9E1F19 Sei mark, Inter for body, and JetBrains Mono for code — all three diverge from the canonical brand. After this PR the docs match the rest of the Sei surface area.

Describe the changes to the documentation

Logo

  • logo/light.svg, logo/dark.svg: replace with the official Sei lockup (symbol + wordmark) from sei-brand. Old SVG used the legacy red mark + separately-colored wordmark; new lockups are unified black-on-light / white-on-dark, matching what the website ships.

Favicons

Matches sei-dashboard treatment — maroon Sei mark on transparent, no square background.

  • favicon.ico — canonical file from sei-website (identical MD5).
  • favicon.svg — new Sei mark in #600014, transparent canvas.
  • favicon-16x16.png, favicon-32x32.png, apple-touch-icon.png, icon.png, android-chrome-192x192.png, android-chrome-512x512.png — regenerated from the new SVG via rsvg-convert, transparent canvas.
  • Mirror under /favicons/* — Mintlify hardcodes <link rel="icon" href="/favicons/favicon-32x32.png"> etc. in its rendered <head>, so assets must resolve at that path too. (Verified: without the mirror, browsers fell back to Mintlify's default favicon even though the configured one was correct.)

Fonts — Lateral / Items Text / ABC Repro Mono

  • style.css: body → Lateral Variable, h1/h2 → Lateral Condensed Bold (the font-weight: 700 slot of "Lateral Variable" maps to Condensed Bold, matching how the marketing site does it), monospace → ABC Repro Mono. Expose --sei-font-body / --sei-font-display / --sei-font-serif / --sei-font-mono CSS vars. Drop the Google Fonts Inter import.
  • docs.json: fonts.family switched from Inter → Lateral Variable.

Important — fonts are NOT shipped from this repo. Lateral (NaN foundry), Items Text (Roj), and ABC Repro Mono (Dinamo) are commercial typefaces whose EULAs prohibit redistribution as raw .woff/.woff2. Since sei-docs is the only public repo in the family, committing the binaries here would expose them.

Instead, @font-face src: URLs and docs.json both point to https://dashboard.sei.io/fonts/* — a Sei-controlled property (sei-protocol/sei-dashboard, INTERNAL repo) that already serves these files with Access-Control-Allow-Origin: * from a Vercel edge CDN. .gitignore blocks /fonts/ with a comment explaining why.

Cleanup

Notes

Verified live against the running Mintlify dev server:

  • body computed font-family"Lateral Variable", ...
  • h1 / h2"Lateral Condensed", weight 700
  • code / mono labels → "ABC Repro Mono"
  • document.fonts shows all 6 faces successfully loaded from dashboard.sei.io: Lateral Variable 400/500/700, Lateral Condensed 700, ABC Repro Mono 400
  • /favicons/favicon.ico (the path Mintlify references) returns the new file's MD5
  • New lockup renders cleanly in both light and dark mode in the navbar

Out of scope (intentionally not in this PR):

  • llms-full.txt still references the old /Sei-Brand-Assets.zip path. It's auto-regenerated weekly by .github/workflows/regenerate-llms.yml from the live docs site, so it'll self-heal on the next run.
  • Uncommitted local edits to evm/*.mdx are unrelated to brand refresh and left for a separate PR.

🤖 Generated with Claude Code

Brings the docs visually in line with sei-website, sei-brand, and the
canonical brand.sei.io guidelines.

Logo
- Replace /logo/light.svg and /logo/dark.svg with the official Sei
  lockup (symbol + wordmark) from sei-brand. The old SVG used the
  legacy #9E1F19 mark and a separately-colored wordmark; the new
  lockups are unified black-on-light / white-on-dark.

Favicons (matching sei-dashboard treatment — maroon mark on transparent)
- favicon.ico: canonical file from sei-website (identical MD5).
- favicon.svg: new Sei mark in #600014 on transparent, no square bg.
- favicon-16x16.png, favicon-32x32.png, apple-touch-icon.png,
  icon.png, android-chrome-192x192.png, android-chrome-512x512.png:
  regenerated from the new SVG, transparent canvas.
- Mirror the same files under /favicons/ — Mintlify emits hardcoded
  <link> tags pointing at /favicons/* in its <head>, so the assets
  need to resolve at that path too.

Fonts (Lateral, Items Text, ABC Repro Mono)
- style.css: switch body to Lateral Variable, headings to Lateral
  Condensed Bold (700), monospace to ABC Repro Mono. Add CSS vars
  --sei-font-body / --sei-font-display / --sei-font-serif /
  --sei-font-mono for downstream use. Remove the Google Fonts Inter
  import.
- @font-face src points to https://dashboard.sei.io/fonts/* (a
  Sei-controlled property already serving these binaries with
  Access-Control-Allow-Origin: *). The fonts are commercial
  typefaces (Lateral by NaN, Items Text by Roj, ABC Repro Mono by
  Dinamo) — their EULAs prohibit redistribution as raw .woff/.woff2,
  so this public repo must not ship them. .gitignore now blocks
  /fonts/ with a comment explaining why.
- docs.json fonts.source updated to dashboard.sei.io.

Cleanup
- Delete stale local Sei-Brand-Assets.zip (8.2 MB, April). Brand
  consumers should use https://brand.sei.io/sei-brand-assets.zip.

Verified locally via the running Mintlify dev server:
- body computed font-family → Lateral Variable.
- h1 / h2 → Lateral Condensed weight 700.
- code / mono labels → ABC Repro Mono.
- document.fonts shows all six faces loaded (Lateral Variable
  400/500/700, Lateral Condensed 700, ABC Repro Mono 400) from
  dashboard.sei.io.
- /favicons/favicon.ico served from this repo matches the new file
  (Mintlify hardcodes that path in its <head>).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 20, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
sei-docs 🟢 Ready View Preview May 20, 2026, 10:06 AM

@cursor
Copy link
Copy Markdown

cursor Bot commented May 20, 2026

PR Summary

Low Risk
Primarily static asset and CSS/theme configuration changes; main risk is visual regressions or font-loading failures due to the new external CDN font dependencies.

Overview
Updates the docs site branding to the current Sei identity by swapping in new logo/light.svg + logo/dark.svg lockups and replacing the legacy favicon.svg (also adding a mirrored favicons/favicon.svg for Mintlify’s hardcoded paths).

Switches typography from Google Fonts (Inter/JetBrains Mono) to Sei brand fonts loaded via @font-face from https://dashboard.sei.io/fonts/, updates docs.json to use Lateral Variable, and adjusts heading/eyebrow/table/sidebar label weights to avoid unsupported mono bolding.

Adds /fonts/ to .gitignore with guidance to prevent committing commercial font binaries.

Reviewed by Cursor Bugbot for commit 8e15c27. Bugbot is set up for automated code reviews on this repo. Configure here.

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 1eb98d1. Configure here.

Comment thread style.css
Cursor review on PR #4 flagged that ABC Repro Mono only ships its
Regular (400) face on dashboard.sei.io, but three rules in style.css
used `font-weight: 500` with `var(--sei-font-mono)`:

- .sei-eyebrow (eyebrow / mono label utility)
- .prose thead th / article thead th / table thead th
- #sidebar h5 / h6 / [class*="uppercase"] (section headers)

Without a real 500 cut available, browsers synthesize a faux bold from
the regular glyphs, which looks blurry and inconsistent with the brand.
JetBrains Mono used to ship a 500 face; ABC Repro Mono doesn't (yet).

Fix: change all three rules to `font-weight: 400`. Visual hierarchy is
preserved through `text-transform: uppercase` + `letter-spacing` —
exactly how sei-website / sei-brand handle the same labels.

Also add a comment to the @font-face block warning future contributors
not to use `font-weight: 500` (or higher) with the mono family until
additional weights are hosted on the CDN.

Verified locally: sidebar section headers and table headers compute
`font-family: "ABC Repro Mono"`, `font-weight: 400` — no more
synthetic bold.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@alexander-sei alexander-sei merged commit be2afdc into main May 20, 2026
5 of 6 checks passed
@alexander-sei alexander-sei deleted the chore/brand-refresh-fonts-logo-favicons branch May 20, 2026 11:14
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