Biome Design System
Biome's design system as a DESIGN.md file — cobalt #0065da brand voltage, system-ui at 64px display, One Dark code panels, light-document surface.
About Biome DESIGN.md
Curated by Dov AzencotUpdated Source biomejs.dev
- Developer Tools & IDEs
- Backend, Database & DevOps
Biome's marketing page is a documentation site doing marketing work — the same Starlight/Astro framework that powers the reference docs also carries the landing page, so the hero shares its structural chrome (top-nav height, sidebar width, hairline border palette) with the API reference a click away. The above-fold experience is a light white surface with a 64px system-ui headline "One toolchain for your web project" at weight 600 in near-black (#17181c), a cobalt-blue "Get started" CTA pill at the left, and the Biome wordmark + geometric logo on the right. Below the fold the page shifts into a wide dark-background code-comparison panel that demonstrates the formatter working on real JavaScript — this is where the One Dark Pro color palette enters: tomato red (#ff6347) for deleted tokens, medium green (#3cb371) for added tokens, steel blue (#3b61b0) for keywords, purple (#8844ae) for function names. Not brand colors — borrowed syntax colors.
The DESIGN.md file packages this into machine-readable tokens. Inside: 17 color tokens including the cobalt brand voltage (#0065da) and a One Dark subset (tomato, green, blue, purple, muted red) plus the Starlight gray scale; 12 typography tokens using system-ui for all prose and the system mono stack for code; 8 radius values with an 800px pill as the dominant CTA shape (32 occurrences) and 12px as the card default; 9 spacing values; and 15 components covering the pill CTA button, the dark code-diff panel, the feature comparison grid, the syntax-highlight inline code chip, and the light document card.
Feed this file to Claude or Cursor and it reproduces Biome's specific moves: white light-document canvas with a single cobalt accent, pill-shaped primary CTAs, One Dark syntax colors for code demonstration panels, and a Starlight-inherited hairline and gray system for all structural chrome. The most transferable pattern for any developer toolchain landing page: place a live code formatter diff directly below the fold, using real before/after code rather than illustrative screenshots. Biome's diff panel is the strongest product argument on the page.
What makes it distinct
- Cobalt-as-the-only-color#0065da appears 75 times as the single chromatic accent on an otherwise monochrome white-and-near-black doc surface
- One Dark code panelsthe full formatter diff section uses One Dark Pro's palette: tomato red, medium green, steel blue, purple — borrowed entirely from VS Code's most popular dark theme
- 64px system-ui at weight 600the hero headline uses no custom typeface and outweighs every other typography-brand decision in this directory at the same size
- Pill-dominant radius32 occurrences of 800px radius (effectively full-pill) for the hero CTA buttons, against a 12px default for cards
- Starlight documentation aestheticthe page is a Starlight/Astro docs site repurposed as a marketing surface; the sidebar nav chrome, badge system, and color variables all belong to the Starlight design system
Live at biomejs.dev
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
biomejs.devExplore Biome
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.
Other
Specialty colors.
Biome design system FAQ
Common questions about Biome'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.
Biome — official site
Biome'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.