# Seed — Design System
> A premium, scientifically-backed microbial health brand focusing on gut health and systemic therapeutics.
- **Canonical:** https://uiuxskills.com/library/seed
- **Source:** https://seed.com/
- **Category:** E-commerce & Retail
- **Compatible tools:** claude, cursor, lovable, figma-make
- **Coverage:** 80%
- **License:** MIT
- **Last updated:** 2026-10-22T23:30:30.207Z

---

---
version: alpha
name: Seed
tagline: Whole Body Health Starts in the Gut
description: >-
  A premium, scientifically-backed microbial health brand focusing on gut health and systemic
  therapeutics.
tone: Scientific, authoritative, premium, and clean.
color-scheme: light
colors:
  primary: "#1C3A13"
  secondary: "#3D5B34"
  accent: "#D2F195"
  background: "#FCFCF7"
  surface: "#FCFCF7"
  surface-dim: "#F2F2EB"
  surface-bright: "#FFFFFF"
  on-primary: "#FCFCF7"
  on-surface: "#1C3A13"
  outline: "#D0D0C5"
  error: "#D50032"
typography:
  display-lg:
    fontFamily: Seed Sans
    fontSize: 3rem
    fontWeight: 400
    lineHeight: "1.1"
    letterSpacing: "-0.02em"
  display-md:
    fontFamily: Seed Sans
    fontSize: 2.25rem
    fontWeight: 400
    lineHeight: "1.2"
    letterSpacing: "-0.01em"
  headline-lg:
    fontFamily: Seed Sans
    fontSize: 1.875rem
    fontWeight: 400
    lineHeight: "1.25"
    letterSpacing: 0em
  headline-md:
    fontFamily: Seed Sans
    fontSize: 1.5rem
    fontWeight: 400
    lineHeight: "1.3"
    letterSpacing: 0em
  headline-sm:
    fontFamily: Seed Sans
    fontSize: 1.25rem
    fontWeight: 500
    lineHeight: "1.4"
    letterSpacing: 0em
  body-md:
    fontFamily: Seed Sans
    fontSize: 1rem
    fontWeight: 400
    lineHeight: "1.5"
    letterSpacing: 0em
  body-sm:
    fontFamily: Seed Sans
    fontSize: 0.875rem
    fontWeight: 400
    lineHeight: "1.5"
    letterSpacing: 0em
  label-md:
    fontFamily: Seed Sans
    fontSize: 0.875rem
    fontWeight: 500
    lineHeight: "1"
    letterSpacing: 0.05em
  label-sm:
    fontFamily: Seed Sans
    fontSize: 0.75rem
    fontWeight: 500
    lineHeight: "1"
    letterSpacing: 0.08em
rounded:
  sm: 4px
  md: 8px
  lg: 16px
  xl: 24px
  full: 9999px
spacing:
  xs: 4px
  sm: 8px
  md: 16px
  lg: 24px
  xl: 32px
  2xl: 48px
components:
  button-primary:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    padding: 12px 24px
  button-primary-hover:
    backgroundColor: "{colors.secondary}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    padding: 12px 24px
  button-secondary:
    backgroundColor: transparent
    textColor: "{colors.primary}"
    typography: "{typography.label-md}"
    rounded: "{rounded.full}"
    padding: 12px 24px
    borderColor: "{colors.primary}"
  card:
    backgroundColor: "{colors.surface-dim}"
    textColor: "{colors.on-surface}"
    rounded: "{rounded.md}"
    padding: 24px
  card-elevated:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.on-surface}"
    rounded: "{rounded.md}"
    padding: 24px
  card-bright:
    backgroundColor: "{colors.surface-bright}"
    textColor: "{colors.on-surface}"
    rounded: "{rounded.md}"
    padding: 24px
  input-field:
    backgroundColor: transparent
    textColor: "{colors.on-surface}"
    typography: "{typography.body-md}"
    rounded: "{rounded.sm}"
    padding: 12px 16px
    borderColor: "{colors.outline}"
  input-field-focus:
    backgroundColor: transparent
    textColor: "{colors.on-surface}"
    typography: "{typography.body-md}"
    rounded: "{rounded.sm}"
    padding: 12px 16px
    borderColor: "{colors.primary}"
  link:
    backgroundColor: transparent
    textColor: "{colors.primary}"
    typography: "{typography.label-md}"
  link-hover:
    backgroundColor: transparent
    textColor: "{colors.secondary}"
    typography: "{typography.label-md}"
  badge:
    backgroundColor: "{colors.accent}"
    textColor: "{colors.primary}"
    typography: "{typography.label-sm}"
    rounded: "{rounded.full}"
    padding: 4px 8px
  badge-error:
    backgroundColor: "{colors.error}"
    textColor: "{colors.on-primary}"
    typography: "{typography.label-sm}"
    rounded: "{rounded.full}"
    padding: 4px 8px
  divider:
    backgroundColor: "{colors.outline}"
    height: 1px
    width: 100%
  promo-banner:
    backgroundColor: "{colors.accent}"
    textColor: "{colors.primary}"
    typography: "{typography.label-sm}"
    padding: 8px 16px
    width: 100%
  page-container:
    backgroundColor: "{colors.background}"
    textColor: "{colors.on-surface}"
