# McDonald's — Design System
> Global fast-food restaurant brand focused on app ordering, promotions, and iconic fast food items.
- **Canonical:** https://uiuxskills.com/library/mcdonald-s
- **Source:** https://www.mcdonalds.com/
- **Category:** E-commerce & Retail
- **Compatible tools:** claude, cursor, lovable, figma-make
- **Coverage:** 81%
- **License:** MIT
- **Last updated:** 2026-10-16T19:38:59.748Z

---

---
version: alpha
name: McDonald's
tagline: I'm lovin' it
description: Global fast-food restaurant brand focused on app ordering, promotions, and iconic fast food items.
tone: playful
color-scheme: light
colors:
  primary: "#FFBC0D"
  secondary: "#AF0006"
  tertiary: "#006BAE"
  surface: "#FFFFFF"
  surface-container: "#F4F4F4"
  surface-bright: "#FFFFFF"
  surface-dim: "#292929"
  on-primary: "#292929"
  on-surface: "#292929"
  on-secondary: "#FFFFFF"
  outline: "#7C7C7C"
  error: "#AF0006"
typography:
  display-lg:
    fontFamily: Speedee, Segoe UI, Arial, sans-serif
    fontSize: 48px
    fontWeight: 700
    lineHeight: "1.1"
    letterSpacing: "-0.02em"
  headline-lg:
    fontFamily: Speedee, Segoe UI, Arial, sans-serif
    fontSize: 36px
    fontWeight: 700
    lineHeight: "1.2"
    letterSpacing: "-0.01em"
  headline-md:
    fontFamily: Speedee, Segoe UI, Arial, sans-serif
    fontSize: 28px
    fontWeight: 700
    lineHeight: "1.25"
    letterSpacing: normal
  headline-sm:
    fontFamily: Speedee, Segoe UI, Arial, sans-serif
    fontSize: 22px
    fontWeight: 700
    lineHeight: "1.3"
    letterSpacing: normal
  body-lg:
    fontFamily: Speedee, Segoe UI, Arial, sans-serif
    fontSize: 18px
    fontWeight: 400
    lineHeight: "1.5"
    letterSpacing: normal
  body-md:
    fontFamily: Speedee, Segoe UI, Arial, sans-serif
    fontSize: 16px
    fontWeight: 400
    lineHeight: "1.5"
    letterSpacing: normal
  label-md:
    fontFamily: Speedee, Segoe UI, Arial, sans-serif
    fontSize: 14px
    fontWeight: 700
    lineHeight: "1.4"
    letterSpacing: 0.02em
  label-sm:
    fontFamily: Speedee, Segoe UI, Arial, sans-serif
    fontSize: 12px
    fontWeight: 500
    lineHeight: "1.3"
    letterSpacing: normal
rounded:
  xs: 2px
  sm: 4px
  md: 8px
  lg: 16px
  full: 9999px
spacing:
  xs: 4px
  sm: 8px
  md: 16px
  lg: 24px
  xl: 32px
  2xl: 48px
components:
  button-primary:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    padding: 12px 24px
    height: 44px
  button-primary-hover:
    backgroundColor: "#E0A400"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
  button-secondary:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.on-surface}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    borderColor: "{colors.outline}"
  button-secondary-hover:
    backgroundColor: "{colors.surface-container}"
    textColor: "{colors.on-surface}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    borderColor: "{colors.on-surface}"
  card:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.on-surface}"
    rounded: "{rounded.md}"
    padding: 24px
  card-elevated:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.on-surface}"
    rounded: "{rounded.md}"
    padding: 24px
  input-field:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.on-surface}"
    typography: "{typography.body-md}"
    rounded: "{rounded.sm}"
    borderColor: "{colors.outline}"
  input-field-focus:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.on-surface}"
    typography: "{typography.body-md}"
    rounded: "{rounded.sm}"
    borderColor: "{colors.tertiary}"
  link:
    textColor: "{colors.tertiary}"
    typography: "{typography.body-md}"
  link-hover:
    textColor: "#004B7A"
    typography: "{typography.body-md}"
  badge:
    backgroundColor: "{colors.secondary}"
    textColor: "{colors.on-secondary}"
    typography: "{typography.label-sm}"
    rounded: "{rounded.sm}"
    padding: 4px 8px
  divider:
    backgroundColor: "{colors.outline}"
    height: 1px
  badge-error:
    backgroundColor: "{colors.error}"
    typography: "{typography.label-sm}"
    rounded: "{rounded.sm}"
    padding: 4px 8px
  card-bright:
    backgroundColor: "{colors.surface-bright}"
    textColor: "{colors.on-surface}"
    rounded: "{rounded.md}"
    padding: 16px
  card-dim:
    backgroundColor: "{colors.surface-dim}"
    textColor: "{colors.on-surface}"
    rounded: "{rounded.md}"
    padding: 16px
