healthcare · trust · blue · editorial · video · accessibility

DESIGN.md inspired by Mayo Clinic

Healthcare trust system with white institutional nav, cinematic care hero, blue service actions, and yellow notice band.

By webdesignhot · www.mayoclinic.org
$ npx @webdesignhot/design-md add mayo-clinic
Learn more about the CLI
try on →
theme
1440 × 900
mobile · 390 × 844
Tokens webdesignhot/0.1
  • bg #ffffff
  • bg-page #ffffff
  • bg-navy #0d0d33
  • bg-blue-deep #012d61
  • surface #ffffff
  • surface-blue-soft #e1f0ff
  • surface-video rgba(0, 0, 0, 0.56)
  • text AAA · 20.0 #080808
  • text-strong #000000
  • text-muted #686868
  • text-on-dark #ffffff
  • brand AA · 6.9 #0057b8
  • brand-hover #004691
  • brand-light #8cc5ff
  • notice #ffc845
  • notice-text #080808
  • border — · 1.5 #d6d6d6
  • border-blue #8cc5ff
  • overlay rgba(0, 0, 0, 0.56)
  • success #1b7f55
  • warning #ffc845
  • danger #c0362c
  • on-brand #ffffff
Typography
Ship faster than ever.
hero-display mayo-display 76px w300 0
Ship faster than ever.
display mayo-display 56px w300 0
Ship faster than ever.
h1 mayo-display 44px w300 0
Built for teams that ship.
h2 mayo-display 32px w400 0
A complete kit
h3 mayo-sans 22px w600 0
The quick brown fox jumps over the lazy dog.
body-lg mayo-sans 20px w400 0
The quick brown fox jumps over the lazy dog.
button mayo-sans 20px w400 0
The quick brown fox jumps over the lazy dog.
body mayo-sans 16px w400 0
The quick brown fox jumps over the lazy dog.
nav mayo-sans 16px w400 0
The quick brown fox jumps over the lazy dog.
body-sm mayo-sans 14px w400 0
Spacing
  • step-0 0px
  • step-1 4px
  • step-2 8px
  • step-3 12px
  • step-4 16px
  • step-5 24px
  • step-6 32px
  • step-7 48px
  • step-8 64px
  • step-9 80px
  • step-10 112px
Radius
  • micro 4px
  • sm 6px
  • md 10px
  • lg 16px
  • circle 1000px
  • pill 9999px
Components
Text link →
Card preview A complete kit — everything your product needs. Hero, pricing, FAQ, dashboard, docs — every layout your product needs.
New Stable v1.0
Design roles 8/8 mapped · webdesignhot/0.1

Maps the 8 canonical role names to this entry's actual tokens. Use these to plug the design into role-aware tools — shadcn/ui themes, role-aware Tailwind plugins, atelier-lint — without hard-coding token names.

  • background bg
  • foreground text
  • primary brand
  • primary-foreground on-brand
  • accent notice
  • muted text-muted
  • border border
  • ring brand
Lineage & influences

Mayo Clinic balances hospital authority with editorial care storytelling. The first viewport is visually rich, but the navigation and below-fold modules remain service-oriented and accessible.

  • Hospital service portals
    appointment, account, search, and health-library navigation
  • Editorial healthcare storytelling
    large display type over medical innovation imagery
  • Public information systems
    yellow notices and alphabetical disease search
Export 4 formats · paste-ready
Tailwind

theme.extend block for tailwind.config.js

tailwind.config.js
CSS variables

:root { --bg, --text, --brand, … } you can paste anywhere

design.css
DTCG JSON

W3C Design Tokens Community Group format

design.tokens.json
Figma Variables

Importable into Figma → Variables → Import

figma-variables.json
The file
---
name: Mayo Clinic
tagline: 'Healthcare trust system with white institutional nav, cinematic care hero, blue service actions, and yellow notice band.'
updated_at: 2026-07-09T13:19:00+12:00
published_at: 2026-07-09T13:19:00+12:00
author: webdesignhot
source_url: https://www.mayoclinic.org
spec: webdesignhot/0.1
quality: curated
featured: false
categories: [healthcare]
tags: [healthcare, trust, blue, editorial, video, accessibility]
preview_swatch: ['#ffffff', '#0057b8', '#0d0d33']
related: [headway, cvs, calm]
description: 'Mayo Clinic pairs institutional clarity with an editorial care hero: white navigation, Mayo display typography, blue service links, full-bleed medical innovation imagery, a yellow patient-information notice, and practical disease-search modules below the fold.'
aliases:
  background: bg
  foreground: text
  primary: brand
  primary-foreground: on-brand
  accent: notice
  muted: text-muted
  border: border
  ring: brand
