taste:
id: iron-forge
name: Iron Forge
summary: >-
A premium, high-contrast industrial interface engineered for maximum task efficiency and
technical precision.
app_type: WEB_APP
project_types:
- saas
styles:
- premium
- bold
industry: software
aesthetics:
- premium
- bold
tags:
- premium
- bold
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': '#767676'
description: >-
The observed grayscale ramp anchoring the industrial canvas from pure white to deep
midnight ink.
brand:
'500': '#641D1D'
description: The signature iron-ore rust red representing technical strength and operational focus.
danger:
'500': '#49090E'
warning:
'500': '#D97706'
success:
'500': '#15803D'
info:
'500': '#1D4ED8'
accent:
'500': '#641D1D'
colors:
background:
light: '#FFFFFF'
dark: neutral/900
foreground:
light: '#0A0A0A'
dark: neutral/100
card:
light: '#FFFFFF'
dark: neutral/800
card-foreground:
light: '#0A0A0A'
dark: neutral/100
popover:
light: neutral/100
dark: neutral/800
popover-foreground:
light: neutral/900
dark: neutral/100
primary:
light: brand/500
dark: brand/500
primary-foreground:
light: neutral/900
dark: neutral/900
secondary:
light: neutral/200
dark: neutral/700
secondary-foreground:
light: neutral/900
dark: neutral/100
muted:
light: neutral/200
dark: neutral/800
muted-foreground:
light: neutral/700
dark: neutral/400
accent:
light: neutral/200
dark: neutral/700
accent-foreground:
light: neutral/900
dark: neutral/100
destructive:
light: danger/500
dark: danger/500
destructive-foreground:
light: neutral/900
dark: neutral/900
border:
light: neutral/300
dark: neutral/700
input:
light: neutral/300
dark: neutral/700
ring:
light: brand/500
dark: brand/500
chart-1:
light: '#641D1D'
dark: '#EAB1B1'
chart-2:
light: '#767676'
dark: '#ACACAC'
chart-3:
light: '#49090E'
dark: '#F0C7C7'
chart-4:
light: '#404040'
dark: '#C7C7C7'
chart-5:
light: '#0A0A0A'
dark: '#E5E5E5'
sidebar:
light: neutral/150
dark: neutral/900
sidebar-foreground:
light: neutral/900
dark: neutral/100
sidebar-primary:
light: brand/500
dark: brand/500
sidebar-primary-foreground:
light: neutral/900
dark: neutral/900
sidebar-accent:
light: neutral/200
dark: neutral/800
sidebar-accent-foreground:
light: neutral/900
dark: neutral/100
sidebar-border:
light: neutral/300
dark: neutral/800
sidebar-ring:
light: brand/500
dark: brand/500
radius:
base:
value: 1.0rem
description: >-
Standard industrial radius for container blocks; actions and button components strictly
override this to 0px sharp.
shadows:
xs:
value: none
sm:
value: none
md:
value: none
lg:
value: none
xl:
value: none
gradients:
brand_wash:
value: 'linear-gradient(180deg, #641D1D 0%, #49090E 100%)'
fonts:
sans:
family: Source Serif 4
description: Editorial serif utilized for high-density, highly-scannable body text and values.
display:
family: Inter
description: >-
Stark, high-impact sans-serif utilized exclusively in uppercase formats for headers and
trackers.
mono:
family: JetBrains Mono
description: Technical monospace for strict numerical formatting and operational timestamps.
typography:
hero:
font: display
size_px: 44
line_height_px: 44
weight: 400
letter_spacing_em: 0.05
transform: uppercase
title:
font: display
size_px: 32
line_height_px: 32
weight: 400
letter_spacing_em: 0.04
transform: uppercase
heading:
font: display
size_px: 24
line_height_px: 24
weight: 400
letter_spacing_em: 0.02
transform: uppercase
body:
font: sans
size_px: 16
line_height_px: 24
weight: 400
letter_spacing_em: 0
transform: none
caption:
font: display
size_px: 13
line_height_px: 15
weight: 500
letter_spacing_em: 0.02
transform: uppercase
label:
font: sans
size_px: 18
line_height_px: 27
weight: 400
letter_spacing_em: -0.01
transform: none
overline:
font: display
size_px: 12
line_height_px: 16
weight: 600
letter_spacing_em: 0.08
transform: uppercase
style_guidelines:
visual_direction:
title: Visual Direction
recommendations:
- >-
Emphasize a raw industrial aesthetic using heavy flat borders, stark unrounded primary
elements, and deep iron-ore reds contrasted against pure white surfaces.
- >-
Rely on solid fills and thick stroke lines instead of gradients or depth effects to
project structural permanence and technical confidence.
hierarchy:
title: Hierarchy
recommendations:
- >-
Command attention using massive, tracked-out uppercase Inter headers contrasted
immediately with dense, highly legible Source Serif 4 body text.
- >-
Isolate critical action vectors with solid, square-edged brand-colored blocks, keeping
secondary functions strictly framed in thin neutral borders.
components:
title: Components
recommendations:
- >-
Execute primary buttons as unrounded, 48px tall blocks featuring small uppercase labels
centered within generous horizontal breathing room.
typography:
title: Typography
recommendations:
- >-
Apply dramatic uppercase styling with expanded letter-spacing to all heading levels to
establish a commanding, architectural editorial voice.
color_and_effects:
title: Color & Effects
recommendations:
- >-
Apply the primary rust-red brand color with extreme restraint, reserving it exclusively
for active interactive states, primary actions, and critical focus highlights.
- >-
Eschew soft drop-shadows entirely, relying on precise high-contrast line work and stark
background shifts to establish depth and division.
quality_bar:
title: Quality Bar
checks:
- id: sharp-corners-only
label: Sharp Primary Actions
recommendation: >-
Ensure primary controls and buttons maintain strictly sharp 0px corners to preserve the
raw, industrial aesthetic of the brand.
- id: status-color-restraint
label: Status Color Restraint
recommendation: >-
Limit the use of warning and success fills to tiny indicator dots or text treatments,
avoiding overwhelming color blocks.
- id: contrast-compliance
label: Contrast Compliance
recommendation: >-
Confirm all text overlaid on the primary iron-red background achieves a contrast ratio of
at least 4.5:1 for maximum legibility.
- id: monospace-alignment
label: Monospace Numerical Alignment
recommendation: >-
Ensure numerical values, IDs, and dates are set in monospace to prevent horizontal layout
shifting during data refreshes.
active_remix:
mode: light
brand: '#641D1D'
display_font: Inter
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).
