Make your AI a shadcn expert

GitLab Design System

GitLab's design system as a DESIGN.md file.

About GitLab DESIGN.md

Curated by Dov AzencotUpdated Source about.gitlab.com

  • Developer Tools & IDEs

GitLab's marketing canvas is the courthouse register of DevSecOps — a pure "#ffffff" page floor with near-black "#171321" ink and a structural purple "#7759c2" that runs every hairline border, link rest, and divider rule. Where most developer platforms reach for a saturated brand voltage on the primary CTA, GitLab paints "Get free trial" in white text on the same "#171321" ink that holds the headline, giving the page zero chromatic action surfaces. The single warm atmospheric is a sunrise gradient — "#ffc2a0" through "#ff9a55", "#ff7a2f", and "#c65a2e" — scoped exclusively to the hero orb illustration. Outside that one band the page is monochrome ink-on-paper with purple structural rules, a register closer to a financial-services prospectus than a typical SaaS landing page.

This page packages the surface into one DESIGN.md file written to the Google Labs spec. Inside: 18 color tokens grouped into canvas, ink, purple structural, the sunrise-gradient stops, plus support tokens for the dark-card surface ("#1f1c2e") and pale lavender wash ("#f6f3fe"); 11 typography tiers covering GitLab Sans from "96px" hero weight 660 with "-2.88px" tracking down to "14px" body weight 400; a five-step radius scale running 4 / 16 / 28 / "999px" pill / 50% circle; an eight-step spacing scale anchored at the 8px base unit (73 occurrences) and topping out at "96px" for section padding; and 17 component definitions covering the top nav, primary and secondary CTAs, feature cards, the dark code surface, customer logo strip, industry chip, and the email-capture text input.

Feed the file to Claude, Cursor, or Copilot and the agent reproduces GitLab's procurement-formal restraint — achromatic CTA, purple-as-hairline, weight-660 display, two-tier radius dialect, single warm atmospheric — rather than a generic SaaS landing with a tangerine fill button and lavender gradient backgrounds. Or reference the tokens directly: every hex, font name, radius, and spacing value is a quoted scalar you can paste into Tailwind config, CSS variables, or a shadcn theme registry. GitLab is worth studying because it threads a narrow needle. The page reads as enterprise-serious without going corporate-gray, with a chromatic budget of one purple structural rule and one warm hero gradient. Nothing else on the surface carries color.

What makes it distinct

  1. Achromatic CTA strategyprimary button paints #171321 on #ffffff at 47px height and 4px radius; the page ships zero chromatic action buttons
  2. Purple as hairline voltage#7759c2 holds 98 occurrences split evenly across text (49) and border (49), never as a fill
  3. Single warm atmosphericthe orange-to-coral gradient (#ffc2a0 → #ff9a55 → #ff7a2f → #c65a2e) lives only inside the hero orb illustration
  4. Weight 660 as display signatureGitLab Sans hits a custom variable cut at 660 across hero, h2, and h3, not the standard 700 semibold
  5. Two-tier radius dialect4px for buttons and chips (25 occurrences), 16px for feature-cards (20 occurrences)

Live at about.gitlab.com

A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.

Screenshot of GitLab's website at about.gitlab.comabout.gitlab.com

Explore GitLab

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.

Other

Specialty colors.

GitLab design system FAQ

Common questions about GitLab'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 GitLab in your project

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

Download DESIGN.md