About Temporal DESIGN.md
Curated by Dov AzencotUpdated Source temporal.io
- Backend, Database & DevOps
- Developer Tools & IDEs
Temporal's marketing page holds one temperature across the entire scroll: near-true-black. The canvas is #141414, not the slightly-blue charcoal that Linear and Vercel use, not the navy that Storybook deploys — true near-black with near-white text on every surface. The hero headline "What if your code never failed?" sits at 68px in Aeonik weight 300, a light-weight display choice that goes against every enterprise infrastructure convention. No CTA uses the brand's purple-indigo gradient as a fill; the gradient runs only through the hero background band and inside product-feature illustrations. The primary CTA is a pill shape with no gradient, no color — just a white pill on the near-black canvas.
The DESIGN.md file packages the system into a machine-readable spec for React and AI tools. Inside: 16 color tokens organized around a true-black canvas, a slate-blue-gray hairline dominant at 467 occurrences, two brand gradient hues (violet #b664ff and indigo #444ce7), and a neon-yellow accent (#dbff4b) that appears in exactly five places as a status signal and text highlight. Twelve typography tokens run Aeonik at weight 300 across every tier — display to caption — with Noto Sans Mono as the system's second voice for CTAs, code panels, and interactive labels. The radius system has exactly one value: 9999px pill, used once on the primary CTA. Everything else is square.
Feed this file to Claude or Cursor and it reproduces Temporal's disciplined moves: near-black canvas, light-weight display that signals confidence through restraint rather than mass, monospace buttons that read as infrastructure rather than marketing, and a gradient that stays inside illustrations rather than decorating the chrome. The key learning from this system is that a gradient does not have to touch the CTA to register as the brand's chromatic signal — Temporal proves a gradient can live in the background and still define the visual identity.
What makes it distinct
- Weight-300 across all tiersAeonik renders every tier from 68px hero to 12px caption at light weight, the most extreme typographic restraint in the enterprise dev-tools category
- Mono buttonsNoto Sans Mono carries CTA labels, not a sans; the monospace voice signals infrastructure authenticity over marketing warmth
- Zero corner roundingthe entire marketing surface has no rounded cards, no rounded inputs, no rounded sections; the only radius is 9999px on the single pill CTA
- Purple-indigo gradient as the brand's only chromatic moment#b664ff to #444ce7 appears in the hero gradient band and feature illustrations but never as a flat color fill on any CTA or card
- Near-true-black canvas#141414 rather than the tinted dark blues that Linear and Vercel use; text reads as near-white #f8fafc across the full page
Live at temporal.io
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
temporal.ioExplore Temporal
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.
Semantic
Status, errors, success, inline links.
Other
Specialty colors.
Temporal design system FAQ
Common questions about Temporal'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.
Temporal — official site
Temporal'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.