# Heroicons design system

> Heroicons design system measured from heroicons.com: Inter var font, #A78BFA primary on #FFFFFF, 10 color hex codes, type scale, spacing and a free DESIGN.md.

Canonical page: https://sitepeel.dev/design-md/heroicons.com/

Heroicons’s website (heroicons.com) uses the Inter var font and #A78BFA as its main color on a white background. Measured by Sitepeel on November 4, 2026.

## What font does Heroicons use?

Heroicons uses Inter var (weights 400, 600 and 800) on heroicons.com. Page titles are 36px at weight 800 (28px on phones) and body text is 13px. Measured on November 4, 2026.

- Inter var (weights 400, 600, 800)

## Heroicons colors: palette and hex codes

Heroicons’s main colors are #FFFFFF (white) for the background, #0F172A (deep blue) for text and #A78BFA (light violet) as the main accent, with #8B5CF6 (violet) as another accent. Measured on November 4, 2026.

- #FFFFFF: white
- #0F172A: deep blue
- #64748B: blue
- #F8FAFC: snow
- #F1F5F9: cool snow
- #A78BFA: light violet
- #000000: near black
- #8B5CF6: violet

## What is Heroicons built with?

Heroicons’s website (heroicons.com) is built with Next.js, React, Headless UI, Tailwind CSS and Cloudflare. Measured on November 4, 2026.

- JavaScript framework: Next.js 12.2.5, React 18.2.0
- Hosting & CDN: Cloudflare, Vercel
- Analytics: Cloudflare Web Analytics
- UI & CSS: Headless UI, Tailwind CSS 3.x

## Questions and answers

### What font does Heroicons use?

Heroicons’s website uses Inter var (weights 400, 600 and 800). Page titles are 36px at weight 800 (28px on phones) and body text is 13px. Measured on November 4, 2026.

### What are the Heroicons colors and hex codes?

On heroicons.com: #FFFFFF (white) for the background, #0F172A (deep blue) for text and #A78BFA (light violet) as the main accent, with #8B5CF6 (violet) as another accent. The color palette above lists all 10 colors with their hex codes and where each one is used.

### What is the Heroicons design system?

The design system on this page is heroicons.com’s, as measured on November 4, 2026: Inter var type, #A78BFA as the main color and 12px corners, written down as a DESIGN.md. It is not Heroicons’s own documentation.

### What is Heroicons built with?

Heroicons’s website (heroicons.com) is built with Next.js, React, Headless UI, Tailwind CSS and Cloudflare. The full tech stack Sitepeel found: Next.js, React, Cloudflare, Vercel, Cloudflare Web Analytics, Headless UI and Tailwind CSS. Measured on November 4, 2026.

### What is the Heroicons DESIGN.md?

A plain-text file with Heroicons’s measured colors, type, spacing, corners and components as tokens, plus short rules, in the DESIGN.md format Google published with Stitch. Your AI coding agent reads it and builds in this style. More about DESIGN.md.

### How do I use it with Claude Code or Cursor?

Download the file and put it in your project’s root folder, then ask your agent to follow DESIGN.md. Step-by-step guides: Claude Code, Cursor, Codex, GitHub Copilot.

### Is this Heroicons’s official design system?

No. Sitepeel measured it from heroicons.com’s public page on November 4, 2026. It is an independent analysis, not made or approved by Heroicons.

### Can I use Heroicons’s style in my own product?

Use it to learn, prototype and compare. For a real product, make the style your own, and never copy Heroicons’s logo, name, pictures or text.

### How accurate are the values?

Each value was measured on the rendered page after it fully loaded, on desktop and mobile: colors where they appear, type with tracking, spacing, corners, shadows and hover states. Sites change, so check the date at the top.

## Files

