Vercel DESIGN.md

Design System Inspiration of Vercel

Overview

Visual Theme & Atmosphere

Vercel is a developer platform for building, deploying, and operating web applications, with Next.js and AI-oriented application workflows central to its current public story. The interface turns infrastructure into a visual grid: white fields, near-black type, hairline #ebebeb boundaries, technical diagrams, code-adjacent labels, and large compressed headings. Product imagery and system diagrams carry complexity while the surrounding UI remains deliberately quiet, connecting developer precision with a clear editorial explanation of the platform's direction and scope.

The current home is more typographically expansive than the prior snapshot. A 64px/400 hero and repeated 56px/450 section headings use strong negative tracking, while 30px feature statements and dense 14px UI layers connect editorial storytelling to developer tooling. GeistSans is the loaded implementation alias on 428 visible elements; the official family is Geist. Geist Mono loaded across 65 elements and marks commands, technical labels, and code-adjacent content.

The official Geist documentation makes the system inspectable beyond marketing. Its examples expose 6px ring-bordered controls, 36px compact actions and inputs, 32px radio controls, and flat 32px-padded example cards. These examples are valid Geist system evidence, but they do not automatically describe every authenticated Vercel dashboard state.

Key Characteristics:

• White canvas with #171717, #4d4d4d, and #666666 information steps
• Geist with strongly negative tracking at 64px, 56px, 30px, and 24px scales
• Geist Mono as a genuine loaded technical companion
• #ebebeb hairlines and ring-borders instead of decorative elevation
• Flat grid compositions and 6px compact official controls
• Strict boundary between public home, Geist examples, and authenticated product UI

Primary tasks

• Evaluate how to build and deploy an application
• Compare the platform, framework, AI, and enterprise capabilities
• Consult the official Geist design system while building an interface

Brand Narrative

Vercel evolved from ZEIT into a platform closely associated with Next.js and the frontend cloud, then expanded its story toward AI-native application development. Geist makes that evolution visible: a type and component system shaped for interfaces where code, deployment state, documentation, and product storytelling meet. The triangle symbol, monochrome structure, and tight typography keep the platform recognizable without relying on a broad color palette. The platform narrative consistently moves complexity behind a clearer developer workflow: source becomes a deployment, a deployment becomes an inspectable environment, and a team can iterate on the result. Current AI messaging extends that same premise to models and generated application experiences rather than replacing the foundation. Hairline grids, technical diagrams, and mono labels make infrastructure legible; large Geist headings make the product direction legible to a broader audience.

Principles

1. Remove infrastructure noise. Visual structure should clarify the application and its state.
2. Make technical content native. Type, grids, and mono roles should serve real information.
3. Use precise defaults. Small control geometry and neutral boundaries should be consistent.
4. Keep evidence layers explicit. Geist examples are reusable system evidence; marketing and private dashboard UI remain separate, and one must not silently fill gaps in another.

Personas

First-party material establishes task contexts only:

• A developer evaluating how to build and deploy an application.
• A team comparing platform, framework, AI, or enterprise capabilities.
• A designer or engineer consulting the official Geist system.

Project-specific names, company size, stack, deployment volume, budget, and success metrics are intentionally unspecified and must come from the product brief.

Colors

