---
version: 1.0
name: Bluestone
description: Serious work, warmly made — a design system of earthy blues on paper, warmed by clay.
colors:
  primary: "#2C5272"
  primary-hover: "#23435E"
  secondary: "#5E86A3"
  secondary-ink: "#3E6480"
  deep: "#1B2A39"
  neutral-fg: "#33302C"
  neutral-fg-secondary: "#5C554D"
  neutral-fg-faint: "#6B6359"
  surface: "#FCFAF6"
  surface-page: "#F5F0E6"
  surface-raised: "#ECE4D4"
  surface-tint: "#E8EDF0"
  surface-invert: "{colors.deep}"
  border: "#DCD1BD"
  border-strong: "#C2B49C"
  border-brand: "{colors.secondary}"
  link: "{colors.primary}"
  link-hover: "{colors.primary-hover}"
  focus: "{colors.secondary}"
  clay: "#9A5A40"
  walnut: "#6B4E3A"
  sand: "#CDB896"
  signal-error: "#A8352A"
  signal-caution: "#A15C06"
  signal-warning: "#7F6311"
  signal-success: "#4A7041"
colors-dark:
  primary: "#8FB0CC"
  primary-hover: "#A9C3DA"
  link: "#9DBAD3"
  secondary: "#6F94B0"
  deep: "#151C24"
  neutral-fg: "#EFE9DE"
  neutral-fg-secondary: "#CFC6B8"
  neutral-fg-faint: "#A69D90"
  surface: "#262421"
  surface-page: "#1E1C1A"
  surface-raised: "#312E2A"
  surface-tint: "#273039"
  border: "#3A3632"
  border-strong: "#4D4741"
  clay: "#D39A7F"
  signal-error: "#E58A7C"
  signal-caution: "#DD9A5E"
  signal-warning: "#D4B464"
  signal-success: "#9CBB8C"
typography:
  display:
    fontFamily: Figtree
    fontSize: 3.5rem
    fontWeight: 800
    lineHeight: 1.05
    letterSpacing: -0.02em
  h1:
    fontFamily: Figtree
    fontSize: 2.75rem
    fontWeight: 700
    lineHeight: 1.12
    letterSpacing: -0.015em
  h2:
    fontFamily: Source Serif 4
    fontSize: 2.25rem
    fontWeight: 400
    lineHeight: 1.2
    letterSpacing: -0.005em
  h3:
    fontFamily: Figtree
    fontSize: 1.5rem
    fontWeight: 700
    lineHeight: 1.3
  h4:
    fontFamily: Figtree
    fontSize: 1.25rem
    fontWeight: 600
    lineHeight: 1.4
  h5:
    fontFamily: Source Serif 4
    fontSize: 1.125rem
    fontWeight: 600
    fontStyle: italic
    lineHeight: 1.4
  body-md:
    fontFamily: Figtree
    fontSize: 1.0625rem
    fontWeight: 400
    lineHeight: 1.6
  body-sm:
    fontFamily: Figtree
    fontSize: 0.9375rem
    fontWeight: 400
    lineHeight: 1.55
  body-long:
    fontFamily: Source Serif 4
    fontSize: 1.1875rem
    fontWeight: 400
    lineHeight: 1.65
  quote:
    fontFamily: Source Serif 4
    fontSize: 1.75rem
    fontWeight: 400
    fontStyle: italic
    lineHeight: 1.35
  label-button:
    fontFamily: Figtree
    fontSize: 0.9375rem
    fontWeight: 700
    lineHeight: 1.2
    letterSpacing: 0.01em
  label-nav:
    fontFamily: Figtree
    fontSize: 0.9375rem
    fontWeight: 600
    lineHeight: 1
    letterSpacing: 0.01em
  label-eyebrow:
    fontFamily: Figtree
    fontSize: 0.75rem
    fontWeight: 700
    lineHeight: 1
    letterSpacing: 0.14em
  code:
    fontFamily: Source Code Pro
    fontSize: 0.875em
    fontWeight: 400
spacing:
  base: 4px
  xs: 0.5rem
  sm: 1rem
  md: 1.5rem
  lg: 3rem
  xl: 6rem
  gutter-mobile: 1.25rem
  gutter-desktop: 4rem
  grid-gap: 2rem
  section-rhythm: 6rem
  container-text: 42rem
  container-wide: 72rem
rounded:
  none: 0px
  xs: 2px
  sm: 4px
  md: 8px
  full: 9999px
shadows:
  overlay: "0 8px 24px rgba(30, 28, 26, 0.12)"
