Make your AI a shadcn expert

X Design System

X's login-page design system as a DESIGN.md file.

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

  1. 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
  2. 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
  3. System-UI for all body textonly TwitterChirpExtendedHeavy appears at display scale; navigation, labels, and body copy run the browser's default system-UI stack
  4. Pill-only radius9999px is the sole border-radius value in the system; every button, every social-login option, every input is fully pill-rounded
  5. 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.

Screenshot of X's website at x.comx.com

Explore 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.

Specs, directories, and component libraries that pair with this design system.

Use X in your project

One machine-readable file. Drop it into Claude, Cursor, or any AI tool that reads DESIGN.md.

Download DESIGN.md