colors:
  bg: '#ffffff'
  bg-page: '#ffffff'
  bg-navy: '#0d0d33'
  bg-blue-deep: '#012d61'
  surface: '#ffffff'
  surface-blue-soft: '#e1f0ff'
  surface-video: 'rgba(0, 0, 0, 0.56)'
  text: '#080808'
  text-strong: '#000000'
  text-muted: '#686868'
  text-on-dark: '#ffffff'
  brand: '#0057b8'
  brand-hover: '#004691'
  brand-light: '#8cc5ff'
  notice: '#ffc845'
  notice-text: '#080808'
  border: '#d6d6d6'
  border-blue: '#8cc5ff'
  overlay: 'rgba(0, 0, 0, 0.56)'
  success: '#1b7f55'
  warning: '#ffc845'
  danger: '#c0362c'
  on-brand: '#ffffff'
typography:
  display:
    family: 'mayo-display, Georgia, "Times New Roman", serif'
    weights: [300, 400]
  body:
    family: 'mayo-sans, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Arial, sans-serif'
    weights: [400, 500, 600]
  mono:
    family: 'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace'
    weights: [400, 500]
  scale:
    hero-display: { size: 76, weight: 300, lineHeight: 1.05, tracking: '0', family: display }
    display: { size: 56, weight: 300, lineHeight: 1.12, tracking: '0', family: display }
    h1: { size: 44, weight: 300, lineHeight: 1.15, tracking: '0', family: display }
    h2: { size: 32, weight: 400, lineHeight: 1.25, tracking: '0', family: display }
    h3: { size: 22, weight: 600, lineHeight: 1.3, tracking: '0', family: body }
    body-lg: { size: 20, weight: 400, lineHeight: 1.45, tracking: '0', family: body }
    body: { size: 16, weight: 400, lineHeight: 1.5, tracking: '0', family: body }
    body-sm: { size: 14, weight: 400, lineHeight: 1.45, tracking: '0', family: body }
    nav: { size: 16, weight: 400, lineHeight: 1.35, tracking: '0', family: body }
    button: { size: 20, weight: 400, lineHeight: 1.2, tracking: '0', family: body }
radius:
  micro: 4
  sm: 6
  md: 10
  lg: 16
  circle: 1000
  pill: 9999
spacing:
  base: 4
  scale: [0, 4, 8, 12, 16, 24, 32, 48, 64, 80, 112]
layout:
  page-width: 1280
  prose-width: 720
  header-height: 104
  hero-height: 630
  content-width: 1280
motion:
  ease-standard: 'cubic-bezier(0.2, 0, 0, 1)'
  duration-fast: 140
  duration-standard: 240
  duration-slow: 480
  reduced-motion: 'replace hero video motion with still imagery'
breakpoints:
  mobile: 640
  tablet: 1024
  desktop: 1280
  wide: 1536
components:
  institutional-nav:
    bg: surface
    text: text
    radius: 0
    padding: '24px 0'
    use: 'care, health library, professionals, research, giving'
  hero-media:
    bg: bg-navy
    text: text-on-dark
    radius: 0
    use: 'full-bleed medical innovation image or video'
  button-outline-light:
    bg: transparent
    text: text-on-dark
    border: text-on-dark
    radius: 24
    padding: '12px 24px'
    use: 'Request appointment in hero'
  notice-band:
    bg: notice
    text: notice-text
    radius: 0
    padding: '20px 0'
    use: 'patient information disclosure notices'
lineage:
  summary: 'Mayo Clinic balances hospital authority with editorial care storytelling. The first viewport is visually rich, but the navigation and below-fold modules remain service-oriented and accessible.'
  influences:
    - { name: 'Hospital service portals', role: 'appointment, account, search, and health-library navigation' }
    - { name: 'Editorial healthcare storytelling', role: 'large display type over medical innovation imagery' }
    - { name: 'Public information systems', role: 'yellow notices and alphabetical disease search' }
---

## 1. Visual Theme & Atmosphere

Mayo Clinic combines institutional trust with cinematic care storytelling. The header is white, structured, and service-oriented; the hero is a full-bleed medical innovation image with large display type.

The page feels authoritative because service actions remain visible: request appointment, account access, search, health library, and disease lookup.

