About Kubernetes DESIGN.md
Curated by Dov AzencotUpdated Source kubernetes.io
- Backend, Database & DevOps
- Web Infrastructure & Hosting
Kubernetes.io is an open-source documentation site that also functions as the project's primary marketing surface. It does not use a proprietary typeface, a bespoke design system, or a brand-hero illustration. It uses Bootstrap 5 with a theme override that maps the Bootstrap primary color to Kubernetes royal blue (#326ce5), and Open Sans as the system body font. The page's strongest visual statement is the KubeCon event announcement banner — a near-black panel carrying white text and two event-date chips — and beneath that, a series of content sections: a "Planet scale" feature list, a "Kubernetes Features" grid of 8 tiles, a CNCF case-study section, and the Cloud Native Computing Foundation affiliation footer. The helm-wheel logo mark is the most distinctive brand asset, but its azure-to-royal blue gradient appears nowhere in the CSS surface tokens — only once, as a gradient stop in the extraction.
For a project that underpins a significant fraction of global enterprise infrastructure, the design is deliberately restrained. This is not a marketing failure — it reflects the open-source governance model: the community owns the project, not a marketing team, and the visual system must signal trustworthiness and longevity rather than commercial ambition. Compared to Docker (which uses the same container ecosystem positioning but runs a bespoke Repro + electric-blue commercial design system), Kubernetes reads as the reference implementation — technically authoritative, visually neutral. The analogy in software is stable API over flashy UI.
Feed this file to an AI coding tool and it reproduces Kubernetes's specific moves: white canvas, Bootstrap 5 token structure, royal blue as the single link/interactive voltage, Open Sans at weight 400 body and 700 heading, conservative 8px default rounding, and a dark event-announcement banner as the one deliberate chromatic departure. The system is among the easiest in the directory to clone: few tokens, one family, one voltage, Bootstrap base.
What makes it distinct
- Bootstrap 5 foundationthe entire CSS variable set is --bs-* prefixed, making token sourcing and overriding predictable for any Bootstrap-familiar developer
- Single royal-blue brand voltage#326ce5 wired as --bs-primary and --bs-link-color across 44 rendered occurrences
- Open Sans across all tiersone family, weight 400 body and weight 700 heading, no display/body split
- Dark event bannerthe KubeCon announcement panel is near-black (#13110f) with white text, making it the page's only true dark surface
- CNCF ecosystem credibilitya logo grid of CNCF member projects and a 'Case Studies' section substitute for brand illustration
Live at kubernetes.io
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
kubernetes.ioExplore Kubernetes
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.
Other
Specialty colors.
Kubernetes design system FAQ
Common questions about Kubernetes'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.
Kubernetes — official site
The Kubernetes project's public site — the source of truth for the live tokens captured in this file.
The DESIGN.md specification
Google Labs' open spec for machine-readable design system files — the format this page is built on.