• Primary/foreground (#171717): current headings, controls, and technical content.
• Canvas (#ffffff): dominant page and control surface.
• Body (#4d4d4d): current explanatory and navigation text.
• Muted (#666666): supporting public copy.
• Border (#ebebeb): highly repeated grid, ring, and boundary color.
• Subtle surface (#fafafa): quiet current section/background tint.

Earlier Ship red, Preview pink, Develop blue, console syntax colors, link blue, and badge blue are omitted because this capture did not establish reusable current roles for them. Their historical or local presence does not authorize global tokens.

Typography

Font evidence boundary

Layout

• Use hairline grids to organize technical complexity without heavy containers.
• Let large compressed headings alternate with diagrams, code, and product imagery.
• Keep compact system controls at 32–36px and 4–6px radius.
• Use Geist Mono where content is genuinely technical, not as decorative developer flavor.
• Separate marketing compositions from reusable Geist examples and authenticated product patterns.

Responsive Behavior

The current public site reflows large headings, technical diagrams, and grid sections while maintaining the neutral hierarchy. Official Geist examples remain compact and composable. Authenticated dashboard breakpoints, mobile project navigation, and deployment-log overflow remain unresolved.

Elevation & Depth

The current promoted system is primarily planar. 0 0 0 1px #ebebeb creates a ring-boundary without changing box geometry. Earlier multi-layer card shadows are not retained as universal current tokens.

Values kept in prose

Measured values the DESIGN.md token grammar cannot carry, kept verbatim:

• shadow.control-ring: 0 0 0 1px #ebebeb

Motion & Easing

No reusable duration or easing curve is promoted. Baseline DOM capture cannot establish a universal motion system, and the current reference does not infer one.

---

Verified: 2026-07-12 (omd:migrate) Tier 1 sources: https://vercel.com/ ; https://vercel.com/geist/introduction ; https://vercel.com/font Tier 2 attempts: getdesign.md/vercel supplied a directory entry only; Refero had no reliable Vercel record Conflicts unresolved: none

Components

Current public home

Header link

• Transparent / #4d4d4d, 0px radius, 32px height
• Geist 14px/400
• Default captured; no current hover or pressed value promoted from the baseline-only run

Official Geist examples

Secondary action

• White / #171717, 6px radius, 36px height, 0 10px
• 0 0 0 1px #ebebeb ring; Geist 14px/500

Icon button

• White / #171717, 36px square, 6px radius, #ebebeb ring

Compact input

• White / #171717, 36px height, 0 12px, Geist 14px/400
• Captured as the rectangular input region beside a ring-bordered control; no separate universal focus value promoted

Radio

• Transparent / #4d4d4d, 32px circle; unchecked state observed

Component-example card

• Transparent / #171717, 0px radius, 32px padding, 24px internal gap
• Participates in the shared #ebebeb documentation grid rather than carrying an independent floating shadow

Login CTAs, dashboard project cards, deployment states, command menus, badges, toasts, and authenticated inputs are omitted until a current accessible product path verifies their exact implementation.

Published component roster (72 not measured here)

Geist publishes 72 components, enumerated by its own sidebar index at https://vercel.com/geist/introduction (read 2026-09-19). No value, state, or geometry is asserted for any name below.

avatar, badge, banner, book, breadcrumbs, browser, button, calendar, checkbox, choicebox, clearable-input, code, code-block, collapse, combobox, command-menu, context-card, context-menu, copy-button, description, destructive-action-modal, dots-menu, drawer, empty-state, entity, error, error-card, feedback, fieldset, file-tree, gauge, grid, input, json-view, keyboard-input, label, load-more-button, loading-dots, menu, middle-truncate, modal, multi-select, note, pagination, phone, pill, progress, project-banner, radio, relative-time-card, scroller, search-input, select, separator, sheet, show-more, skeleton, slider, snippet, spinner, split-button, status-dot, switch, table, tabs, text-with-copy-button, textarea, theme-switcher, toast, toggle, tooltip, video

The list is flat because the index publishes one flat Components group with no sub-categories. Its two sibling groups are excluded, and they are the only exclusions: Foundations (introduction, colors, typography, materials) and Brands (brands, whose six entries are in-page anchors for the Vercel, Next.js, Turbo, v0, eve, and AI SDK marks). Those five pages are the entire difference between the 76 URLs under /geist/ in vercel.com's sitemap and the 71 component pages; the sitemap carries 7,167 URLs in total, and the remaining 7,091 are marketing, docs, and knowledge base, not Geist. grid stays because the index files Grid under Components — the sitemap alone would not have said so. pill is the 72nd name and the only one without a page of its own: the index points it at /geist/badge#pill.

What this reference measured instead

The six stylings above are recorded under this reference's own descriptors rather than Geist's names, and none of them was read from a component page.

header-link came from the vercel.com public home, a marketing surface and a separate evidence domain from the Geist documentation, so it is not drawn from the roster at all.

The other five came from /geist/introduction itself — they are the controls the index renders inside its own landing grid, captured 2026-07-12. Geist publishes Button, Input, and Radio among the 72, and this reference's labels name a secondary action, an icon button, a compact input, and a radio; whether the geometry recorded above is any published component's is not established here, because /geist/button, /geist/input, and /geist/radio were never opened. geist-example-card is the introduction page's own documentation grid cell — documentation chrome, not a component Geist publishes.

geist-live and vercel-component-index are the same URL. This reference already cited the page that lists all 72, and measured five examples off it, without reading the index that page carries. Both entries are kept, because they record different observations on different dates.

States

The official Geist radio exposed an unchecked state, and one compact icon action exposed disabled in the baseline. The canonical controls otherwise retain explicit default-only state boundaries. Hover, focus, pressed, loading, success, error, deployment, and authenticated dashboard states are absent unless separately recaptured.

Do's and Don'ts

Do

• Use the exact current neutral hierarchy and #ebebeb grid logic.
• Preserve Geist's observed negative tracking and moderate weights.
• Use official Geist examples for reusable controls while naming their documentation context.
• Keep public, documentation, and authenticated evidence separate.

Don't

• Do not reintroduce workflow accents or badge colors from an older snapshot without current evidence.
• Do not make every developer label monospace.
• Do not invent dashboard, deployment, login, or command-menu states.
• Do not apply layered elevation where a hairline grid is the verified structure.

Voice & Tone

Vercel's public language is technical, direct, and outcome-oriented. It connects platform capability to building, shipping, scaling, and AI application work without explaining every infrastructure detail up front. Product and documentation copy should name the artifact or system involved—application, deployment, framework, model, environment, or team—and connect it to an observable next action. Enterprise material can discuss coordination and reliability but should remain concrete. Prefer active verbs, precise platform nouns, and short supporting explanations. Avoid invented performance numbers or universal claims not present in current first-party material.

Agent Prompt Guide

Build a precise developer-platform surface on white with #171717 headings, #4d4d4d body text, #ebebeb grid lines, Geist with compressed large-scale tracking, Geist Mono for technical content, and flat 6px ring-bordered controls. Omit unverified dashboard and deployment states.

Governance

Known Gaps

• Contrast, header-link. Text #4d4d4d on #00000000 measures 2.48:1, below the WCAG AA 4.5:1 minimum for normal-size text. Recorded as measured, not adjusted.
• Contrast, geist-radio. Text #4d4d4d on #00000000 measures 2.48:1, below the WCAG AA 4.5:1 minimum for normal-size text. Recorded as measured, not adjusted.
• Contrast, geist-example-card. Text #171717 on #00000000 measures 1.17:1, below the WCAG AA 4.5:1 minimum for normal-size text. Recorded as measured, not adjusted.