Overview
MongoDB carries a strong dual-mode visual identity — dark deep-teal hero bands with the unmistakable bright MongoDB green ({colors.brand-green}) CTA pill paired with stark white documentation and pricing surfaces. The homepage opens with "One data platform. Unlimited AI potential." headline over a deep navy hero, the green pill sitting at the visual center as the primary CTA. Lower on the page, embedded code mockup cards (terminal-aesthetic) sit on the dark hero band, breaking out into white feature cards below. The pricing page renders a 3-tier comparison (Free / Flex / Dedicated) with a featured tier highlighted in soft mint background and bright green border. The MongoDB University page presents a course catalog grid where each tile carries a colored category tag (orange, purple, green, teal) — these are MongoDB's category-encoding accent colors and are the only place outside the brand green where saturated color appears.
The system uses Euclid Circular A as its display face. The face is contemporary geometric — confident but not overly playful — and pairs naturally with both the developer-tool aesthetic of the database product and the educational positioning of the learning surfaces. Cards use {rounded.lg} (12px) corners; buttons use {rounded.full} pills universally. The brand-teal palette ({colors.brand-teal-deep}) anchors hero bands, footer, code mockups, and the dark CTA banners.
Key Characteristics:
- Deep navy/teal hero bands ({colors.brand-teal-deep}) with bright MongoDB green ({colors.brand-green}) CTA pills
- Stark white pricing/documentation surfaces with colored category tags for course tiles (purple, orange, green, teal)
- Euclid Circular A across every UI surface
- Pill-shaped buttons ({rounded.full}) and 12px-rounded cards
- 3-tier pricing comparison (Free / Flex / Dedicated) with featured-mint highlight tier
- Code mockup cards with terminal-aesthetic dark canvas
Colors
Source pages: mongodb.com/ (homepage), /products/platform/atlas-database (Atlas product), /products/self-managed/community-edition, learn.mongodb.com/ (MongoDB University), /solutions/use-cases/artificial-intelligence (AI), /pricing (3-tier comparison). Token coverage was identical across all six pages.
Brand & Accent
- MongoDB Green ({colors.brand-green}): The brand's most recognizable signal — bright pill-CTA color
- Green Dark ({colors.brand-green-dark}): Inline link color, secondary green
- Green Mid ({colors.brand-green-mid}): Mid-spectrum green for atmospheric tints
- Green Soft ({colors.brand-green-soft}): Pale-mint background tint for success badges and featured pricing tier
- Brand Teal Deep ({colors.brand-teal-deep}): Deep navy-teal for hero bands, footer
- Brand Teal ({colors.brand-teal}): Mid-spectrum teal
- Brand Teal Mid ({colors.brand-teal-mid}): Lighter teal for hero platform cards
Category Accent (Course Tags)
- Accent Purple ({colors.accent-purple}): Course tag for "Database & Security"
- Accent Orange ({colors.accent-orange}): Course tag for "Search"
- Accent Pink ({colors.accent-pink}): Course tag variant
- Accent Blue ({colors.accent-blue}): Course tag variant for atlas/cloud topics
Surface
- Canvas White ({colors.canvas}): Page background and primary card surface
- Canvas Dark ({colors.canvas-dark}): Code-block backgrounds, dark mockup canvas
- Surface ({colors.surface}): Subtle section backgrounds, search-pill rest
- Surface Soft ({colors.surface-soft}): Quieter section divisions
- Surface Feature ({colors.surface-feature}): Pale mint background for featured pricing tier
- Hairline ({colors.hairline}): 1px borders and primary dividers
- Hairline Soft ({colors.hairline-soft}): Quieter dividers
- Hairline Strong ({colors.hairline-strong}): Stronger 1px border for inputs
- Hairline Dark ({colors.hairline-dark}): Border on dark surfaces
Text
- Ink ({colors.ink}): Primary headlines and body text (deep navy-teal)
- Charcoal ({colors.charcoal}): Body emphasis
- Slate ({colors.slate}): Secondary text
- Steel ({colors.steel}): Tertiary text, captions
- Stone ({colors.stone}): Muted labels
- Muted ({colors.muted}): Disabled, placeholders
- On Dark ({colors.on-dark}): White text on dark surfaces
- On Dark Muted ({colors.on-dark-muted}): Reduced-opacity white
Semantic
- Warning Background ({colors.semantic-warning-bg}): Pale yellow callout bg
- Warning Text ({colors.semantic-warning-text}): Warning state copy color
Typography
Font Family
Euclid Circular A (primary): MongoDB's geometric sans-serif. Fallbacks: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif.
Source Code Pro (code): Monospace for code mockups. Fallbacks: 'SF Mono', Menlo, Consolas, monospace.
Hierarchy
| Token |
Size |
Weight |
Line Height |
Letter Spacing |
Use |
{typography.hero-display} |
72px |
500 |
1.10 |
-1.5px |
Hero ("One data platform") |
{typography.display-lg} |
56px |
500 |
1.15 |
-1px |
Major section openers |
{typography.heading-1} |
48px |
500 |
1.20 |
-0.5px |
Page-level headlines |
{typography.heading-2} |
36px |
500 |
1.25 |
-0.5px |
Subsection headlines |
{typography.heading-3} |
28px |
500 |
1.30 |
0 |
Card titles |
{typography.heading-4} |
22px |
500 |
1.35 |
0 |
Feature tile titles |
{typography.heading-5} |
18px |
600 |
1.40 |
0 |
Smaller card titles, FAQ questions |
{typography.subtitle} |
18px |
400 |
1.50 |
0 |
Hero subtitle, lead body |
{typography.body-md} |
16px |
400 |
1.55 |
0 |
Primary body text |
{typography.body-sm} |
14px |
400 |
1.50 |
0 |
Secondary body, table cells |
{typography.body-sm-medium} |
14px |
500 |
1.50 |
0 |
Active sidebar, button labels |
{typography.caption-bold} |
13px |
600 |
1.40 |
0 |
Badge labels |
{typography.micro-uppercase} |
11px |
600 |
1.40 |
1px |
Section eyebrows, course category tags |
{typography.button-md} |
14px |
600 |
1.30 |
0 |
Pill button labels |
{typography.code-md} |
14px |
400 |
1.55 |
0 |
Code mockups |
Principles
- Tight hero leading (1.10) on 72px display
- Negative letter-spacing on display sizes (-1.5px to -0.5px)
- 600 weight reserved for buttons and small emphasis (FAQ headings, badges)
- Generous body leading (1.55) for technical documentation readability
Layout
Spacing System
- Base unit: 4px (8px primary increment)
- Tokens:
{spacing.xxs} (4px) through {spacing.hero} (120px)
- Section rhythm: Marketing pages use
{spacing.section-lg} (96px); pricing tightens to {spacing.section} (64px)
Grid & Container
- 1280px max-width with 32px gutters
- Pricing: 3-tier card row, dense feature comparison table below
- Learn catalog: 3-up course tile grid, 4-up certification grid
- AI use cases: 2-column hero with atmospheric illustration
Whitespace Philosophy
Marketing surfaces give content generous breathing room — {spacing.hero} (120px) hero padding for deep teal bands. Pricing/learn surfaces tighten dramatically.
Elevation & Depth
| Level |
Treatment |
Use |
| 0 (flat) |
No shadow; {colors.hairline} border |
Default cards, table rows |
| 1 (subtle) |
rgba(0, 30, 43, 0.04) 0px 1px 2px 0px |
Hover-elevated tiles |
| 2 (card) |
rgba(0, 30, 43, 0.08) 0px 4px 12px 0px |
Feature cards |
| 3 (mockup) |
rgba(0, 30, 43, 0.12) 0px 12px 24px -4px |
Code mockup over hero |
| 4 (modal) |
rgba(0, 30, 43, 0.16) 0px 16px 48px -8px |
Modals, dropdowns |
Decorative Depth
- Dark teal hero bands carry atmospheric gradient depth
- Code mockup cards on hero use canvas-dark surface with terminal aesthetic
- Pale-mint pricing-feature tier uses brand-tinted shadow
Shapes
Border Radius Scale
| Token |
Value |
Use |
{rounded.xs} |
4px |
Course category tags |
{rounded.sm} |
6px |
Type badges, code chips |
{rounded.md} |
8px |
Inputs, search-pill, code blocks |
{rounded.lg} |
12px |
Cards, pricing tiers, course tiles |
{rounded.xl} |
16px |
Larger feature panels |
{rounded.xxl} |
24px |
Featured product showcases |
{rounded.full} |
9999px |
All buttons, status badges |
Photography Geometry
- Hero illustrations sit on full-bleed dark backgrounds
- Course tile thumbnails use
{rounded.lg} corners
- Customer logos wall: wordmarks at consistent 60–80px height
Components
Per the no-hover policy, hover states are NOT documented. Default and pressed/active states only.
Buttons
button-primary — Bright MongoDB green pill primary CTA, the dominant action.
- Background
{colors.brand-green}, text {colors.on-primary} (deep navy), typography {typography.button-md}, padding 10px 22px, rounded {rounded.full}.
- Pressed state
button-primary-pressed deepens to {colors.primary-pressed}.
- Disabled state
button-primary-disabled uses {colors.hairline} background.
button-secondary — Outlined pill for secondary actions.
- Background transparent, text
{colors.ink}, border 1px solid {colors.hairline-strong}, typography {typography.button-md}, padding 10px 22px, rounded {rounded.full}.
button-on-dark — Bright green pill on dark hero bands.
- Background
{colors.brand-green}, text {colors.on-primary}, typography {typography.button-md}, padding 10px 22px, rounded {rounded.full}.
button-secondary-on-dark — Outlined pill on dark backgrounds.
- Background transparent, text
{colors.on-dark}, border 1px solid {colors.hairline-dark}, typography {typography.button-md}, padding 10px 22px, rounded {rounded.full}.
button-ghost — Quieter rectangular ghost button.
- Background transparent, text
{colors.ink}, typography {typography.button-md}, padding 8px 12px, rounded {rounded.md}.
button-link — Inline green text link.
- Background transparent, text
{colors.brand-green-dark}, typography {typography.body-sm-medium}, padding 0.
Cards & Containers
card-base — Standard content card.
- Background
{colors.canvas}, rounded {rounded.lg}, padding {spacing.xl}, border 1px solid {colors.hairline}.
card-feature — Feature card with larger padding.
- Background
{colors.canvas}, rounded {rounded.lg}, padding {spacing.xxl}, border 1px solid {colors.hairline}.
card-product-deploy — Product deployment card ("MongoDB Atlas / Community").
- Background
{colors.canvas}, rounded {rounded.lg}, padding {spacing.xxl}, border 1px solid {colors.hairline}.
card-feature-dark — Dark teal feature card on hero band.
- Background
{colors.brand-teal-deep}, text {colors.on-dark}, rounded {rounded.lg}, padding {spacing.xxl}.
card-course — MongoDB University course tile.
- Background
{colors.canvas}, rounded {rounded.lg}, padding {spacing.xl}, border 1px solid {colors.hairline}.
- Top: colored category tag. Below: title
{typography.heading-5}, description {typography.body-sm}, "Get Started →" link.
card-cert — Certification card.
- Background
{colors.canvas}, rounded {rounded.lg}, padding {spacing.xl}, border 1px solid {colors.hairline}.
pricing-card — Standard pricing tier card.
- Background
{colors.canvas}, rounded {rounded.lg}, padding {spacing.xxl}, border 1px solid {colors.hairline}.
pricing-card-featured — Featured pricing tier (Flex tier, mint background + green border).
- Background
{colors.surface-feature}, rounded {rounded.lg}, padding {spacing.xxl}, border 2px solid {colors.brand-green}.
Inputs & Forms
text-input — Standard text field.
- Background
{colors.canvas}, text {colors.ink}, border 1px solid {colors.hairline-strong}, rounded {rounded.md}, padding {spacing.sm} {spacing.md}, height 44px.
text-input-focused — Activated state.
- Border switches to
2px solid {colors.brand-green-dark}.
search-pill — Standard 44px search bar.
- Background
{colors.surface}, text {colors.steel}, typography {typography.body-md}, rounded {rounded.md}, height 44px, border 1px solid {colors.hairline-strong}.
search-pill-large — Large 56px search bar (top of MongoDB University catalog).
- Background
{colors.canvas}, text {colors.steel}, typography {typography.body-md}, rounded {rounded.md}, height 56px, border 1px solid {colors.hairline-strong}.
Tabs
pill-tab + pill-tab-active — Pill-style tab nav (top of pricing: "MongoDB Atlas / Enterprise Advanced").
- Inactive: text
{colors.steel}, border 1px solid {colors.hairline}, padding {spacing.xs} {spacing.md}, rounded {rounded.full}.
- Active: background
{colors.ink}, text {colors.on-dark}.
segmented-tab + segmented-tab-active — Underline-style tab navigation.
- Inactive: text
{colors.steel}, no border. Active: text {colors.brand-green-dark}, 2px bottom border in {colors.brand-green-dark}.
Badges & Status
badge-green — Bright green badge for new product highlights.
- Background
{colors.brand-green}, text {colors.on-primary}, typography {typography.caption-bold}, rounded {rounded.sm}, padding 2px 8px.
badge-green-soft — Pale-mint pill for success/free indicators.
- Background
{colors.brand-green-soft}, text {colors.brand-green-dark}, typography {typography.caption-bold}, rounded {rounded.full}, padding 4px 10px.
badge-purple — Purple course category tag.
- Background
{colors.accent-purple}, text {colors.on-dark}, typography {typography.caption-bold}, rounded {rounded.sm}, padding 2px 8px.
badge-orange — Orange course category tag.
- Background
{colors.accent-orange}, text {colors.on-dark}, typography {typography.caption-bold}, rounded {rounded.sm}, padding 2px 8px.
badge-popular — "Most Popular" tier indicator (dark teal pill with green text).
- Background
{colors.brand-teal-deep}, text {colors.brand-green}, typography {typography.caption-bold}, rounded {rounded.full}, padding 4px 10px.
promo-banner — Dark teal sticky promo strip ABOVE the top nav.
- Background
{colors.brand-teal-deep}, text {colors.on-dark}, typography {typography.body-sm-medium}, padding {spacing.sm} {spacing.md}.
Code
code-block — Code container.
- Background
{colors.canvas-dark}, text {colors.on-dark}, typography {typography.code-md}, rounded {rounded.md}, padding {spacing.md}.
code-mockup-card — Embedded code mockup on hero band.
- Background
{colors.canvas-dark}, text {colors.on-dark}, rounded {rounded.lg}, padding {spacing.lg}. Carries terminal-aesthetic code snippet.
Tables
comparison-table — Pricing feature comparison table.
- Background
{colors.canvas}, text {colors.ink}, typography {typography.body-sm}, rounded {rounded.md}, border 1px solid {colors.hairline}.
comparison-row — Individual feature row.
- Background
{colors.canvas}, text {colors.ink}, padding {spacing.md} {spacing.lg}, bottom border 1px solid {colors.hairline-soft}.
Documentation Components
service-tile — Tile in "Customize your deployment" 6-up grid.
- Background
{colors.canvas}, rounded {rounded.lg}, padding {spacing.xl}, border 1px solid {colors.hairline}.
why-card — "Loved by builders" feature card.
- Background
{colors.surface}, rounded {rounded.lg}, padding {spacing.xl}.
customer-testimonial-card — Customer quote card.
- Background
{colors.canvas}, rounded {rounded.lg}, padding {spacing.xxl}, border 1px solid {colors.hairline}.
logo-wall-item — Customer logo wordmark cell.
- Background transparent, text
{colors.steel}, typography {typography.body-md-medium}, padding {spacing.lg}.
faq-accordion-item — FAQ panel.
- Background
{colors.canvas}, rounded {rounded.md}, padding {spacing.xl}, bottom border 1px solid {colors.hairline}.
Navigation
Top Navigation (Marketing) — Sticky white bar.
- Background
{colors.canvas}, height ~64px, bottom border 1px solid {colors.hairline}.
- Left: MongoDB leaf logo + "Solutions / Resources / Company / Pricing" links.
- Right: "Sign In" link + bright-green pill "Try Free" CTA.
Signature Components
hero-band-dark — Deep teal hero band with embedded code mockup.
- Background
{colors.brand-teal-deep}, text {colors.on-dark}, padding {spacing.hero}.
- Layout: centered headline
{typography.hero-display}, subtitle, button row, code-mockup-card below.
hero-platform-card — Lighter-teal platform showcase card on dark hero.
- Background
{colors.brand-teal-mid}, text {colors.on-dark}, rounded {rounded.xl}, padding {spacing.xxl}.
cta-banner-dark — Dark CTA banner at the bottom of feature pages.
- Background
{colors.brand-teal-deep}, text {colors.on-dark}, rounded {rounded.lg}, padding {spacing.section}.
footer-region — Dark teal multi-column footer.
- Background
{colors.brand-teal-deep}, padding {spacing.section} {spacing.xxl}.
- 6-column link grid.
- Section headings in
{typography.body-sm-medium} {colors.on-dark}.
footer-link — Individual footer link.
- Background transparent, text
{colors.on-dark-muted}, typography {typography.body-sm}, padding {spacing.xxs} 0.
Do's and Don'ts
Do
- Use
{colors.brand-green} (bright MongoDB green) for primary CTAs everywhere
- Pair dark-teal hero bands with bright green CTA pills
- Apply
{rounded.full} to every button, every status badge
- Apply
{rounded.lg} (12px) to cards consistently
- Use category accent colors (purple, orange, green, teal) ONLY for course tags
- Maintain Euclid Circular A across every UI surface
- Use code mockup cards with terminal-aesthetic content for product showcases
Don't
- Don't use the bright green for body text or large surfaces
- Don't introduce additional accent colors beyond the brand green and category-encoding palette
- Don't soften corners on buttons; the pill is a brand signature
- Don't replace deep teal hero bands with white hero bands
- Don't apply heavy shadows on flat documentation cards; reserve elevation for code mockups
- Don't use Source Code Pro for prose
Responsive Behavior
Breakpoints
| Name |
Width |
Key Changes |
| Mobile (small) |
< 480px |
Single column. Hero 36px. Pricing 1-up. Course catalog 1-up. |
| Mobile (large) |
480 – 767px |
Course tiles 2-up. Hero 48px. |
| Tablet |
768 – 1023px |
2-column feature grids. Hero 56px. |
| Desktop |
1024 – 1279px |
3-tier pricing card row. 3-up course catalog. Hero 64px. |
| Wide Desktop |
≥ 1280px |
Full 72px hero presentation. |
Touch Targets
- Pill buttons render at 40–44px effective height
- Form inputs render at 44px height
- Search pill (large) renders at 56px
- Pill tabs ~32px → 44px on mobile
Collapsing Strategy
- Promo banner stays full-width; truncates at < 480px
- Top nav below 1024px collapses to hamburger
- Hero band: code mockup card moves below text on mobile
- Pricing tiers: 3-column → 2-column tablet → 1-column mobile
- Course catalog: 3-up → 2-up tablet → 1-up mobile
- Hero typography: 72px → 56px → 48px → 36px
- Footer: 6-column desktop → 3-column tablet → accordion mobile
Image Behavior
- Atmospheric AI imagery uses 16:9 ratio with full-bleed scaling
- Code mockup card content remains readable across breakpoints
- Customer logo wall: wordmarks at consistent 60–80px height
Iteration Guide
- Focus on ONE component at a time
- Reference component names and tokens directly
- Run
npx @google/design.md lint DESIGN.md after edits
- Add new variants as separate
components: entries
- Default to
{typography.body-md} for body
- Keep
{colors.brand-green} as the primary CTA across all surfaces
- Pill-shaped buttons (
{rounded.full}) always
- Dark-teal hero bands frame primary CTAs
Known Gaps
- Specific dark-mode token values for canvas/surface beyond hero bands not surfaced
- Animation/transition timings not extracted; recommend 150–200ms ease
- Form validation success state not explicitly captured
- Course-tile category color mappings are observation-based
1---2name: mongodb-design-analysis3description: Documents MongoDB's visual design system including colors, typography, layout, elevation, and shapes for UI implementation.4---56## Overview78MongoDB carries a strong dual-mode visual identity — dark deep-teal hero bands with the unmistakable bright MongoDB green ({colors.brand-green}) CTA pill paired with stark white documentation and pricing surfaces. The homepage opens with "One data platform. Unlimited AI potential." headline over a deep navy hero, the green pill sitting at the visual center as the primary CTA. Lower on the page, embedded code mockup cards (terminal-aesthetic) sit on the dark hero band, breaking out into white feature cards below. The pricing page renders a 3-tier comparison (Free / Flex / Dedicated) with a featured tier highlighted in soft mint background and bright green border. The MongoDB University page presents a course catalog grid where each tile carries a colored category tag (orange, purple, green, teal) — these are MongoDB's category-encoding accent colors and are the only place outside the brand green where saturated color appears.910The system uses Euclid Circular A as its display face. The face is contemporary geometric — confident but not overly playful — and pairs naturally with both the developer-tool aesthetic of the database product and the educational positioning of the learning surfaces. Cards use `{rounded.lg}` (12px) corners; buttons use `{rounded.full}` pills universally. The brand-teal palette ({colors.brand-teal-deep}) anchors hero bands, footer, code mockups, and the dark CTA banners.1112**Key Characteristics:**13- Deep navy/teal hero bands ({colors.brand-teal-deep}) with bright MongoDB green ({colors.brand-green}) CTA pills14- Stark white pricing/documentation surfaces with colored category tags for course tiles (purple, orange, green, teal)15- Euclid Circular A across every UI surface16- Pill-shaped buttons ({rounded.full}) and 12px-rounded cards17- 3-tier pricing comparison (Free / Flex / Dedicated) with featured-mint highlight tier18- Code mockup cards with terminal-aesthetic dark canvas1920## Colors2122> Source pages: mongodb.com/ (homepage), /products/platform/atlas-database (Atlas product), /products/self-managed/community-edition, learn.mongodb.com/ (MongoDB University), /solutions/use-cases/artificial-intelligence (AI), /pricing (3-tier comparison). Token coverage was identical across all six pages.2324### Brand & Accent25- **MongoDB Green** ({colors.brand-green}): The brand's most recognizable signal — bright pill-CTA color26- **Green Dark** ({colors.brand-green-dark}): Inline link color, secondary green27- **Green Mid** ({colors.brand-green-mid}): Mid-spectrum green for atmospheric tints28- **Green Soft** ({colors.brand-green-soft}): Pale-mint background tint for success badges and featured pricing tier29- **Brand Teal Deep** ({colors.brand-teal-deep}): Deep navy-teal for hero bands, footer30- **Brand Teal** ({colors.brand-teal}): Mid-spectrum teal31- **Brand Teal Mid** ({colors.brand-teal-mid}): Lighter teal for hero platform cards3233### Category Accent (Course Tags)34- **Accent Purple** ({colors.accent-purple}): Course tag for "Database & Security"35- **Accent Orange** ({colors.accent-orange}): Course tag for "Search"36- **Accent Pink** ({colors.accent-pink}): Course tag variant37- **Accent Blue** ({colors.accent-blue}): Course tag variant for atlas/cloud topics3839### Surface40- **Canvas White** ({colors.canvas}): Page background and primary card surface41- **Canvas Dark** ({colors.canvas-dark}): Code-block backgrounds, dark mockup canvas42- **Surface** ({colors.surface}): Subtle section backgrounds, search-pill rest43- **Surface Soft** ({colors.surface-soft}): Quieter section divisions44- **Surface Feature** ({colors.surface-feature}): Pale mint background for featured pricing tier45- **Hairline** ({colors.hairline}): 1px borders and primary dividers46- **Hairline Soft** ({colors.hairline-soft}): Quieter dividers47- **Hairline Strong** ({colors.hairline-strong}): Stronger 1px border for inputs48- **Hairline Dark** ({colors.hairline-dark}): Border on dark surfaces4950### Text51- **Ink** ({colors.ink}): Primary headlines and body text (deep navy-teal)52- **Charcoal** ({colors.charcoal}): Body emphasis53- **Slate** ({colors.slate}): Secondary text54- **Steel** ({colors.steel}): Tertiary text, captions55- **Stone** ({colors.stone}): Muted labels56- **Muted** ({colors.muted}): Disabled, placeholders57- **On Dark** ({colors.on-dark}): White text on dark surfaces58- **On Dark Muted** ({colors.on-dark-muted}): Reduced-opacity white5960### Semantic61- **Warning Background** ({colors.semantic-warning-bg}): Pale yellow callout bg62- **Warning Text** ({colors.semantic-warning-text}): Warning state copy color6364## Typography6566### Font Family67**Euclid Circular A** (primary): MongoDB's geometric sans-serif. Fallbacks: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif.68**Source Code Pro** (code): Monospace for code mockups. Fallbacks: 'SF Mono', Menlo, Consolas, monospace.6970### Hierarchy7172| Token | Size | Weight | Line Height | Letter Spacing | Use |73|---|---|---|---|---|---|74| `{typography.hero-display}` | 72px | 500 | 1.10 | -1.5px | Hero ("One data platform") |75| `{typography.display-lg}` | 56px | 500 | 1.15 | -1px | Major section openers |76| `{typography.heading-1}` | 48px | 500 | 1.20 | -0.5px | Page-level headlines |77| `{typography.heading-2}` | 36px | 500 | 1.25 | -0.5px | Subsection headlines |78| `{typography.heading-3}` | 28px | 500 | 1.30 | 0 | Card titles |79| `{typography.heading-4}` | 22px | 500 | 1.35 | 0 | Feature tile titles |80| `{typography.heading-5}` | 18px | 600 | 1.40 | 0 | Smaller card titles, FAQ questions |81| `{typography.subtitle}` | 18px | 400 | 1.50 | 0 | Hero subtitle, lead body |82| `{typography.body-md}` | 16px | 400 | 1.55 | 0 | Primary body text |83| `{typography.body-sm}` | 14px | 400 | 1.50 | 0 | Secondary body, table cells |84| `{typography.body-sm-medium}` | 14px | 500 | 1.50 | 0 | Active sidebar, button labels |85| `{typography.caption-bold}` | 13px | 600 | 1.40 | 0 | Badge labels |86| `{typography.micro-uppercase}` | 11px | 600 | 1.40 | 1px | Section eyebrows, course category tags |87| `{typography.button-md}` | 14px | 600 | 1.30 | 0 | Pill button labels |88| `{typography.code-md}` | 14px | 400 | 1.55 | 0 | Code mockups |8990### Principles91- Tight hero leading (1.10) on 72px display92- Negative letter-spacing on display sizes (-1.5px to -0.5px)93- 600 weight reserved for buttons and small emphasis (FAQ headings, badges)94- Generous body leading (1.55) for technical documentation readability9596## Layout9798### Spacing System99- **Base unit**: 4px (8px primary increment)100- **Tokens**: `{spacing.xxs}` (4px) through `{spacing.hero}` (120px)101- **Section rhythm**: Marketing pages use `{spacing.section-lg}` (96px); pricing tightens to `{spacing.section}` (64px)102103### Grid & Container104- 1280px max-width with 32px gutters105- Pricing: 3-tier card row, dense feature comparison table below106- Learn catalog: 3-up course tile grid, 4-up certification grid107- AI use cases: 2-column hero with atmospheric illustration108109### Whitespace Philosophy110Marketing surfaces give content generous breathing room — `{spacing.hero}` (120px) hero padding for deep teal bands. Pricing/learn surfaces tighten dramatically.111112## Elevation & Depth113114| Level | Treatment | Use |115|---|---|---|116| 0 (flat) | No shadow; `{colors.hairline}` border | Default cards, table rows |117| 1 (subtle) | `rgba(0, 30, 43, 0.04) 0px 1px 2px 0px` | Hover-elevated tiles |118| 2 (card) | `rgba(0, 30, 43, 0.08) 0px 4px 12px 0px` | Feature cards |119| 3 (mockup) | `rgba(0, 30, 43, 0.12) 0px 12px 24px -4px` | Code mockup over hero |120| 4 (modal) | `rgba(0, 30, 43, 0.16) 0px 16px 48px -8px` | Modals, dropdowns |121122### Decorative Depth123- Dark teal hero bands carry atmospheric gradient depth124- Code mockup cards on hero use canvas-dark surface with terminal aesthetic125- Pale-mint pricing-feature tier uses brand-tinted shadow126127## Shapes128129### Border Radius Scale130131| Token | Value | Use |132|---|---|---|133| `{rounded.xs}` | 4px | Course category tags |134| `{rounded.sm}` | 6px | Type badges, code chips |135| `{rounded.md}` | 8px | Inputs, search-pill, code blocks |136| `{rounded.lg}` | 12px | Cards, pricing tiers, course tiles |137| `{rounded.xl}` | 16px | Larger feature panels |138| `{rounded.xxl}` | 24px | Featured product showcases |139| `{rounded.full}` | 9999px | All buttons, status badges |140141### Photography Geometry142- Hero illustrations sit on full-bleed dark backgrounds143- Course tile thumbnails use `{rounded.lg}` corners144- Customer logos wall: wordmarks at consistent 60–80px height145146## Components147148> Per the no-hover policy, hover states are NOT documented. Default and pressed/active states only.149150### Buttons151152**`button-primary`** — Bright MongoDB green pill primary CTA, the dominant action.153- Background `{colors.brand-green}`, text `{colors.on-primary}` (deep navy), typography `{typography.button-md}`, padding `10px 22px`, rounded `{rounded.full}`.154- Pressed state `button-primary-pressed` deepens to `{colors.primary-pressed}`.155- Disabled state `button-primary-disabled` uses `{colors.hairline}` background.156157**`button-secondary`** — Outlined pill for secondary actions.158- Background transparent, text `{colors.ink}`, border `1px solid {colors.hairline-strong}`, typography `{typography.button-md}`, padding `10px 22px`, rounded `{rounded.full}`.159160**`button-on-dark`** — Bright green pill on dark hero bands.161- Background `{colors.brand-green}`, text `{colors.on-primary}`, typography `{typography.button-md}`, padding `10px 22px`, rounded `{rounded.full}`.162163**`button-secondary-on-dark`** — Outlined pill on dark backgrounds.164- Background transparent, text `{colors.on-dark}`, border `1px solid {colors.hairline-dark}`, typography `{typography.button-md}`, padding `10px 22px`, rounded `{rounded.full}`.165166**`button-ghost`** — Quieter rectangular ghost button.167- Background transparent, text `{colors.ink}`, typography `{typography.button-md}`, padding `8px 12px`, rounded `{rounded.md}`.168169**`button-link`** — Inline green text link.170- Background transparent, text `{colors.brand-green-dark}`, typography `{typography.body-sm-medium}`, padding `0`.171172### Cards & Containers173174**`card-base`** — Standard content card.175- Background `{colors.canvas}`, rounded `{rounded.lg}`, padding `{spacing.xl}`, border `1px solid {colors.hairline}`.176177**`card-feature`** — Feature card with larger padding.178- Background `{colors.canvas}`, rounded `{rounded.lg}`, padding `{spacing.xxl}`, border `1px solid {colors.hairline}`.179180**`card-product-deploy`** — Product deployment card ("MongoDB Atlas / Community").181- Background `{colors.canvas}`, rounded `{rounded.lg}`, padding `{spacing.xxl}`, border `1px solid {colors.hairline}`.182183**`card-feature-dark`** — Dark teal feature card on hero band.184- Background `{colors.brand-teal-deep}`, text `{colors.on-dark}`, rounded `{rounded.lg}`, padding `{spacing.xxl}`.185186**`card-course`** — MongoDB University course tile.187- Background `{colors.canvas}`, rounded `{rounded.lg}`, padding `{spacing.xl}`, border `1px solid {colors.hairline}`.188- Top: colored category tag. Below: title `{typography.heading-5}`, description `{typography.body-sm}`, "Get Started →" link.189190**`card-cert`** — Certification card.191- Background `{colors.canvas}`, rounded `{rounded.lg}`, padding `{spacing.xl}`, border `1px solid {colors.hairline}`.192193**`pricing-card`** — Standard pricing tier card.194- Background `{colors.canvas}`, rounded `{rounded.lg}`, padding `{spacing.xxl}`, border `1px solid {colors.hairline}`.195196**`pricing-card-featured`** — Featured pricing tier (Flex tier, mint background + green border).197- Background `{colors.surface-feature}`, rounded `{rounded.lg}`, padding `{spacing.xxl}`, border `2px solid {colors.brand-green}`.198199### Inputs & Forms200201**`text-input`** — Standard text field.202- Background `{colors.canvas}`, text `{colors.ink}`, border `1px solid {colors.hairline-strong}`, rounded `{rounded.md}`, padding `{spacing.sm} {spacing.md}`, height 44px.203204**`text-input-focused`** — Activated state.205- Border switches to `2px solid {colors.brand-green-dark}`.206207**`search-pill`** — Standard 44px search bar.208- Background `{colors.surface}`, text `{colors.steel}`, typography `{typography.body-md}`, rounded `{rounded.md}`, height 44px, border `1px solid {colors.hairline-strong}`.209210**`search-pill-large`** — Large 56px search bar (top of MongoDB University catalog).211- Background `{colors.canvas}`, text `{colors.steel}`, typography `{typography.body-md}`, rounded `{rounded.md}`, height 56px, border `1px solid {colors.hairline-strong}`.212213### Tabs214215**`pill-tab`** + **`pill-tab-active`** — Pill-style tab nav (top of pricing: "MongoDB Atlas / Enterprise Advanced").216- Inactive: text `{colors.steel}`, border `1px solid {colors.hairline}`, padding `{spacing.xs} {spacing.md}`, rounded `{rounded.full}`.217- Active: background `{colors.ink}`, text `{colors.on-dark}`.218219**`segmented-tab`** + **`segmented-tab-active`** — Underline-style tab navigation.220- Inactive: text `{colors.steel}`, no border. Active: text `{colors.brand-green-dark}`, 2px bottom border in `{colors.brand-green-dark}`.221222### Badges & Status223224**`badge-green`** — Bright green badge for new product highlights.225- Background `{colors.brand-green}`, text `{colors.on-primary}`, typography `{typography.caption-bold}`, rounded `{rounded.sm}`, padding `2px 8px`.226227**`badge-green-soft`** — Pale-mint pill for success/free indicators.228- Background `{colors.brand-green-soft}`, text `{colors.brand-green-dark}`, typography `{typography.caption-bold}`, rounded `{rounded.full}`, padding `4px 10px`.229230**`badge-purple`** — Purple course category tag.231- Background `{colors.accent-purple}`, text `{colors.on-dark}`, typography `{typography.caption-bold}`, rounded `{rounded.sm}`, padding `2px 8px`.232233**`badge-orange`** — Orange course category tag.234- Background `{colors.accent-orange}`, text `{colors.on-dark}`, typography `{typography.caption-bold}`, rounded `{rounded.sm}`, padding `2px 8px`.235236**`badge-popular`** — "Most Popular" tier indicator (dark teal pill with green text).237- Background `{colors.brand-teal-deep}`, text `{colors.brand-green}`, typography `{typography.caption-bold}`, rounded `{rounded.full}`, padding `4px 10px`.238239**`promo-banner`** — Dark teal sticky promo strip ABOVE the top nav.240- Background `{colors.brand-teal-deep}`, text `{colors.on-dark}`, typography `{typography.body-sm-medium}`, padding `{spacing.sm} {spacing.md}`.241242### Code243244**`code-block`** — Code container.245- Background `{colors.canvas-dark}`, text `{colors.on-dark}`, typography `{typography.code-md}`, rounded `{rounded.md}`, padding `{spacing.md}`.246247**`code-mockup-card`** — Embedded code mockup on hero band.248- Background `{colors.canvas-dark}`, text `{colors.on-dark}`, rounded `{rounded.lg}`, padding `{spacing.lg}`. Carries terminal-aesthetic code snippet.249250### Tables251252**`comparison-table`** — Pricing feature comparison table.253- Background `{colors.canvas}`, text `{colors.ink}`, typography `{typography.body-sm}`, rounded `{rounded.md}`, border `1px solid {colors.hairline}`.254255**`comparison-row`** — Individual feature row.256- Background `{colors.canvas}`, text `{colors.ink}`, padding `{spacing.md} {spacing.lg}`, bottom border `1px solid {colors.hairline-soft}`.257258### Documentation Components259260**`service-tile`** — Tile in "Customize your deployment" 6-up grid.261- Background `{colors.canvas}`, rounded `{rounded.lg}`, padding `{spacing.xl}`, border `1px solid {colors.hairline}`.262263**`why-card`** — "Loved by builders" feature card.264- Background `{colors.surface}`, rounded `{rounded.lg}`, padding `{spacing.xl}`.265266**`customer-testimonial-card`** — Customer quote card.267- Background `{colors.canvas}`, rounded `{rounded.lg}`, padding `{spacing.xxl}`, border `1px solid {colors.hairline}`.268269**`logo-wall-item`** — Customer logo wordmark cell.270- Background transparent, text `{colors.steel}`, typography `{typography.body-md-medium}`, padding `{spacing.lg}`.271272**`faq-accordion-item`** — FAQ panel.273- Background `{colors.canvas}`, rounded `{rounded.md}`, padding `{spacing.xl}`, bottom border `1px solid {colors.hairline}`.274275### Navigation276277**Top Navigation (Marketing)** — Sticky white bar.278- Background `{colors.canvas}`, height ~64px, bottom border `1px solid {colors.hairline}`.279- Left: MongoDB leaf logo + "Solutions / Resources / Company / Pricing" links.280- Right: "Sign In" link + bright-green pill "Try Free" CTA.281282### Signature Components283284**`hero-band-dark`** — Deep teal hero band with embedded code mockup.285- Background `{colors.brand-teal-deep}`, text `{colors.on-dark}`, padding `{spacing.hero}`.286- Layout: centered headline `{typography.hero-display}`, subtitle, button row, `code-mockup-card` below.287288**`hero-platform-card`** — Lighter-teal platform showcase card on dark hero.289- Background `{colors.brand-teal-mid}`, text `{colors.on-dark}`, rounded `{rounded.xl}`, padding `{spacing.xxl}`.290291**`cta-banner-dark`** — Dark CTA banner at the bottom of feature pages.292- Background `{colors.brand-teal-deep}`, text `{colors.on-dark}`, rounded `{rounded.lg}`, padding `{spacing.section}`.293294**`footer-region`** — Dark teal multi-column footer.295- Background `{colors.brand-teal-deep}`, padding `{spacing.section} {spacing.xxl}`.296- 6-column link grid.297- Section headings in `{typography.body-sm-medium}` `{colors.on-dark}`.298299**`footer-link`** — Individual footer link.300- Background transparent, text `{colors.on-dark-muted}`, typography `{typography.body-sm}`, padding `{spacing.xxs} 0`.301302## Do's and Don'ts303304### Do305- Use `{colors.brand-green}` (bright MongoDB green) for primary CTAs everywhere306- Pair dark-teal hero bands with bright green CTA pills307- Apply `{rounded.full}` to every button, every status badge308- Apply `{rounded.lg}` (12px) to cards consistently309- Use category accent colors (purple, orange, green, teal) ONLY for course tags310- Maintain Euclid Circular A across every UI surface311- Use code mockup cards with terminal-aesthetic content for product showcases312313### Don't314- Don't use the bright green for body text or large surfaces315- Don't introduce additional accent colors beyond the brand green and category-encoding palette316- Don't soften corners on buttons; the pill is a brand signature317- Don't replace deep teal hero bands with white hero bands318- Don't apply heavy shadows on flat documentation cards; reserve elevation for code mockups319- Don't use Source Code Pro for prose320321## Responsive Behavior322323### Breakpoints324| Name | Width | Key Changes |325|---|---|---|326| Mobile (small) | < 480px | Single column. Hero 36px. Pricing 1-up. Course catalog 1-up. |327| Mobile (large) | 480 – 767px | Course tiles 2-up. Hero 48px. |328| Tablet | 768 – 1023px | 2-column feature grids. Hero 56px. |329| Desktop | 1024 – 1279px | 3-tier pricing card row. 3-up course catalog. Hero 64px. |330| Wide Desktop | ≥ 1280px | Full 72px hero presentation. |331332### Touch Targets333- Pill buttons render at 40–44px effective height334- Form inputs render at 44px height335- Search pill (large) renders at 56px336- Pill tabs ~32px → 44px on mobile337338### Collapsing Strategy339- **Promo banner** stays full-width; truncates at < 480px340- **Top nav** below 1024px collapses to hamburger341- **Hero band**: code mockup card moves below text on mobile342- **Pricing tiers**: 3-column → 2-column tablet → 1-column mobile343- **Course catalog**: 3-up → 2-up tablet → 1-up mobile344- **Hero typography**: 72px → 56px → 48px → 36px345- **Footer**: 6-column desktop → 3-column tablet → accordion mobile346347### Image Behavior348- Atmospheric AI imagery uses 16:9 ratio with full-bleed scaling349- Code mockup card content remains readable across breakpoints350- Customer logo wall: wordmarks at consistent 60–80px height351352## Iteration Guide3533541. Focus on ONE component at a time3552. Reference component names and tokens directly3563. Run `npx @google/design.md lint DESIGN.md` after edits3574. Add new variants as separate `components:` entries3585. Default to `{typography.body-md}` for body3596. Keep `{colors.brand-green}` as the primary CTA across all surfaces3607. Pill-shaped buttons (`{rounded.full}`) always3618. Dark-teal hero bands frame primary CTAs362363## Known Gaps364365- Specific dark-mode token values for canvas/surface beyond hero bands not surfaced366- Animation/transition timings not extracted; recommend 150–200ms ease367- Form validation success state not explicitly captured368- Course-tile category color mappings are observation-based