motion:
  duration-short: 200ms
  duration-medium: 500ms
  easing-standard: cubic-bezier(0.4, 0, 0.2, 1)
elevation:
  sm: 0 1px 2px rgba(0,0,0,0.1)
  md: 0 4px 6px rgba(0,0,0,0.1)
  lg: 0 10px 15px rgba(0,0,0,0.2)
---

## Overview

McDonald's visual identity is built on a high-contrast, energetic palette that evokes warmth, playfulness, and immediate brand recognition. The interface balances bold, appetite-stimulating accents with clean, structured layouts to drive digital engagement and app adoption. Rounded interactive elements and generous negative space create an accessible, friendly, and highly scannable ordering experience.

## Colors

The color strategy centers on the iconic Golden Arches yellow and classic brand red to create high visual impact and immediate brand recall. High-contrast dark charcoal is utilized for text to ensure readability, while neutral white and light grey surfaces provide a clean backdrop that lets vibrant food photography stand out.

*   Primary (`{colors.primary}`) (#FFBC0D): Signature Golden Arches yellow, reserved strictly for high-priority call-to-action elements.
*   Secondary (`{colors.secondary}`) (#AF0006): Classic brand red used for primary accents, promotional headers, and badges.
*   Tertiary (`{colors.tertiary}`) (#006BAE): Digital action blue used for inline text links and interactive navigation accents.
*   Surface (`{colors.surface}`) (#FFFFFF): Clean white background for content cards and the main layout backdrop.
*   Surface Container (inferred) (`{colors.surface-container}`) (#F4F4F4): Light grey background tint for card groupings and subtle section separators.
*   Surface Bright (inferred) (`{colors.surface-bright}`) (#FFFFFF): Bright elevated surface color for modals and primary content banners.
*   Surface Dim (`{colors.surface-dim}`) (#292929): Dark charcoal used for top utility headers, high-contrast footers, and dark mode elements.
*   On Primary (`{colors.on-primary}`) (#292929): Dark charcoal text color to ensure accessible contrast on golden primary yellow surfaces.
*   On Surface (`{colors.on-surface}`) (#292929): Dark charcoal text used for body copy and primary headings.
*   On Secondary (inferred) (`{colors.on-secondary}`) (#FFFFFF): White text and icon color for high contrast over red background surfaces.
*   Outline (`{colors.outline}`) (#7C7C7C): Neutral grey border color for outlined buttons, input fields, and dividers.
*   Error (inferred) (`{colors.error}`) (#AF0006): Red alert color mapped to the brand's secondary red for validation errors and system alerts.

## Typography

The typography system relies on the custom geometric sans-serif Speedee font family (with system fallbacks) to deliver a bold, friendly, and highly legible reading experience. Scale hierarchy is strictly enforced to separate high-impact promotional headlines from dense legal disclaimers.

*   Display Large (inferred) (`{typography.display-lg}`): Used for high-impact hero banner headings and major promotional campaign titles.
*   Headline Large (`{typography.headline-lg}`): Used for primary section titles, campaign blocks, and major deal headings.
*   Headline Medium (inferred) (`{typography.headline-md}`): Used for secondary card headings and feature callouts.
*   Headline Small (inferred) (`{typography.headline-sm}`): Used for sub-section headings and modal title banners.
*   Body Large (inferred) (`{typography.body-lg}`): Used for lead paragraphs in promotional feature descriptions.
*   Body Medium (`{typography.body-md}`): Used for standard body copy and general descriptions across the web application.
*   Label Medium (`{typography.label-md}`): Used for navigation links, interactive labels, and primary pill button text.
*   Label Small (inferred) (`{typography.label-sm}`): Used for footnotes, legal fine print, and secondary tags.

## Layout

Layouts are structured around stacked, full-width horizontal feature banners that align to a clean content grid. The spacing strategy relies on a robust scale, utilizing larger values like `{spacing.xl}` and `{spacing.2xl}` to maintain breathing room around promotional banners, while smaller values like `{spacing.md}` and `{spacing.sm}` govern internal card padding. The standard page flow follows a structured top-to-bottom order: `nav`, `hero-promo`, `feature-offers`, `app-download-cta`, and `footer`. The hero composition features a full-bleed campaign graphic with dynamic text overlays, accompanied by a clear headline, body copy, and a primary yellow pill button. Responsively, the navigation collapses into a mobile drawer menu, and multi-column grids shift into single-column stacked feature cards that stretch across the full viewport width.

## Elevation & Depth

Minimal single-layer shadows are utilized to establish subtle depth and hierarchy without cluttering the interface.

*   `elevation.sm`: Applied to standard interactive cards to provide a subtle lift from the background.
*   `elevation.md`: Used for active card states, hover effects, and dropdown menus to indicate interactivity.
*   `elevation.lg`: Reserved for high-priority overlays, modals, and promotional drawer elements.

## Shapes

The shape language is inherently friendly and approachable, heavily relying on rounded corners to soften the interface. Interactive elements such as buttons utilize a pill-shape configuration with `{rounded.full}` to invite user interaction and emphasize touch-target friendliness.

For structural containers, subtle rounding is applied to maintain clean alignment. Standard promotional cards and media callouts feature minor edge softening via `{rounded.md}`, while form inputs and small badges utilize `{rounded.sm}` to maintain crisp, readable boundaries.

## Components

### Primary Button

> **Note:** This spec was generated from a website scrape and contains visual approximations. For production use, add a deep reference to each component pointing to its authoritative source:
> `→ Deep reference: src/components/Button/PrimaryButton.ts`

The primary button is a highly visible, pill-shaped action element utilizing `{colors.primary}` background and `{colors.on-primary}` text with `{typography.label-md}`. In its hover state, it transitions to a deeper gold (`#E0A400`) to provide clear interactive feedback. Use this component exclusively for the main call-to-action on a page, such as starting an order or downloading the app.

### Secondary Button

> `→ Deep reference: src/components/Button/SecondaryButton.ts`

The secondary button is an outlined pill-shaped element featuring a `{colors.surface}` background, `{colors.on-surface}` text, and a `{colors.outline}` border. On hover, the background shifts to `{colors.surface-container}` and the border darkens to `{colors.on-surface}`. Use this for alternative actions, secondary choices, or utility navigation.

### Card

> `→ Deep reference: src/components/Card/Card.ts`

The standard card is a flat content container utilizing a `{colors.surface}` background, `{colors.on-surface}` text, and `{rounded.md}` corners. It features a generous internal padding of `{spacing.lg}` to keep promotional copy and imagery clean and readable. Use this to group related food items, deals, or informational blocks.

### Elevated Card

> `→ Deep reference: src/components/Card/ElevatedCard.ts`

The elevated card shares the same background and padding properties as the standard card but incorporates a subtle drop shadow using `elevation.sm` or `elevation.md`. This component is used to highlight featured promotions or interactive deals that require extra visual separation from the background.

### Input Field

> `→ Deep reference: src/components/Form/InputField.ts`

The input field is a structured text entry component with a `{colors.surface}` background, `{colors.on-surface}` text, and `{rounded.sm}` corners bordered by `{colors.outline}`. Upon receiving focus, the border color transitions to `{colors.tertiary}` to clearly guide user input. Use this for search queries, zip code locators, and form fields.

### Link

> `→ Deep reference: src/components/Link/Link.ts`

The inline link component uses `{colors.tertiary}` text and `{typography.body-md}` to stand out within body copy. On hover, the text color darkens to a deep blue (`#004B7A`) to indicate interactivity. Use this for inline references, legal terms, and secondary navigation paths.

### Badge

> `→ Deep reference: src/components/Badge/Badge.ts`

The badge is a compact, high-contrast label utilizing a `{colors.secondary}` red background and `{colors.on-secondary}` white text with `{typography.label-sm}`. It features `{rounded.sm}` corners and tight padding. Use this to highlight active deals, new menu items, or promotional tags.

### Divider

> `→ Deep reference: src/components/Divider/Divider.ts`

The divider is a thin, 1px horizontal rule utilizing the `{colors.outline}` color. It is used to separate distinct content blocks or footer sections without adding unnecessary visual weight.

### Bright Card

> `→ Deep reference: src/components/Card/BrightCard.ts`

The bright card is a high-contrast container utilizing `{colors.surface-bright}` background, `{colors.on-surface}` text, and `{rounded.md}` corners with `{spacing.md}` padding. Use this for prominent callouts and interactive modals that require maximum visibility.

### Dim Card

> `→ Deep reference: src/components/Card/DimCard.ts`

The dim card is a dark-themed container utilizing `{colors.surface-dim}` background, `{colors.on-surface}` text, and `{rounded.md}` corners with `{spacing.md}` padding. Use this for high-contrast footer sections or dark-themed promotional blocks.

## Do's and Don'ts

| Do | Don't |
| --- | --- |
| Use `{colors.primary}` strictly for high-priority CTA actions such as `{components.button-primary}`. | Do not use `{colors.secondary}` as a background for primary order buttons. |
| Format all primary headings using `{typography.headline-lg}` with `{colors.on-surface}`. | Avoid applying `{typography.display-lg}` to body paragraphs or dense legal copy. |
| Apply `{rounded.full}` to all interactive order buttons like `{components.button-primary}` and `{components.button-secondary}`. | Never override pill button radius with sharp corners on `{components.button-primary}`. |
| Pair inline text links with `{colors.tertiary}` using `{typography.link}`. | Do not pair `{colors.tertiary}` text on `{colors.primary}` surfaces without accessibility checks. |
| Ensure disclaimers and legal fine print use `{typography.label-sm}` in high contrast over `{colors.surface}`. | Never place un-bordered `{components.input-field}` directly on `{colors.surface-container}`. |
| Maintain high spacing rhythm around feature banners using `{spacing.xl}` and `{spacing.2xl}` padding. | Avoid using harsh drop shadows greater than `{elevation.lg}` on standard promotional cards. |
| Use `{colors.surface-container}` as a subtle background separator behind `{components.card}` components. | Do not style `{components.divider}` with `{colors.primary}` or `{colors.secondary}` as it distracts from content. |
| Apply `{colors.on-primary}` to text labels inside `{components.button-primary}` to guarantee AAA contrast. | Never use white text (`{colors.on-secondary}`) on a `{colors.primary}` yellow button background. |

## Content Style

*   **CTA Style**: Call-to-action labels must use direct action verbs in title case. They should be short, encouraging, and focused on immediate value (e.g., "Order Now", "Start Your Order", "Get a Free Medium Fries in the App").
*   **Heading Tone**: Headlines must be fun, informal, and appetising. Focus the copy on savings, exclusive menu releases, and immediate app perks to drive user excitement and engagement.
*   **Copy Density**: Keep introductory paragraphs light, punchy, and highly scannable. Use bold key phrases to draw the eye, and relegate detailed legal terms and disclaimers to small print at the bottom of the section.

## Imagery & Icons

Visual assets must feature rich, high-saturation product photography that emphasizes appetite appeal, combined with branded promotional character art and app UI mockups. Icons should follow a friendly, rounded, and minimal aesthetic that mirrors the `{rounded.full}` shape language of the primary buttons. Ensure that product images are placed on clean `{colors.surface}` or `{colors.surface-container}` backdrops to maintain high contrast and clear separation from text elements.

---

## Companion prompt

## Role
You are an AI assistant generating UI components and layouts for McDonald's, a playful, bold, and accessible quick-service brand anchored by its iconic golden arches identity. Content, copy, and information architecture remain owned by the product team.

## How to use design.md
1. Reference every visual value by token name — `{colors.primary}`, `{typography.headline-lg}`, `{spacing.xl}` — never hardcode hex values, font sizes, or pixel values directly.
2. Render only the components listed under `components:` (`button-primary`, `card`, `badge`, etc.). Do not invent variants, color combinations, or shape treatments outside the spec.
3. Apply `{rounded.full}` to all interactive buttons per the Shapes notes. Use `{rounded.sm}` or `{rounded.md}` for cards and surface containers. Never apply sharp corners to `{components.button-primary}` or `{components.button-secondary}`.
4. Follow the Layout notes: full-width stacked banners, prominent hero graphics paired with a single clear CTA, generous padding using `{spacing.xl}` and `{spacing.2xl}` around feature sections.
5. Treat the Do's and Don'ts table as authoritative. If a user request conflicts with a rule — such as using `{colors.secondary}` as a button background — surface the conflict explicitly before proceeding.

## Output contract

**Must:**
- Use all tokens by name; cover hover, focus, and disabled states for every interactive component the spec defines.
- Apply `{colors.primary}` exclusively to `{components.button-primary}` backgrounds; use `{colors.on-primary}` for label text on those buttons.
- Use `{colors.tertiary}` for inline text links; render them with `{typography.label-md}`.
- Set body and heading text in `{colors.on-surface}` on `{colors.surface}` backgrounds.
- Write CTAs as direct title-case action verbs per the Voice and Content section; place legal fine print in `{typography.label-sm}`.

**Must NOT:**
- Invent colors, radii, or font scales absent from the spec.
- Substitute generic system defaults when a brand token exists.
- Add emoji, filler copy, or unsolicited marketing language.
- Rewrite, replace, or restructure existing page copy, navigation items, or content hierarchy.
- Apply `{typography.display-lg}` to body paragraphs or legal copy.

## When in doubt
- If the spec doesn't define a value, ask the user before inventing one.
- Prefer composing existing spec components over introducing new tokens.
- For ambiguous backgrounds, default to `{colors.surface}`; for text on them, default to `{colors.on-surface}`.
- Tokens marked "(inferred)" are visual approximations; authoritative theme files or Storybook definitions take precedence.
- For unspecified breakpoints, use mobile-first layout with one breakpoint at 768px, consistent with the full-width banner layout notes.
