Kroger Design System
Kroger's grocery e-commerce design system as a DESIGN.md file.
About Kroger DESIGN.md
Curated by Dov AzencotUpdated Source kroger.com
- E-commerce & Retail
- Food & Delivery
Kroger's digital storefront runs what is effectively a dual-register type system — Nunito for every surface that signals editorial authority (headings, category titles, button labels) and the OS system-ui stack for everything that moves the user through the catalog (nav links, body copy, price metadata). The split is not a contrast of mood but of function: Nunito's rounded geometric forms identify "we are speaking" moments, while system-ui's neutral clarity identifies "you are navigating" moments. Where Target uses a single custom sans-serif throughout and Walmart uses Walmart Sans end-to-end, Kroger outsources the informational layer to whatever the user's OS provides and keeps only the brand-voice layer proprietary.
The DESIGN.md file packages the system into a machine-readable spec for React and AI tools. Inside: 17 color tokens drawn from the 75-entry clustered extraction — the Kroger corporate blue at three depth levels, a semantic set covering danger/positive/warning/special/boost, structural neutrals from near-black through light hairline, and a sub-brand identifier for Kroger's pharmacy arm; 14 typography tokens across Nunito and system-ui from 32px hero headings through 10.5px superscripts; 7 radius tokens anchored at 4px for action surfaces and 16px for product cards; 8 spacing values on a 4px base; and 18 component definitions covering the blue-fill category tab, the product card, the add-to-cart button, and the carousel paddle system.
Feed this file to Claude or Cursor and it will reproduce Kroger's specific moves: corporate-blue link color reserved for interactive affordances but never used as a background canvas fill, Nunito at 700 for headings with system-ui for body, 4px buttons alongside 16px product cards, and the light-gray (#707172) as the subdued mid-tone that carries inactive state chips and secondary catalog labels. The most instructive structural choice is the clean separation of the brand blue into text-and-border territory — it signals interactivity without competing with the product photography that fills the card grid.
What makes it distinct
- Two-family typeface splitNunito for every heading and button, system-ui for all nav and body copy; the contrast between the two families separates catalog structure from editorial hierarchy
- Corporate blue as link voltage#1860ae appears 234 times as text and border but never as a background fill in the captured surface; interactive affordance without canvas invasion
- 16px card radius at grocery scalethe 16px product card rounding (79 occurrences) is notably warmer than Target's 4px or Walmart's 8px, tuning the catalog toward approachability
- 75 clustered CSS color tokensthe most token-dense grocery brand in the directory, with dedicated semantic families for danger, positive, warning, special, boost, and 20+ regional sub-brand identifiers
- 4px base radius for action surfacesbuttons, checkboxes, and form inputs sit at 4px, while cards jump to 16px; the gap between action-surface sharpness and card warmth is a deliberate two-tier choice
Live at kroger.com
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
kroger.comExplore Kroger
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.
Kroger design system FAQ
Common questions about Kroger'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.
Kroger — official site
Kroger's public grocery storefront — 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.