About TikTok DESIGN.md
Curated by Dov AzencotUpdated Source tiktok.com
- Social & Community
- Music, Video & Streaming
TikTok's interface does something almost no other social platform attempts: the feed is a single scrollable column of full-bleed 9:16 vertical clips rather than a grid of cards. Each clip fills the visible viewport top to bottom, with a 240px right-rail action stack carrying a circular avatar, a saturated magenta heart icon with a like count, a comment-bubble icon with a count, a share-arrow icon, and a spinning music-disc avatar. The black canvas runs edge-to-edge behind the video, and the brand chrome — the wordmark in the top-left, the search field centered, the "For You" / "Following" tabs above the active clip — sits as overlay text in pure white. There is no surface lift, no atmospheric gradient between elements; the video is the surface, and the chrome floats on top.
The chromatic move is a brand split. The wordmark carries a chromatic-aberration treatment — a cyan offset shadow behind the white text and a magenta offset to its right — which signals the "shifted layers" motion language used across the brand. The primary "Sign up" pill on the right-rail card fills with a saturated magenta; the heart icon, the magenta is the same hue. The secondary "Log in" pill outlines with a 1px white hairline on the black canvas. Neither cyan nor magenta appears on body text, on hairlines, or on hover states — both colors are scoped tightly to brand identity moments.
The DESIGN.md file packages the system into a machine-readable spec for React tooling. Inside: 11 color tokens covering the load-bearing pure black canvas and white ink, the cyan and magenta brand split, three structural greys for secondary captions and disabled states, plus a translucent surface tone for the overlay chrome on top of video; 9 typography tokens spanning the platform system sans stack at 14 to 24px, with weight 600 carrying display labels and weight 400 carrying running text; five radii topped by a full pill for CTAs and circular avatars; and 14 component recipes covering the video tile, the right-rail action stack, the brand wordmark, the magenta Sign up pill, and the bottom-bar nav. Note that the captured marketing surface returned a login wall rather than rendered chrome, so the colors and components below reflect TikTok's published brand standards and the rendered application UI rather than CSS values extracted from the captured page.
What makes it distinct
- Cyan-magenta brand splitthe cyan offsets the wordmark as a chromatic-aberration shadow, the magenta carries the primary Sign up CTA, neither appears on body chrome
- Pure black canvasthe page floor is true black, not the slightly-blue near-black that Spotify and Netflix use, to maximize contrast with the full-bleed vertical video
- Vertical-video columnthe feed is a single 9:16 scrollable column rather than a grid, with a 240px right-rail action stack carrying like, comment, and share
- System sans across every tierSF Pro Display on iOS and Segoe UI on Windows carry every label, with no proprietary face shipped for the marketing chrome
- Pill CTAs at full-pillthe Sign up and Log in pills round to fully-circular geometry, paired with circular avatar tap targets in the right-rail action column
Live at tiktok.com
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
tiktok.comExplore TikTok
Pick what you want to see — mockups, colors, typography, layout, or the full component list.
Brand & Accent
Sparing, CTA-only voltage.
Surface
Page and card backgrounds.
Text
Headlines, body, captions, muted.
Borders & Hairlines
Dividers, outlines, structural rules.
TikTok design system FAQ
Common questions about TikTok'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.
TikTok — official site
TikTok's public marketing site — 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.