- [DESIGN.md](https://sitepeel.dev/design-md/heroicons.com/DESIGN.md): the plain file to put in your project.
- [All brand DESIGN.md files](https://sitepeel.dev/design-md/examples/index.md)

Independent analysis by Sitepeel (sitepeel.dev), not affiliated with Heroicons.

## The DESIGN.md file

```markdown
---
version: alpha
name: Heroicons
description: "Light interface measured from heroicons.com: Inter var type, light violet accents, tonal surfaces and 12px corners."
colors:
  background: "#FFFFFF"
  surface: "#FFFFFF"
  on-surface: "#0F172A"
  on-background: "#0F172A"
  on-surface-variant: "#64748B"
  surface-container-low: "#F8FAFC"
  surface-container: "#F1F5F9"
  outline: "#3341551A"
  outline-variant: "#94A3B833"
  primary: "#A78BFA"
  on-primary: "#000000"
  secondary: "#8B5CF6"
typography:
  headline-display:
    fontFamily: Inter var
    fontSize: 36px
    fontWeight: 800
    lineHeight: 1.11
    letterSpacing: -0.025em
  body-md:
    fontFamily: Inter var
    fontSize: 13px
    fontWeight: 400
    lineHeight: 1.85
  label-md:
    fontFamily: Inter var
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
  label-sm:
    fontFamily: Inter var
    fontSize: 13px
    fontWeight: 600
    lineHeight: 1.85
  headline-display-mobile:
    fontFamily: Inter var
    fontSize: 28px
    fontWeight: 800
    lineHeight: 1.29
    letterSpacing: -0.025em
rounded:
  sm: 8px
  md: 12px
  full: 9999px
spacing:
  xs: 4px
  sm: 6px
  md: 12px
  lg: 24px
  xl: 40px
  gutter: 12px
  section: 80px
components:
  button-outline:
    backgroundColor: "{colors.surface-container}"
    textColor: "{colors.on-surface}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    padding: 0px
    height: 36px
  button-ghost:
    backgroundColor: "{colors.surface-container}"
    textColor: "{colors.on-surface-variant}"
    rounded: "{rounded.full}"
    padding: 6px 12px 6px 10px
    height: 30px
  input-field:
    textColor: "{colors.on-surface}"
    typography: "{typography.body-md}"
    rounded: "{rounded.sm}"
    padding: 24px 16px 24px 36px
  link:
    textColor: "{colors.on-surface}"
---

# Heroicons Design System

## Overview

Heroicons describes itself as: “Beautiful hand-crafted SVG icons, by the makers of Tailwind CSS.” The interface is light, built on **White (#FFFFFF)** with **Deep Blue (#0F172A)** text, and **Light Violet (#A78BFA)** as the main accent.

Type is set in **Inter var**. Headlines run large with tight negative tracking; body text is 13px. Depth comes from hairline borders and inset highlights rather than drop shadows. Corners are mostly 12px.

Measured from [heroicons.com](https://heroicons.com/) on November 4, 2026 at 1440×900 and 390×844 from 313 rendered elements. Values are computed styles from the live page, not the original source files.

## Colors

The palette has 10 roles.

- **White (#FFFFFF):** Page background, seen 1 time. Token `background`, CSS `--tw-ring-offset-color`.
- **Deep Blue (#0F172A):** Primary text and headings, seen 8 times. Token `on-surface`.
- **Blue (#64748B):** Secondary text, seen 8 times. Token `on-surface-variant`.
- **Snow (#F8FAFC):** Raised areas one step from the page, seen 1 time. Token `surface-container-low`.
- **Cool Snow (#F1F5F9):** Cards and panels, seen 1 time. Token `surface-container`.
- **Dark Blue 10% (#3341551A):** Borders and dividers, seen 1 time. Token `outline`.
- **Blue 20% (#94A3B833):** Secondary dividers, seen 1 time. Token `outline-variant`.
- **Light Violet (#A78BFA):** Brand color in the header, seen 1 time. Token `primary`.
- **Near Black (#000000):** Text and icons on primary. Token `on-primary`.
- **Violet (#8B5CF6):** Accent in the logo, seen 2 times. Token `secondary`.

## Typography

**Inter var** carries the whole interface. Fallback stack: `Inter var, ui-sans-serif, system-ui, sans-serif`.

- **headline-display:** Inter var 36px at weight 800, line height 1.11, tracking -0.025em (28px on mobile). Page title (h1).
- **body-md:** Inter var 13px at weight 400, line height 1.85. Body text.
- **label-md:** Inter var 16px at weight 400, line height 1.5. Buttons, navigation and labels.
- **label-sm:** Inter var 13px at weight 600, line height 1.85. Small labels and badges.

## Layout

Spacing does not follow a strict grid: 69% of measured values are multiples of 4px, so match the measured steps rather than rounding to a grid.

- **Scale:** xs 4px, sm 6px, md 12px, lg 24px, xl 40px.
- **Sections:** 80px vertical padding between major sections.
- **Gaps:** 12px is the most common gap in flex and grid layouts.
- **Breakpoints:** 480px, 640px, 768px, 1024px.

## Elevation & Depth

The design avoids drop shadows. Layers are separated by tonal surface steps (#F8FAFC → #F1F5F9) and hairline rings:

- `rgb(255, 255, 255) 0px 0px 0px 0px inset, rgba(15, 23, 42, 0.08) 0px 0px 0px 1px inset, rgba(0, 0, 0, 0) 0px 0px 0px 0px`

## Shapes

Most elements use 12px corners. Measured radii, most used first:

- **md (12px):** 368 elements.
- **sm (8px):** 16 elements.
- **full (9999px):** 4 elements.

## Components

Measured from the rendered page. Token values reference the tokens above.

- **button-outline (“Outline”):** #F1F5F9 fill, #0F172A text, 16px/400, 9999px radius, padding 0px.
- **button-ghost (“v2.1.5”):** #F1F5F9 fill, #64748B text, 12px/600, 9999px radius, padding 6px 12px 6px 10px, border 1px solid #3341551A.
- **input-field (“Search all icons...”):** transparent fill, #0F172A text, 13px/400, 8px radius, padding 24px 16px 24px 36px.
- **link:** transparent fill, #0F172A text, padding 0px.

## Do's and Don'ts

- Do use #FFFFFF for the page and lift surfaces in small steps: #F8FAFC, #F1F5F9.
- Do keep text in 2 levels: #0F172A, #64748B.
- Do use #A78BFA as the brand accent: header, logo and key highlights.
- Do set headlines in Inter var with tight tracking (-0.025em).
- Do reuse the measured spacing steps (6px, 12px, 24px).
- Do use 12px corners on most elements; larger surfaces also use 8px.
- Don't add drop shadows for depth; use hairline rings and tonal surfaces.
- Don't introduce new font families beyond Inter var.
- Don't use #A78BFA for large backgrounds or body text.
- Don't make interface transitions slower than 0.5s.

## Motion

Interface transitions are quick: 0.5s, 0.15s, 0.2s.

- **Easing:** `cubic-bezier(0.4, 0, 0.2, 1)`.

Generated by [Sitepeel](https://sitepeel.dev/design-md/heroicons.com/), the free DESIGN.md generator (engine 2026.10.29+b828a475ee10).

```