# Design Spec

> The exact details a builder needs to make a design. Sizes, colors, fonts and how it acts.

**Field:** Design  
**Category:** Product Development  
**Also known as:** Design Specification, Redlines, Spec Sheet (Design)

## Think of it like

It is like a recipe card next to the photo of the cake. The photo shows it, the card says how.

## Definition

A design spec is the set of details a builder needs to make a design exactly. It lists sizes, spacing, colors, fonts and how each part behaves. It also covers states like empty, loading and error. Older specs were drawn as red lines over a screen, which is why they are called redlines. Today many tools show the numbers when a developer clicks on a part.

## Example

Lucy's spec shows the button is 48 pixels tall with 16 pixels of padding. It also shows the error state the mockup left out.

## Why it matters

Builders should not have to guess. A clear spec means the shipped product matches the design.

## Common mistake

Speccing only the happy path. Empty, loading and error states are where builders guess most.

## Three principles

- **Exact numbers.** Size, space, color, type.
- **Every state.** Empty, loading, error.
- **Behavior too.** What happens on tap.

## Related terms

- [Design Handoff](https://learn.benibix.com/term/design/design-handoff)
- [Design Annotation](https://learn.benibix.com/term/design/design-annotation)
- [Design Sign-Off](https://learn.benibix.com/term/design/design-sign-off)
- [Design Token](https://learn.benibix.com/term/design/design-token)
- [Design QA](https://learn.benibix.com/term/design/design-qa)
- [Design Rationale](https://learn.benibix.com/term/design/design-rationale)

## Told apart from

- [Design Spec vs Design Rationale](https://learn.benibix.com/compare/design-spec-vs-design-rationale): People think the spec says why a screen looks the way it does, and it does not. A spec says what to build: sizes, states and behavior. The rationale says why each choice won and what was tried instead. Keep both, so nobody undoes a good choice later.

![A row of steps from left to right: design, review, sign-off, spec, build. A dashed arrow from review loops back to design. The spec box holds a small screen with sizes marked in red lines.](https://learn.benibix.com/diagrams/design-review-flow.svg)

---

Source: https://learn.benibix.com/term/design/design-spec
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