**Key Characteristics**
- White institutional header.
- Mayo display type over hero media.
- Blue service links and actions.
- Full-bleed hero image or video.
- Yellow patient-information notice band.
- Disease and condition search below the fold.
- Circular alphabetical filters.
- Clear appointment and login paths.

## 2. Color Palette & Roles

Use `bg #ffffff` for navigation and content sections. The medical-service brand color is `brand #0057b8`, supported by `brand-light #8cc5ff`.

Hero text is white over a dark overlay. Use `overlay rgba(0, 0, 0, 0.56)` when imagery needs readability.

The notice band uses `notice #ffc845` with dark text. It should be unmistakable but not styled like a marketing banner.

## 3. Typography Rules

| Role | Font | Size | Weight | Notes |
| --- | --- | ---: | ---: | --- |
| Hero | mayo-display | 76 | 300 | Editorial, calm, high trust |
| Display | mayo-display | 56 | 300 | Major service stories |
| H1 | mayo-display | 44 | 300 | Page titles |
| H2 | mayo-display | 32 | 400 | Health-library modules |
| H3 | mayo-sans | 22 | 600 | Cards and search labels |
| Body large | mayo-sans | 20 | 400 | Service links |
| Body | mayo-sans | 16 | 400 | Default information |
| Button | mayo-sans | 20 | 400 | Appointment actions |

Keep display type light and legible. It should feel human, not decorative.

## 4. Component Stylings

The institutional nav is text-first. Menu labels can include small chevrons, but the layout should stay open and predictable.

Hero buttons can be outline treatments over media, with white text and a rounded border. The appointment action should remain easy to see.

Alphabetical disease filters use circular buttons with pale blue borders. They are service utilities, not decorative badges.

## 5. Layout Principles

Use a tall media hero below the white header. Position hero text toward the lower left so the image remains visible and readable.

Place the yellow notice band directly after the hero when required. Below that, move quickly into practical health-library search.

## 6. Shapes & Radius Scale

| Tier | Value | Use |
| --- | ---: | --- |
| Micro | 4 | small icons |
| Small | 6 | inputs |
| Medium | 10 | search modules |
| Large | 16 | content cards |
| Circle | 1000 | alphabet and video controls |
| Pill | 9999 | rare status labels |

Most structural surfaces stay square. Rounded shapes are reserved for controls that need a clear target.

## 7. Depth & Elevation

The hero gets depth from media and overlay, not from cards. Header and content modules should use spacing and borders rather than shadows.

Video controls can sit on a dark translucent circle so they remain visible over the image.

## 8. Interaction & Motion

Menus must be predictable and keyboard accessible. Healthcare navigation should not surprise users with complex hover-only behavior.

Video motion should respect reduced motion preferences. Provide a still fallback and a clear play button.

## 9. Content Voice

Use clear service language: care, health library, appointment, research, medical professionals, diseases and conditions. Avoid vague wellness copy.

Hero copy can be emotional, but supporting actions should be practical and direct.

## 10. Navigation Pattern

The header groups care, health library, professionals, research, and giving. Keep the logo and service links visible on desktop.

Appointment, account, and search actions belong on the right. They are primary utilities, not secondary footer links.

## 11. Search & Service Flows

Health-library search should appear early below the hero. Users may arrive with urgent information needs, so search cannot be buried.

Alphabetical disease filters should be large enough to tap and visually distinct from normal links.

## 12. Media Treatment

Use real medical or research imagery with strong contrast and restrained overlay. Avoid generic smiling stock photos.

If using video, provide a visible play control and do not autoplay distracting motion for users who prefer reduced motion.

## 13. Accessibility Notes

Healthcare UI needs high contrast, keyboard support, and predictable labels. Do not rely on icon-only navigation unless labels are present.

The yellow notice band should be readable by screen readers and not dismissed as decorative content.

## 14. Anti-Patterns

Do not turn the homepage into a wellness lifestyle page. Mayo Clinic's credibility depends on medical specificity.

Do not hide appointment and search actions behind a hamburger menu on desktop.

Avoid blue-on-image text without overlay. The hero must remain readable.

## 15. Implementation Checklist

- Use a white institutional header.
- Keep appointment, account, and search visible.
- Place a full-bleed hero media block below nav.
- Use light display type over a dark overlay.
- Use Mayo blue for service actions.
- Include a yellow notice band when needed.
- Provide health-library search below the hero.
- Respect reduced motion for hero video.
Prose

1. Visual Theme & Atmosphere

