Migrate UI to GitHub Primer design system#9
Conversation
Replace custom CSS with GitHub's Primer design tokens and conventions to give the site a familiar, trustworthy look that matches the platform it reports on. This helps build community confidence in an unofficial tool. - Add @primer/css v21 via CDN for base styles and design tokens - Replace custom color vars with Primer semantic tokens (--fgColor-*, --bgColor-*, --borderColor-*) - Use Primer typography scale (--text-title-shorthand-*, --base-text-size-*) - Use Primer spacing primitives (--base-size-*, --stack-gap-*, --stack-padding-*) - Align responsive breakpoints to Primer's system (544/768/1012) - Style badges, buttons, and panels to match Primer component patterns - Remove Google Fonts in favor of Primer's system font stack - Remove decorative grain texture for cleaner GitHub aesthetic
|
Hi! As the self-proclaimed Chief Design Officer of this repository, I did the direct side-by-side comparison, and I don’t think this one should merge as-is.
The main problem is that it makes the page louder without making it clearer. The current version is easier to scan, and this one feels more “Primer-looking” than actually better for the job this page has to do. A concrete example is the color choice in the uptime bars. Right now they use strong UI-state colors like If you want to stay inside Primer, I’d rather see the data palette used instead. For example:
The other big issue is mobile: once the 90-day bars wrap into multiple rows of squares, they stop reading like a timeline. At that point readability gets sacrificed for a more generic Primer look. So I’d pass on merging this version. If you want to take another swing at it, I’d rather see a smaller pass that keeps the current information design and only borrows the parts of Primer that actually improve clarity. cc @mrshu |
|
Please don't merge this |

Summary
Why Primer?
Since this site documents GitHub's own reliability data, using GitHub's visual language creates an implicit association that builds trust in the community, even with a clear "unofficial" label. When users land on the page, the familiar GitHub aesthetic signals credibility and care, rather than feeling like an unrelated third-party tool. Primer is open source (MIT) so there are no licensing concerns.
The site's existing color palette was already very close to Primer's tokens (
#24292f,#0969da,#2da44e,#cf222e, etc.), so this is a natural alignment rather than a forced reskin.What changed
site/index.html: Added@primer/cssv21 via CDN, removed Google Fonts preconnect/import, removed grain texture divsite/styles.css: Full rewrite (~1500 lines removed, ~630 added) using Primer design tokens throughout:--fgColor-*,--bgColor-*,--borderColor-*semantic tokens--text-title-shorthand-*,--base-text-size-*,--base-text-weight-*--base-size-*(4px grid),--stack-gap-*,--stack-padding-*--borderWidth-thin,--borderRadius-medium/small/fullNo changes to
app.jsor data processing, this is purely a CSS reskin.Test plan