Make your AI a shadcn expert

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

  1. Cobalt-as-the-only-color#0065da appears 75 times as the single chromatic accent on an otherwise monochrome white-and-near-black doc surface
  2. 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
  3. 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
  4. Pill-dominant radius32 occurrences of 800px radius (effectively full-pill) for the hero CTA buttons, against a 12px default for cards
  5. 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.

Screenshot of Biome's website at biomejs.devbiomejs.dev

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

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

Use Biome in your project

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

Download DESIGN.md