Mayo Clinic combines institutional trust with cinematic care storytelling. The header is white, structured, and service-oriented; the hero is a full-bleed medical innovation image with large display type.

The page feels authoritative because service actions remain visible: request appointment, account access, search, health library, and disease lookup.

Key Characteristics

  • White institutional header.
  • Mayo display type over hero media.
  • Blue service links and actions.
  • Full-bleed hero image or video.
  • Yellow patient-information notice band.
  • Disease and condition search below the fold.
  • Circular alphabetical filters.
  • Clear appointment and login paths.

2. Color Palette & Roles

Use bg #ffffff for navigation and content sections. The medical-service brand color is brand #0057b8, supported by brand-light #8cc5ff.

Hero text is white over a dark overlay. Use overlay rgba(0, 0, 0, 0.56) when imagery needs readability.

The notice band uses notice #ffc845 with dark text. It should be unmistakable but not styled like a marketing banner.

3. Typography Rules

RoleFontSizeWeightNotes
Heromayo-display76300Editorial, calm, high trust
Displaymayo-display56300Major service stories
H1mayo-display44300Page titles
H2mayo-display32400Health-library modules
H3mayo-sans22600Cards and search labels
Body largemayo-sans20400Service links
Bodymayo-sans16400Default information
Buttonmayo-sans20400Appointment actions

Keep display type light and legible. It should feel human, not decorative.

4. Component Stylings

The institutional nav is text-first. Menu labels can include small chevrons, but the layout should stay open and predictable.

Hero buttons can be outline treatments over media, with white text and a rounded border. The appointment action should remain easy to see.

Alphabetical disease filters use circular buttons with pale blue borders. They are service utilities, not decorative badges.

5. Layout Principles

Use a tall media hero below the white header. Position hero text toward the lower left so the image remains visible and readable.

Place the yellow notice band directly after the hero when required. Below that, move quickly into practical health-library search.

6. Shapes & Radius Scale

TierValueUse
Micro4small icons
Small6inputs
Medium10search modules
Large16content cards
Circle1000alphabet and video controls
Pill9999rare status labels

Most structural surfaces stay square. Rounded shapes are reserved for controls that need a clear target.

7. Depth & Elevation

The hero gets depth from media and overlay, not from cards. Header and content modules should use spacing and borders rather than shadows.

Video controls can sit on a dark translucent circle so they remain visible over the image.

8. Interaction & Motion

Menus must be predictable and keyboard accessible. Healthcare navigation should not surprise users with complex hover-only behavior.

Video motion should respect reduced motion preferences. Provide a still fallback and a clear play button.

9. Content Voice

Use clear service language: care, health library, appointment, research, medical professionals, diseases and conditions. Avoid vague wellness copy.

Hero copy can be emotional, but supporting actions should be practical and direct.

10. Navigation Pattern

The header groups care, health library, professionals, research, and giving. Keep the logo and service links visible on desktop.

Appointment, account, and search actions belong on the right. They are primary utilities, not secondary footer links.

11. Search & Service Flows

Health-library search should appear early below the hero. Users may arrive with urgent information needs, so search cannot be buried.

Alphabetical disease filters should be large enough to tap and visually distinct from normal links.

12. Media Treatment

Use real medical or research imagery with strong contrast and restrained overlay. Avoid generic smiling stock photos.

If using video, provide a visible play control and do not autoplay distracting motion for users who prefer reduced motion.

13. Accessibility Notes

Healthcare UI needs high contrast, keyboard support, and predictable labels. Do not rely on icon-only navigation unless labels are present.

The yellow notice band should be readable by screen readers and not dismissed as decorative content.

14. Anti-Patterns

Do not turn the homepage into a wellness lifestyle page. Mayo Clinic’s credibility depends on medical specificity.

Do not hide appointment and search actions behind a hamburger menu on desktop.

Avoid blue-on-image text without overlay. The hero must remain readable.

15. Implementation Checklist

  • Use a white institutional header.
  • Keep appointment, account, and search visible.
  • Place a full-bleed hero media block below nav.
  • Use light display type over a dark overlay.
  • Use Mayo blue for service actions.
  • Include a yellow notice band when needed.
  • Provide health-library search below the hero.
  • Respect reduced motion for hero video.
Ship with this

Drop mayo-clinic into your project, then ship the actual sections in an afternoon.

1 · install design
npx @webdesignhot/design-md add mayo-clinic
2 · ship landing page
npx agentkit init --design mayo-clinic
How AgentKit reads DESIGN.md