components:
  button-primary:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.surface}"
    hoverBackgroundColor: "{colors.primary-hover}"
    typography: "{typography.label-button}"
    rounded: "{rounded.xs}"
    padding: 0.875rem 1.5rem
  button-secondary:
    backgroundColor: transparent
    borderColor: "{colors.primary}"
    textColor: "{colors.primary}"
    hoverBackgroundColor: "{colors.surface-tint}"
    typography: "{typography.label-button}"
    rounded: "{rounded.xs}"
    padding: 0.875rem 1.5rem
  card:
    backgroundColor: "{colors.surface}"
    borderColor: "{colors.border}"
    textColor: "{colors.neutral-fg}"
    rounded: "{rounded.md}"
    padding: 1.75rem
  panel:
    backgroundColor: "{colors.surface-raised}"
    textColor: "{colors.neutral-fg-secondary}"
    rounded: "{rounded.md}"
    padding: 1.5rem
  portrait:
    backgroundColor: "{colors.surface-raised}"
    borderColor: "{colors.sand}"
    rounded: "{rounded.md}"
    size: 176px
  input:
    backgroundColor: "{colors.surface}"
    borderColor: "{colors.border-strong}"
    focusBorderColor: "{colors.primary}"
    focusRing: "0 0 0 3px {colors.surface-tint}"
    textColor: "{colors.neutral-fg}"
    rounded: "{rounded.xs}"
    padding: 0.75rem 1rem
  input-label:
    textColor: "{colors.neutral-fg-secondary}"
    typography: "{typography.label-button}"
  checkbox:
    rounded: "{rounded.xs}"
    size: 1.125rem
    checkedColor: "{colors.primary}"
  divider:
    backgroundColor: "{colors.border}"
    height: 1px
  keystone:
    backgroundColor: "{colors.clay}"
    width: 2.5rem
    height: 3px
  header:
    backgroundColor: "{colors.surface}"
    borderBottom: "1px solid {colors.border}"
    textColor: "{colors.deep}"
    height: 72px
  footer:
    backgroundColor: "{colors.deep}"
    textColor: "{colors.surface-page}"
  callout-clay:
    backgroundColor: "{colors.clay}"
    textColor: "{colors.surface}"
    rounded: "{rounded.md}"
    padding: 1.5rem
  callout-paper:
    backgroundColor: "{colors.surface-raised}"
    borderLeft: "3px solid {colors.clay}"
    textColor: "{colors.neutral-fg}"
    rounded: "{rounded.sm}"
    padding: 1.5rem
  notice:
    rounded: "{rounded.sm}"
    padding: 1rem 1.25rem
    variants: [error, caution, warning, success, info]
---

# Bluestone Design System

> Serious work, warmly made.

## Overview

Bluestone is a design system for professional websites that want to be trusted
without feeling cold: consultancies, studios, research groups, civic and
nonprofit work, independent practices. It is named for the blue-grey sandstone
laid as sidewalk and stoop across the old Northeast — stone that has spent a
century beside brick, terracotta, and painted wood, and looks better for the
company. The whole system makes the same argument: **blue does not have to be
cold if everything around it is warm.**

**Personality.** Steady, plainspoken, quietly warm. Expert without being aloof.
First-person plural (we / our / us) for an organization, first-person singular
for a practice of one. Headings are sentence case. Never emoji. Humor is
allowed, but it is dry and it is rare.

**Density.** Comfortable. Gutters scale from `1.25rem` on mobile to `4rem` on
desktop, sections breathe at roughly `6rem`, and prose is held to a `42rem`
measure. Nothing on the page should feel like it is competing for the reader.

**Mood.** Confident, unhurried, tactile. Paper surfaces, hairline rules, flat
color blocks. Motion is restrained to fades and short reveals; no page relies on
an animation to make its point.

## Colors

Two blues carry the identity. Everything around them is warmed toward paper and
hearth so the blues never read as corporate.

### The blues

