About X DESIGN.md
Curated by Dov AzencotUpdated Source x.com
- Social & Community
X's login page is the most opinionated single-viewport design in the social-platform category — a stark white canvas bisected into left and right panels, the left half containing nothing but the black X logotype at approximately 300px, and the right half containing a stacked sign-up form. No carousel, no product screenshots, no user-generated content preview. No photography. The 64px "Happening now" headline in TwitterChirpExtendedHeavy sits above the form; below it, two social-login pills (Continue with Google, Continue with Apple), a dividing "OR" label, and three more pills: Create account, Sign in, Get Grok. Every interactive element is a pill — 9999px border-radius across the entire component set. The one color decision is that the "Create account" primary CTA has a black fill with white text, which is the X brand mark color-inverted into a button. Where Instagram's login page shows a phone carousel and Facebook's shows a product description, X shows only the mark.
The DESIGN.md file packages the system as a machine-readable spec for React and AI tools. Inside: 8 color tokens centered on pure black (#000000) and the near-black page-text tone (#0f1419), two blue-gray muted-text tones (#536471, #829aab), the legacy Twitter blue (#1d9bf0) appearing only on hyperlinks in legal text, and white (#ffffff) as the form panel background. Seven typography tokens span TwitterChirpExtendedHeavy at two display sizes and system-UI at six body-and-label sizes. A single radius token (9999px pill) and 12 component definitions cover the split hero, the stacked sign-up form, the pill buttons, and the footer navigation.
Feed this file to Claude or Cursor and it reproduces X's specific moves: split-screen layout with the logotype occupying the full left panel, pill geometry for every interactive element, black-on-white CTA as an inverted-mark button, and complete chromatic reduction — no accent color in the UI chrome. The system is worth studying because it demonstrates how far chromatic elimination can go: a network with 500 million users has reduced its public-facing login surface to two colors, one typeface, one radius value. The restraint is not timidity — it is the post-rebrand identity asserting that the mark alone is enough.
What makes it distinct
- Black X mark as the left halfthe logotype occupies the full left panel of the split-screen layout at ~300px, serving as both brand mark and visual anchor
- Zero brand accent colorthe entire UI chrome is black, white, and blue-gray; no Twitter-blue #1da1f2 or X-specific accent in any interactive element
- System-UI for all body textonly TwitterChirpExtendedHeavy appears at display scale; navigation, labels, and body copy run the browser's default system-UI stack
- Pill-only radius9999px is the sole border-radius value in the system; every button, every social-login option, every input is fully pill-rounded
- Primary CTA is an inverted brand markthe 'Create account' button is black fill on white canvas with white label text, the same tonal flip as the X mark itself
Live at x.com
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
x.comExplore X
Pick what you want to see — mockups, colors, typography, layout, or the full component list.
Surface
Page and card backgrounds.
Text
Headlines, body, captions, muted.
Borders & Hairlines
Dividers, outlines, structural rules.
X design system FAQ
Common questions about X'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.
X — official site
X's public homepage — 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.