motion:
  duration-short: 200ms
  duration-medium: 500ms
  duration-long: 1000ms
  easing-standard: ease
elevation:
  sm: 0 1px 2px rgba(28, 58, 19, 0.05)
  md: 0 4px 12px rgba(28, 58, 19, 0.08)
  lg: 0 12px 24px rgba(28, 58, 19, 0.12)
---

## Overview

Seed combines rigorous scientific inquiry with a high-end, editorial aesthetic. The visual identity evokes both nature and clinical precision, balancing organic life with structured, authoritative layouts. The resulting experience feels premium, clean, and deeply scientific.

## Colors

The color strategy balances biological authenticity with clinical cleanliness. A dominant deep forest green anchors the brand in nature and scientific authority, while warm off-whites provide an editorial, premium canvas. A vibrant lime green is used sparingly as an accent to draw attention to key interactive elements and promotions.

*   Primary (`{colors.primary}`): Deep forest green (#1C3A13) representing nature, biology, and the brand's core scientific identity.
*   Secondary (`{colors.secondary}`): Muted sage green (#3D5B34) used for secondary actions, hover states, and supportive brand elements.
*   Accent (`{colors.accent}`): Bright lime green (#D2F195) used for promotional banners, badges, and high-visibility callouts.
*   Background (`{colors.background}`): Warm off-white background color (#FCFCF7) that provides a clean, editorial, and premium feel.
*   Surface (inferred) (`{colors.surface}`): Standard surface color (#FCFCF7) matching the clean background for seamless card integration.
*   Surface-dim (inferred) (`{colors.surface-dim}`): Slightly darker warm cream (#F2F2EB) used for subtle container backgrounds and structural contrast.
*   Surface-bright (inferred) (`{colors.surface-bright}`): Pure white (#FFFFFF) used for high-contrast card elements and elevated surfaces.
*   On-primary (`{colors.on-primary}`): High-contrast warm off-white text (#FCFCF7) used on top of primary deep green backgrounds.
*   On-surface (`{colors.on-surface}`): Deep forest green text color (#1C3A13) used on light backgrounds for optimal readability.
*   Outline (inferred) (`{colors.outline}`): Soft warm gray (#D0D0C5) used for borders, input fields, and subtle dividers.
*   Error (inferred) (`{colors.error}`): Standard clinical red (#D50032) used for error states and validation alerts.

## Typography

The typography relies on Seed Sans to deliver a clean, authoritative, and editorial voice. The type scale balances large, high-impact display levels for bold scientific claims with highly legible body and label styles for technical information.

*   `{typography.display-lg}` (inferred): Large editorial display type in Seed Sans, used for primary hero headlines.
*   `{typography.display-md}` (inferred): Medium display type in Seed Sans, used for section headers and prominent callouts.
*   `{typography.headline-lg}` (inferred): Large headline style in Seed Sans, for major content groupings.
*   `{typography.headline-md}` (inferred): Standard headline style in Seed Sans, for product titles and feature sections.
*   `{typography.headline-sm}` (inferred): Small headline style in Seed Sans, for sub-features and card titles.
*   `{typography.body-md}`: Standard body copy size in Seed Sans, optimized for readability and editorial flow.
*   `{typography.body-sm}`: Small body copy in Seed Sans, for secondary descriptions, captions, and product details.
*   `{typography.label-md}`: Interactive label text in Seed Sans, used for buttons and navigation links.
*   `{typography.label-sm}` (inferred): Micro-labels, badges, and small uppercase metadata in Seed Sans.

## Layout

The layout relies on a spacious, editorial grid with generous margins and asymmetrical compositions.
*   **Grid & Spacing**: Built on a modular scale using spacing tokens from `{spacing.xs}` (4px) to `{spacing.2xl}` (48px), with a standard 16px gutter (`{spacing.md}`) and generous vertical margins to establish a clear vertical rhythm.
*   **Section Order**: The typical page flow follows: `promo-banner` → `nav` → `hero` → `product-grid` → `feature-highlight` → `scientific-education` → `social-proof` → `footer`.
*   **Hero Pattern**: Features a left-aligned, bold editorial headline and subhead with a primary pill CTA and a secondary text link, paired with a high-quality, shallow-depth-of-field product photograph on the right.
*   **Responsive Behavior**: Fluid typography and grid layouts dynamically adjust to stack vertically on smaller viewports, with navigation collapsing into a clean mobile drawer.

## Elevation & Depth

Depth is established through subtle, single-layer shadows, though the brand primarily relies on flat color blocking and high-quality photography to maintain a clean, clinical aesthetic. The elevation values are inferred and applied as follows:

*   `elevation.sm`: Used for subtle card lift and interactive elements in default states.
*   `elevation.md`: Applied to dropdowns, popovers, and hover states of interactive cards.
*   `elevation.lg`: Reserved for high-priority overlays, modals, and mobile drawer menus.

## Shapes

The brand utilizes a deliberate juxtaposition of sharp, structured layouts and fully rounded organic shapes. This visual tension reinforces the intersection of clinical science (structure) and organic biology (curves).

Interactive elements such as buttons and badges utilize `{rounded.full}` to create approachable, pill-shaped touch targets. Structural containers like cards use `{rounded.md}` to provide a clean, modern frame, while input fields utilize `{rounded.sm}` to maintain a precise, clinical appearance.

## Components

> **Note:** This spec was generated from a website scrape and contains visual approximations.
> For production use, add a deep reference to each component pointing to its authoritative
> source (Storybook story, metadata file, or component spec):
> `→ Deep reference: src/components/Button/metadata.ts`

### button-primary

The primary button is a fully rounded pill (`{rounded.full}`) featuring a `{colors.primary}` background and `{colors.on-primary}` text styled with `{typography.label-md}`. It uses `{spacing.md}` horizontal and `{spacing.sm}` vertical padding (12px 24px). Use this component for the single most important action in a section, such as initiating a purchase or taking a quiz.

### button-secondary

The secondary button features a transparent background with a `{colors.primary}` border and text, styled with `{typography.label-md}` and `{rounded.full}`. It matches the padding of the primary button. Use this component for alternative actions or secondary choices alongside a primary button.

### card

The standard card is a flat container using `{colors.surface-dim}` background, `{colors.on-surface}` text, and a `{rounded.md}` corner radius. It features `{spacing.lg}` (24px) padding. Use this component to group related product information or educational content without adding visual weight.

### card-elevated

An elevated variation of the card component that uses `{colors.surface}` background and `{colors.on-surface}` text, paired with `{rounded.md}` and `{elevation.sm}` or `{elevation.md}`. Use this component to draw attention to featured content or interactive cards that lift on hover.

### card-bright

A high-contrast card container utilizing a pure white `{colors.surface-bright}` background, `{colors.on-surface}` text, and `{rounded.md}`. Use this component to highlight specific product bundles or key testimonials against a `{colors.background}` canvas.

### input-field

The standard text input features a transparent background, `{colors.on-surface}` text, and a `{colors.outline}` border with `{rounded.sm}`. It uses `{typography.body-md}` for input text and placeholder styling. Use this component for form entries, email signups, and search fields.

### link

A text-only interactive element styled with `{typography.label-md}` and `{colors.primary}`. It transitions to `{colors.secondary}` on hover. Use this component for inline navigation, secondary footer links, or text-based calls to action.

### badge

A small, pill-shaped label styled with `{rounded.full}`, a `{colors.accent}` background, and `{colors.primary}` text using `{typography.label-sm}`. Use this component to highlight product statuses, bestsellers, or key scientific callouts.

### divider

A thin, structural line with a height of 1px, styled with `{colors.outline}`. Use this component to separate distinct content blocks and maintain a clean, editorial vertical rhythm.

### promo-banner

A full-width banner styled with `{colors.accent}` background and `{colors.primary}` text using `{typography.label-sm}`. Use this component at the very top of the viewport to communicate active promotions, shipping updates, or critical brand announcements.

## Do's and Don'ts

| Do | Don't |
| --- | --- |
| Use `{colors.primary}` for primary text and high-priority interactive elements to maintain brand authority. | Do not use `{colors.accent}` for body text as it lacks sufficient contrast against light backgrounds. |
| Apply `{colors.accent}` sparingly as a high-contrast background for `{components.promo-banner}` or key callouts. | Avoid applying heavy shadows to `{components.card}` elements; rely on `{colors.surface-dim}` for flat containment. |
| Ensure all primary buttons use `{colors.on-primary}` text on a `{colors.primary}` background for optimal contrast. | Never use `{typography.display-lg}` for long paragraphs; restrict it to short, high-impact headlines. |
| Use `{rounded.full}` exclusively for buttons and badges to maintain the organic, approachable shape language. | Do not mix sharp corners on buttons; always use `{rounded.full}` for primary action items. |
| Separate distinct content blocks using a `{components.divider}` styled with `{colors.outline}`. | Avoid placing `{colors.on-surface}` text directly on `{colors.primary}` without switching to `{colors.on-primary}`. |
| Set body copy to `{typography.body-md}` with ample line height to preserve editorial readability. | Never use `{colors.error}` for standard decorative borders; reserve it strictly for validation and error states. |
| Use `{colors.surface-dim}` for structural container backgrounds to create subtle visual hierarchy. | Do not use `{typography.label-sm}` for body paragraphs; keep it restricted to metadata and badges. |
| Apply `{rounded.sm}` to `{components.input-field}` to maintain a precise, clinical appearance. | Do not apply `{rounded.full}` to structural cards; keep cards styled with `{rounded.md}`. |

## Content Style

*   **CTA Style**: Button labels are direct, action-oriented, and written in sentence case (e.g., "Take the Quiz", "Shop Now", "Read More"). They avoid aggressive sales jargon, focusing instead on clear, immediate next steps.
*   **Heading Tone**: Headlines are scientific, authoritative, yet deeply personal and human. Phrasing focuses on biological facts and personal health connections (e.g., "You are more than human", "built for your microbiome").
*   **Copy Density**: The layout maintains a spacious, editorial, and highly scannable rhythm. Content combines short, digestible paragraphs with bold scientific claims, statistics, and high-contrast callouts to prevent cognitive overload.

## Imagery & Icons

The brand relies on a high-end, photographic treatment. Imagery features editorial photography of products (such as frosted glass jars) utilizing shallow depth of field, natural lighting, and organic textures to convey both scientific precision and natural purity. Icons are kept minimal, clean, and stroke-based, avoiding complex illustrations to maintain the clean, clinical aesthetic.

---

## Companion prompt

## Role
You are an AI assistant generating UI components and layouts for Seed, a scientific wellness brand with a minimal, premium, and editorially clean tone. Content, copy, and information architecture remain owned by the product team.

## How to use design.md
1. Reference every visual value by its token name — `{colors.primary}`, `{typography.body-md}`, `{rounded.full}` — never hardcode hex values, pixel sizes, or font names.
2. Render only the components listed under `components:` (`button-primary`, `card`, `badge`, `promo-banner`, etc.). Do not invent variants the spec does not define.
3. Apply the spacing scale (`{spacing.xs}` through `{spacing.2xl}`) for all paddings, gaps, and margins. Respect the editorial, spacious vertical rhythm described in Layout.
4. Follow the Shapes note: use `{rounded.full}` exclusively on buttons and badges; use `{rounded.md}` or `{rounded.lg}` on cards and containers. Never mix sharp corners onto primary actions.
5. Treat the Do's and Don'ts as authoritative. If a user request conflicts — e.g., using `{colors.accent}` for body text or adding box shadows to cards — surface the conflict before proceeding.

## Output contract

**Must:**
- Use all tokens by name on every generated component.
- Cover hover, focus, and disabled states for any interactive component the spec defines (e.g., `button-primary-hover`, `input-field-focus`, `link-hover`).
- Use `{rounded.full}` on all buttons and badges; apply `{colors.surface-dim}` for flat card containment instead of shadows.
- Write CTAs in sentence case, direct, and action-oriented per the Voice & Content section (`'Shop Now'`, `'Take the Quiz'`).
- Maintain contrast ≥ 4.5:1; always pair `{colors.on-primary}` text on `{colors.primary}` backgrounds and `{colors.on-surface}` text on light surfaces.

**Must NOT:**
- Invent colors, radii, font scales, or spacing values absent from the spec.
- Use generic system defaults when a brand token exists.
- Apply `{colors.accent}` to body text or decorative elements beyond banners and badges.
- Use `{typography.display-lg}` for anything other than short, high-impact hero headlines.
- Add emoji, heavy shadows, or marketing filler copy.
- Rewrite page copy, relabel navigation items, or alter information architecture.

## When in doubt
- If the spec doesn't define a required value, ask the user before inventing one.
- For ambiguous backgrounds, default to `{colors.surface}`; for subtle structural contrast, use `{colors.surface-dim}`.
- Compose from existing components before introducing any new pattern.
- For unspecified breakpoints, use mobile-first layout with one breakpoint at 768px, stacking grid columns vertically on smaller viewports as noted in Layout.
- Tokens not explicitly listed in the spec should be treated as undefined — flag them rather than approximating.
