About GitHub DESIGN.md
Curated by Dov AzencotUpdated Source github.com
- Developer Tools & IDEs
GitHub's marketing canvas is a developer-console aesthetic translated into magazine restraint. The page floor is "#0d1117" — the canonical dark-mode surface that ships inside the product itself — with full-bleed "#000000" bands cutting in for hero openers and the Copilot CTA region. Body and headline ink hold "#ffffff" against the dark; the single load-bearing chromatic token is an arctic pale-blue "#8dd6ff" that lights every link rest, hero pill stroke, and Copilot CTA label across the page. Where most developer platforms reach for a brand purple or electric green as primary voltage, GitHub keeps the link blue dominant and reserves "#5fed83" for activity-glow gradients only — never for buttons. The hero atmosphere is a purple-to-indigo radial ("#9350ff", "#5049c2", "#7873cb", "#0e0aa2") sitting behind the Copilot IDE mockup, a single glow event rather than a system-wide gradient language.
This page packages the surface into one DESIGN.md file written to the Google Labs spec. Inside: 21 color tokens grouped into canvas, surface ladder, ink, link/accent, success/danger, and the indigo atmospherics; 12 typography levels covering Mona Sans variable-weight display from 64px down to 12px caption plus ui-monospace for code-tab labels; a 7-step rounded scale running 6px / 8px / 12px / 16px / 24px / 48px / 60px-pill / circle; a 9-step spacing scale anchored at the 4px base unit and topping out at the 96px section rhythm; and 19 component definitions covering the dark top-nav, search field, primary and secondary buttons, the pill segmented switcher, code-tab IDE surface, customer-story card, Copilot prompt card, workflow-runs table, and the customer logo strip.
Feed the file to Claude, Cursor, or Copilot and the agent reproduces GitHub's restraint — single arctic-link-blue voltage, dual-canvas band switching, weight-460 h2 instead of bold display, pill-radius segmented controls, two greens with split duty between glow and button — rather than a generic dark-mode dev landing with a glowing brand-purple CTA. Or reference the tokens directly: every hex, font name, radius, and spacing value is a quoted scalar you can paste into Tailwind config, CSS variables, or a shadcn theme registry. GitHub is worth studying because it threads a hard needle: a console-feeling surface that still reads as a magazine page, with no chromatic CTA, no atmospheric gradient outside one Copilot moment, and a display ramp that hovers between weights 425 and 480 — never bold, never timid, always sitting in the variable-axis micro-band that Mona Sans was designed for.
What makes it distinct
- Dual-canvas system#0d1117 for product surfaces and #000000 for hero/CTA bands, switched at section boundaries rather than blended
- Arctic-blue link voltage#8dd6ff carries every link rest, hero pill stroke, and Copilot CTA label; count 138 across the page
- Two greens, two jobs#5fed83 for activity-glow gradients and accent dots; #08872b for the success-emphasis primary CTA paint
- Variable-weight Mona Sanshero hits weight 425 at 64px with -2.24px tracking, h2 sits at weight 460, never the bold 700 most dev platforms reach for
- Pill segmented control60px radius on the Code/Plan/Collaborate/Automate/Secure switcher; the page's dominant radius value at 12 occurrences
Live at github.com
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
github.comExplore GitHub
Pick what you want to see — mockups, colors, typography, layout, or the full component list.
Brand & Accent
Sparing, CTA-only voltage.
Surface
Page and card backgrounds.
Text
Headlines, body, captions, muted.
Borders & Hairlines
Dividers, outlines, structural rules.
Semantic
Status, errors, success, inline links.
Other
Specialty colors.
GitHub design system FAQ
Common questions about GitHub's tokens, components, and how to use this DESIGN.md in your project.
Related reading
Specs, directories, and component libraries that pair with this design system.
Browse all design systems
The full directory of DESIGN.md files on shadcn.io, with live mockups for each.
GitHub — official site
The live source — see the dual-canvas band switching, the pill segmented switcher, and the Copilot IDE mockup in their native habitat.
The DESIGN.md specification
Google Labs' open spec for machine-readable design system files — the format this page is built on.
Use GitHub in your project
One machine-readable file. Drop it into Claude, Cursor, or any AI tool that reads DESIGN.md.