docs: apply the Metis design system - #1
Merged
Conversation
Add the tetradrachm mark and the METIS / component header to the README, align the badges with the design-system palette, and ship the brand kit under docs/brand (mark, lockups, favicon, tokens, social preview). The mark is drawn from Bodoni's M rather than a live U+039C: Bodoni Moda ships no Greek mu, so the kit's own SVGs fall back to Georgia and lose the high-contrast strokes the type spec describes. Greek capital mu and Latin M are the same letterform; the sizes are corrected so the cap height is unchanged. Every SVG here is outlined, so it renders without the webfonts.
CI installs the dev extra unpinned. ruff 0.16.0 landed on 2026-07-23 and added rules that fire on code this repo already had: 41 findings across 24 files that nobody touched, in a branch whose diff is a README and some images. Checked against this tree: ruff 0.15.21, the newest release when CI was last green on main, reports "All checks passed"; 0.16.0 reports 41 errors. Capping restores the gate. Lift the bound together with a pass over the new findings.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Applies the Metis identity to the repository: a
METIS / BENCHMARKhero on paper ground with the tetradrachm mark, the claim set in Bodoni Moda, and the meta row in Plex Mono.Kit — mark (display, small, bronze, outline, reversed), the three lockups,
metis-tokens.css, the favicon and the social preview. Every SVG is outlined, so it renders the same with or without Bodoni Moda and Cormorant Garamond installed.Badges — labels take Ink
#14181A; technology badges keep their own brand colour because they are citations; project metadata takes Slate#5C6567. The licence badges were red, which is a verdict colour the system reserves for a fired stop rule, so they are neutral now. No bronze in the badge row: the hero already spends the one accent this view gets.One thing to know about the mark — Bodoni Moda ships no
U+039C, so the live Greek mu in the kit falls back to Georgia and the mark loses the high-contrast strokes the type spec describes. Greek capital mu and Latin M are the same letterform, so the outlines are drawn from Bodoni's M with the size corrected to keep the original cap height. Screenshot of the difference is in the thread.The social preview has to be uploaded by hand under Settings → General → Social preview; GitHub exposes no API for it.
Social preview file:
docs/brand/metis-benchmark-social-preview.png