- **Bluestone — Primary (#2C5272):** A rich, slightly dusty blue. Primary
  buttons, links, H1 headings, active navigation, checked controls. Clears
  7.9:1 on the reading surface, so it is safe for text at any size.
- **Tidewater — Secondary (#5E86A3):** The structural blue. Card accents,
  brand borders, illustration strokes, focus rings, chart series. It clears
  3.7:1 on paper — enough for non-text UI, **not** enough for body copy. When
  Tidewater has to be text, use **Tidewater Ink (#3E6480)**.
- **Harbor — Deep (#1B2A39):** The dark complement. The footer and the single
  full-bleed deep block per page. Carries gravitas; never used for small UI.
- **Mist (#8FB0CC):** The primary once the lights go down. Dark mode only.

### Paper and hearth

- **Bond (#FCFAF6):** The reading surface — cards, inputs, the header.
- **Cream (#F5F0E6):** The page background behind everything.
- **Ledger (#ECE4D4):** Raised panels, table headers, sidebars, quiet callouts.
- **Linen (#DCD1BD):** Hairlines, dividers, card borders.
- **Graphite (#33302C):** Body text. A charcoal with woodsmoke in it, not black.
- **Flint (#5C554D):** Secondary text, captions, metadata.

There is no pure white and no neutral grey anywhere in the system. If a grey
looks blue or green next to Cream, it is the wrong grey.

### Kiln — the warmth

- **Clay (#9A5A40):** The editorial accent. Eyebrows, the keystone rule above
  H2s, pull-quote marks, the clay callout, "draft" states. Bond text on Clay
  clears 5.1:1.
- **Walnut (#6B4E3A):** Illustration, deep marks, the occasional rule on Sand.
- **Sand (#CDB896):** Decorative rules, portrait keylines, highlighter marks.

Kiln is rationed. A page that uses Clay more than three or four times has
started decorating.

### Signal — system only

Reds, oranges, yellows, and greens exist so the system can speak. They are
**never** used for branding, illustration, or emphasis.

| Role    | Name    | Light   | Dark    | Use                                   |
| ------- | ------- | ------- | ------- | ------------------------------------- |
| Error   | Scarlet | #A8352A | #E58A7C | Failed validation, destructive action |
| Caution | Ember   | #A15C06 | #DD9A5E | Pending, expiring, needs attention    |
| Warning | Ochre   | #7F6311 | #D4B464 | Notices, maintenance, soft warnings   |
| Success | Fern    | #4A7041 | #9CBB8C | Saved, sent, confirmed                |
| Info    | —       | #3E6480 | #93B4CC | Tidewater Ink — informational notes   |

Each Signal color pairs with a tint background at roughly 8–10% (see the
notice component). Clay sits beside Scarlet and Ember on the color wheel, so it
is deliberately browner and lower-chroma than either — never set an error in
Clay, and never set a draft in Scarlet.

No gradients. No purple. No neon. No pure black or white.

## Typography

Two families, each with a job.

- **Figtree** (sans) carries the interface: navigation, buttons, labels,
  H1/H3/H4, and short body copy. Warm, round, geometric, legible at small
  sizes.
- **Source Serif 4** (serif) carries the voice: H2s, pull quotes, long-form
  reading, and the italic H5. Comfortable rather than literary — it should read
  like a well-made report, not a wedding invitation.
- **Source Code Pro** for code and tabular figures where alignment matters.

The root is the browser default (`16px`); all sizes are in `rem`.

- **Display:** Figtree 800, 3.5rem, tight tracking. Heroes only.
- **H1:** Figtree 700, 2.75rem, sentence case, `colors.deep` on light surfaces.
- **H2:** Source Serif 4 **400**, 2.25rem, sentence case, `colors.neutral-fg`,
  preceded by the **keystone** — a 2.5rem × 3px Clay rule sitting 1rem above the
  heading. This is the signature pattern of the system. Keep it.
- **H3 / H4:** Figtree 700 / 600, descending sizes, sentence case.
- **H5:** Source Serif 4 600 italic — used for asides, card subtitles, and
  bylines.
- **Body:** Figtree 400 at `1.0625rem / 1.6`. Long-form pages (articles, case
  studies, essays) switch the body to Source Serif 4 at `1.1875rem / 1.65`.
- **Buttons & nav:** Figtree 700 / 600, sentence case, a touch of tracking.
- **Eyebrows:** Figtree 700, 0.75rem, UPPERCASE, `0.14em` tracking, in Clay.
  The only all-caps text in the system.

The pairing of a confident sans H1 with a quiet serif H2 is the strongest
typographic signal of the brand.

## Layout

**Fluid, composition-driven, mobile-first.** Gutters scale from `1.25rem` to
`4rem`. Prose is capped at `42rem` (roughly 68 characters); grids span up to
`72rem`. Grid gap defaults to `2rem`; vertical rhythm between sections is
`6rem` on desktop and `4rem` on mobile.

The spacing scale is **4px-rooted**. The header is 72px, sits on Bond with a
single Linen hairline beneath it, and stays put — no hide-on-scroll. The footer
is Harbor and runs the full width.

## Elevation & Depth

**Paper on paper.** Hierarchy comes from tone and hairlines, not from shadow.

- Cards are Bond on Cream with a 1px Linen border. No resting shadow.
- Panels step down to Ledger instead of up with a shadow.
- **One** shadow exists, for things that float above the page — menus, popovers,
  dialogs: `0 8px 24px rgba(30, 28, 26, 0.12)`.
- The Harbor block is a tonal shift of the page, not an elevated element.
- Never glass, never blur, never inner shadows.

## Shapes

**Firm edges for action, softer for content.**

- **Buttons: `rounded.xs` (2px).** Nearly square — decisive, not sharp.
- **Inputs and checkboxes: `rounded.xs` (2px).** They belong with the buttons.
- **Notices and paper callouts: `rounded.sm` (4px).**
- **Cards, panels, portraits: `rounded.md` (8px).**
- **`rounded.full`** is reserved for avatars under 40px and status dots.

No pills, no capsules. Portraits are rounded rectangles, not circles.

## Components

**Buttons.** Two variants. Primary is a Bluestone fill with Bond text.
Secondary is an outline: 1px Bluestone border, Bluestone text, transparent
fill. **Hover deepens the color** (Primary → `primary-hover`; Secondary gains a
`surface-tint` wash). Pressed nudges down 1px. Focus is a 2px Tidewater ring
offset 2px from the edge. A third, text-only button (Bluestone, underlined on
hover) is allowed for tertiary actions.

**Cards.** Bond fill, 1px Linen border, 8px radius, 1.75rem padding, no shadow.
A card may carry a 3px Tidewater rule along its top edge to mark it as
featured — once per group, at most.

**Inputs.** Bond background, 1px `border-strong` border, 2px radius. On focus
the border becomes Bluestone and a soft 3px `surface-tint` ring appears. Errors
switch the border and helper text to Scarlet; never color the field fill.

**Checkboxes.** 18px, 2px radius, `border-strong` outline; Bluestone fill with
a Bond check when selected.

**Lists.** Plain bullets in prose. Feature and value lists drop bullets in favor
of a small Tidewater square marker and an H4-weight first phrase.

**Keystone.** The 2.5rem × 3px Clay rule above every H2. On the Harbor block it
turns Sand.

**Header.** 72px, Bond background, Linen hairline below, Harbor wordmark left,
Graphite nav right (600, sentence case). The active item is Bluestone with a
2px underline in Tidewater.

**Footer.** Harbor background, Cream text, Mist links. Opens with a single CTA
row — serif H2 with a Sand keystone, one primary button reversed to Bond fill
and Harbor text.

**Callouts.** *Clay callout:* Clay fill, Bond text — one per page, for the thing
the reader must not miss. *Paper callout:* Ledger fill with a 3px Clay left
rule — for asides and editor's notes.

**Notices.** Signal tint background, 1px border in the Signal color at 30%
opacity, Signal ink for the title, Graphite for the body, a Lucide glyph at
stroke 1.5. Five variants: error, caution, warning, success, info.

**Iconography.** Lucide outlines at stroke 1.5, in Bluestone on light and Mist
on dark. Icons accompany words; they do not replace them.

## Dark mode

Dark mode is part of the system, not an afterthought, and it is written by hand
rather than inverted.

- The page goes to **Soot (#1E1C1A)** and surfaces to warm charcoal — the hearth
  stays warm. Never a blue-black page.
- The deep block drops *below* the page to a blue-black (`#151C24`), so the
  Harbor role survives: it is still the most dramatic surface on screen.
- Bluestone gives way to **Mist** for actions and links; Tidewater lifts to
  `#6F94B0` for rules and focus.
- Text is Cream-tinted, not white. Signal and Clay inks lift; their fills stay
  mid-tone so they read as color, not as glow.

## Accessibility

Every text pair in the system clears WCAG AA (4.5:1) in both schemes, including
each Signal ink on its own tint. The one deliberate exception is Tidewater
(#5E86A3) on light surfaces at 3.7:1, which is why it is restricted to non-text
UI and has its own text-safe variant.

## Do's and Don'ts

- **Do** put the keystone above every H2.
- **Do** pair a sans H1 with a serif H2 — that contrast is the brand.
- **Do** keep one full-bleed Harbor block per page, maximum (the footer does not
  count).
- **Do** use Tidewater for structure and Bluestone for action.
- **Do** keep Signal colors for the system. Errors, warnings, confirmations.
- **Do** flag any color outside the documented palette.
- **Don't** use pure white, pure black, or a neutral grey.
- **Don't** add gradients, glass, or blur.
- **Don't** use Clay, Walnut, or Sand for interface chrome — they are editorial.
- **Don't** set body copy in Tidewater on light surfaces.
- **Don't** use pills or capsules. Buttons are near-square; portraits are
  rounded rectangles.
- **Don't** introduce a third brand blue. Bluestone and Tidewater are the
  identity; Harbor and Mist are their depths.
- **Don't** set anything in ALL CAPS except eyebrows.
- **Don't** use emoji.

---

## Notes on the schema

The frontmatter uses curly-brace token references (`"{colors.primary}"`), a
lightweight interpolation convention rather than standard YAML. `colors-dark`
lists only the tokens that change in dark mode; anything not listed inherits
from `colors`. To consume these downstream, run them through a resolver or
project them into Style Dictionary, Tokens Studio, or the W3C Design Tokens
format. Treat this file as the source of truth.

Figtree, Source Serif 4, and Source Code Pro are all available under the SIL
Open Font License. Self-host them in production.
