taste:
id: clay-terminal
name: Clay Terminal
summary: >-
A warm and precise developer-tools interface combining technical clarity with an inviting cream
and coral palette.
app_type: WEB_APP
project_types:
- saas
styles:
- technical
- warm
industry: software
aesthetics:
- technical
- warm
tags:
- technical
- warm
theme:
default_mode: LIGHT_MODE
palette_note: >-
Only the 500 anchor is provided per palette; the full 17-step ramp (100-900) is derived from
it by the system's heuristic shade tool.
palettes:
neutral:
'500': '#60626A'
description: Technical slate-gray designed to support crisp borders and structured typography.
brand:
'500': '#FF5A36'
description: Warm developer-tools coral orange-red used as the core brand and action anchor.
danger:
'500': '#DF2A45'
description: High-contrast technical red for warnings and destructive actions.
warning:
'500': '#D97706'
description: Warm amber for alerts and non-blocking notifications.
success:
'500': '#059669'
description: Balanced green for completed processes and success indicators.
info:
'500': '#2563EB'
description: Deep technical blue for passive information and status updates.
accent:
'500': '#E2B875'
description: Warm ochre-gold for auxiliary highlights and specialized technical telemetry.
colors:
background:
light: '#F8F4EF'
dark: '#161821'
foreground:
light: '#161821'
dark: '#F8F4EF'
card:
light: '#FCFBF9'
dark: '#1C1E2B'
card-foreground:
light: '#161821'
dark: '#F8F4EF'
popover:
light: '#FCFBF9'
dark: '#1C1E2B'
popover-foreground:
light: '#161821'
dark: '#F8F4EF'
primary:
light: brand/600
dark: brand/500
primary-foreground:
light: neutral/100
dark: neutral/900
secondary:
light: neutral/150
dark: neutral/800
secondary-foreground:
light: neutral/900
dark: neutral/100
muted:
light: neutral/150
dark: neutral/800
muted-foreground:
light: neutral/700
dark: neutral/400
accent:
light: neutral/150
dark: neutral/800
accent-foreground:
light: neutral/900
dark: neutral/100
destructive:
light: danger/600
dark: danger/800
destructive-foreground:
light: neutral/100
dark: neutral/100
border:
light: neutral/250
dark: neutral/800
input:
light: neutral/300
dark: neutral/750
ring:
light: brand/500
dark: brand/500
chart-1:
light: brand/500
dark: brand/500
chart-2:
light: info/500
dark: info/500
chart-3:
light: success/500
dark: success/500
chart-4:
light: warning/500
dark: warning/500
chart-5:
light: accent/500
dark: accent/500
sidebar:
light: neutral/150
dark: neutral/900
sidebar-foreground:
light: neutral/900
dark: neutral/200
sidebar-primary:
light: brand/600
dark: brand/500
sidebar-primary-foreground:
light: neutral/100
dark: neutral/900
sidebar-accent:
light: neutral/200
dark: neutral/800
sidebar-accent-foreground:
light: neutral/900
dark: neutral/100
sidebar-border:
light: neutral/250
dark: neutral/850
sidebar-ring:
light: brand/500
dark: brand/500
radius:
base:
value: 0.375rem
description: Compact geometric corner rounding suitable for structured technical interfaces.
shadows:
xs:
value: 0 1px 2px rgba(22, 24, 33, 0.05)
sm:
value: 0 2px 4px rgba(22, 24, 33, 0.08)
md:
value: 0 4px 8px rgba(22, 24, 33, 0.12)
lg:
value: 0 8px 16px rgba(22, 24, 33, 0.16)
xl:
value: 0 16px 32px rgba(22, 24, 33, 0.2)
gradients:
brand_wash:
value: 'linear-gradient(135deg, #FF5A36 0%, #CC2300 100%)'
fonts:
sans:
family: IBM Plex Sans
description: >-
High-legibility sans-serif optimized for dense visual structures and regular text
elements.
display:
family: Geist
description: Sleek and geometric technical font optimized for layout headers and high-contrast labels.
mono:
family: IBM Plex Mono
description: >-
Vetted monospaced family reserved for metrics, data outputs, and functional inline code
blocks.
typography:
hero:
font: display
size_px: 56
line_height_px: 60
weight: 700
letter_spacing_em: -0.02
transform: none
title:
font: display
size_px: 36
line_height_px: 42
weight: 700
letter_spacing_em: 0
transform: none
heading:
font: display
size_px: 24
line_height_px: 32
weight: 600
letter_spacing_em: 0
transform: none
body:
font: sans
size_px: 14
line_height_px: 20
weight: 400
letter_spacing_em: 0
transform: none
caption:
font: sans
size_px: 12
line_height_px: 16
weight: 400
letter_spacing_em: 0
transform: none
label:
font: sans
size_px: 13
line_height_px: 18
weight: 500
letter_spacing_em: 0
transform: none
overline:
font: sans
size_px: 11
line_height_px: 14
weight: 600
letter_spacing_em: 0.08
transform: uppercase
style_guidelines:
visual_direction:
title: Visual Direction
recommendations:
- >-
Combine high-contrast hairline borders, soft cream backdrops, and precise coral
accentuation to highlight active focus and selection states.
- >-
Leverage geometric, low-radius containers to maintain a technical, clean environment
tailored for developer efficiency.
hierarchy:
title: Hierarchy
recommendations:
- >-
Establish instant scanning order through clear typographic contrast using Geist for
headers and IBM Plex Sans for technical data blocks.
- >-
Use discrete, low-saturation backgrounds to structure layout sections, retaining sharp
high-saturation colors only for critical interactive states.
layout:
title: Layout
recommendations:
- >-
Employ thin, distinct border separations rather than heavy drop shadows to divide
functional page zones.
components:
title: Components
recommendations:
- >-
Implement clear keyboard focus indicators using the primary brand color to guarantee
highly accessible interactive states.
typography:
title: Typography
recommendations:
- >-
Reserve IBM Plex Mono strictly for technical outputs, status codes, precise numeric
arrays, and tabular keys.
- >-
Use the uppercase overline style for section category tags to anchor content blocks
without competing with standard body text.
color_and_effects:
title: Color & Effects
recommendations:
- >-
Restrict the use of the vivid coral primary color to interactive touchpoints, navigation
markers, and deliberate system focal points.
- >-
Keep container drop shadows light and soft, relying on thin borders to convey depth and
technical organization.
quality_bar:
title: Quality Bar
checks:
- id: focus-visibility
label: Focus Visibility
recommendation: >-
Ensure all interactive inputs, selectors, and buttons highlight with a prominent coral
border on focus.
- id: contrast-integrity
label: Contrast Integrity
recommendation: >-
Ensure all text, label, and status badge combinations exceed the 4.5:1 contrast
requirement in both default light and dark modes.
- id: density-balance
label: Density Balance
recommendation: >-
Maintain a high information density while safeguarding comfortable spacing, clean
alignment, and target hit areas.
- id: status-restraint
label: Status Restraint
recommendation: >-
Apply status colors selectively to prevent visual overload, allowing critical system
alerts to stand out immediately.
active_remix:
mode: light
brand: '#FF5A36'
display_font: Geist
shape: system
depth: system
spacing: system
spacing_value: null
craft: >
# Craft (universal core + conditional craft)
How to apply this design system well. These rules contain no brand look of their own — all
per-system character comes from the tokens and taste notes above; this section only governs
how they are composed. **Precedence:** the design system above is the authority on how things
look — where its own notes conflict with a rule here, the design system wins. And the user's
request is the authority on what the screen IS — notes above that describe the source
product's screens (workspaces, dashboards, panels) are its aesthetic heritage, not an
instruction to build that kind of screen.
## Universal — applies to every screen (screen-agnostic craft)
- **Surface definition.** Every container is visually separable from what it sits on — at least
one
honest edge cue: a hairline border, a ≥4% tonal step from its parent, or a real shadow. Never a card
whose fill matches its section with no border; never nested surfaces that dissolve together.
- **Accent discipline.** The brand/primary color is a scalpel, not paint: spend it on the primary
action, the active/selected/focused state, and at most **one** brand or data highlight per screen.
Everything else rides neutral background / card / muted / border tokens. A screen flooded with brand
color reads unfinished, not bold.
- **Restraint ledger.** Beauty is also what you don't do: at most one glow and two gradient
directions
screen-wide; decoration only where content doesn't reach; no ornament between a heading and its own
action. Every decorative element must answer "what does this make clearer or more felt?" — if the
answer is "nothing," remove it.
- **Type with intent.** The measured faces/scale are fixed; character comes from *usage*, and the
move
must fit the surface — a marketing page earns a dramatic display move; a working screen earns a
crisp, tight, legible hierarchy at UI scale (display-hero type on a dense tool is a smell). Chrome
and wayfinding are never display type; data numerals are tabular (mono or sans), never the
decorative face. Headings stay roman — italics live as emphasis inside running text, not as
display styling (unless the system's own type says otherwise).
- **Anti-default.** If the screen could pass for a generic template with the colors swapped, it is
not
done. Make the brand unmistakable through the accent's *use*, the type, the radius + density, and
**one** signature detail — never by importing another surface's clichés.
- **Honest content.** Never invent proof — no made-up adoption counts, growth percentages,
testimonials, client logos, or awards. Use the user's real content, a neutral placeholder, or
leave the element out and let the layout carry it. Never hand-draw fake browser bars, phone
frames, or editor chrome around content — show the content itself, or nothing.
- **Interaction integrity.** Buttons, links, tabs, and nav labels never wrap to two lines; display
headlines wrap cleanly, never clipping mid-word; nothing overflows horizontally at any width;
keyboard focus gets an instant, clearly visible ring.
- **Token fidelity.** Every design value comes from a token: colors, radii, shadows, and fonts
from
the system's variables — never a literal hex, a hand-picked shadow, or a substitute font. For a
translucent or composited value (a scrim, a glow, a hairline over a fill), derive it from a token
(an opacity modifier or color-mix), never a literal rgba. If the system specifies square corners and
a hard shadow, the screen shows square corners and that hard shadow — not a rounded, soft substitute.
## Conditional — apply ONLY the layer that matches the screen the user asked for
**First name the screen honestly from the user's prompt.** Then apply the matching guidance. Do
not
cross layers, and **do not add elements from a layer the screen doesn't call for** — a screen that
is
not a data view must not sprout KPI tiles, charts, filter bars, or data tables to satisfy a
template.
- **If it's a data / dashboard / admin / table view:** density done well (comfortable rows, tight
control clusters, one spacing rhythm); a populated working state (real rows/cards, not empty feature
boxes); tables with aligned tabular numerals, status as badges, row hover, one visible selected row,
and control states that agree with the data shown. KPI tiles, *if the screen has them*, are
value + label + delta. **At most one** chart, of a real metric for this domain, token-colored and
axis-labeled — never a decorative sine wave or filler sparkline. Exactly one unambiguous primary
action.
- **If it's a focused task / tool / player / capture / monitor / form / wizard (not a data
view):**
the screen's real job dominates the frame; chrome recedes. Honor the screen's own nature — a player
looks like a player, a monitor like a monitor, a form like a form — with the design system's color,
type, radius, and depth applied to *those* elements. **No dashboard furniture**: no KPI tiles, no
charts, no data tables, no filter chrome unless the task itself is about that data. Real-time or
safety-critical readouts get calm, unambiguous, high-legibility treatment over decoration.
- **If it's a marketing / landing surface:** editorial art direction belongs here — section rhythm
(modulate surface temperature, density, and scale; one oversized moment; at least one full-bleed
band) and considered visual treatments. Never put this on a working app screen.
- **Mobile:** follow the platform's native idioms for the screen's type (e.g. an app screen:
compact
top bar, one focused column, a bottom tab bar, ≥44px targets, safe areas) — the same conditional
rules above still decide what content belongs.
## Imagery (universal)
- **Imagery is content, not decoration** on working screens: images are data (covers, products,
avatars, places) in purposeful containers, one consistent treatment across siblings — never a lone
photo floating in a box, never marketing's decorative fades on a work screen. When a moment needs
atmosphere, build it from the token system (tinted panels, token gradients, geometry).
