back to gallery
design language·frosted-tints-steel-structure

Frosted Tints With Steel Structure

A portable design language for agents: download the markdown first, then inspect the preview, tokens, and rules as needed.

Download DESIGN.md

Portable DESIGN.md source of truth for most agents and apps.

the spec

specification

philosophy
summary
A production-credible palette language for creative interfaces that uses frosted blue, mint, lilac, blush, and pearl as luminous environmental tints while steel and ink neutrals carry reading, hierarchy, and operational trust.
values
Tint as atmosphere, not typographySteel-neutral structure for enterprise-grade contrastSemantic token readiness across light and dark modesCalm chroma discipline with warm/cool balanceAccessible focus and data visualization safety
anti-values
×Pastel-on-white copy, ghost controls, or disabled-looking primary actions×Cotton-candy gradients that blur brand signal and reduce contrast×Decorative tints used as status colors without accessible semantic anchors
tokens
borders4 items
accent width
3px
character
Cool steel borders define structure; accent borders are used only for focus, selected state, or active semantic emphasis.
default width
1px
style
solid hairline plus occasional inset highlight
colors12 items
accent
#BDEFE4
background
#F7FAFC
border
#A9B7C4
error
#9B2F46
info
#285C8F
muted
#647284
primary
#1F3142
secondary
#D9ECF4
success
#1F6F5B
surface
#FFFFFF
text
#152231
warning
#8A5B12
motion3 items
duration
160ms
easing
cubic-bezier(.2,.8,.2,1)
philosophy
Small lift, tint clarify, and focus-ring reveal; no floating pastel animations or gradient shimmer.
radii5 items
full
9999px
lg
26px
md
16px
none
0
sm
10px
shadows3 items
lg
0 32px 80px rgba(31,49,66,.18), 0 0 0 1px rgba(169,183,196,.32)
md
0 18px 48px rgba(31,49,66,.12), 0 0 0 1px rgba(169,183,196,.28)
sm
0 1px 2px rgba(31,49,66,.08), 0 0 0 1px rgba(169,183,196,.24)
spacing2 items
base
8px
scale
4, 8, 12, 16, 24, 32, 48, 64
surfaces3 items
bg pattern
Large blurred frost halos in blue, mint, lilac, and blush are anchored by a subtle 16px steel grid at very low opacity.
card style
White or pearl cards use steel hairline borders, glacial top glints, and restrained tint underlays offset by 8-14px.
treatment
Pearl and frosted tint panels sit over #F7FAFC with solid white content wells; tint opacity stays below 52% behind interactive content.
typography8 items
base size
16px
body font
Source Sans 3
google fonts url
https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@500;600&family=Instrument+Sans:wght@500;600;700;800&family=Source+Sans+3:wght@400;500;600;700&display=swap
heading font
Instrument Sans
letter spacing
-0.015em
line height
1.52
mono font
IBM Plex Mono
scale ratio
1.22
rules
composition

Build product screens from a steel-neutral app shell, white content wells, and frosted tint side panels so the tints frame work instead of competing with it.

density

Medium-dense enterprise spacing with 8px rhythm, generous card padding, and compact tables that remain readable.

hierarchy

Use ink text, bolder headings, compact mono labels, and dark primary controls; color emphasis appears as chips, rails, focus rings, and surface glazes.

signature patterns
Frost rail: a 4px vertical rail blends mint to blue beside important modules while text stays in ink on white.Pearl pane: cards include an offset translucent tint slab behind the lower-right edge to show atmosphere without lowering content contrast.Steel ledger: tables and forms use crisp steel dividers, mono metadata, and dark selected rows with pale tint badges.Glaze map: data-viz blocks use outlined swatches and patterned fills so tint families are distinguishable for colorblind users.
layout
breakpoints

mobile 375px, tablet 768px, desktop 1200px, wide 1440px

grid

12-column desktop grid with a 280px navigation rail, 24px gutters, and card spans that collapse to two columns on tablet and one on mobile.

whitespace

Use calm perimeter whitespace and tight internal groupings; keep frost halos at page edges and away from body copy.

guidance
do
  • Use ink and steel for all primary text and core controls.
  • Tokenize pale primitives separately from semantic status tokens.
  • Provide dark mode as charcoal plus luminous glazes, not as saturated neon.
  • Use strong focus rings and selected states that exceed WCAG non-text contrast expectations.
avoid
  • Do not set pastel text on white, pearl, or frosted tint surfaces.
  • Do not use multiple candy gradients as the main brand gesture.
  • Do not rely on hue alone for charts, alerts, or status.
  • Do not let decorative blur reduce table, form, or navigation clarity.
katagami spec
# Frosted Tints With Steel Structure

## Philosophy

A production-credible palette language for creative interfaces that uses frosted blue, mint, lilac, blush, and pearl as luminous environmental tints while steel and ink neutrals carry reading, hierarchy, and operational trust.

### Values

- Tint as atmosphere, not typography
- Steel-neutral structure for enterprise-grade contrast
- Semantic token readiness across light and dark modes
- Calm chroma discipline with warm/cool balance
- Accessible focus and data visualization safety

### Anti-Values

- Pastel-on-white copy, ghost controls, or disabled-looking primary actions
- Cotton-candy gradients that blur brand signal and reduce contrast
- Decorative tints used as status colors without accessible semantic anchors

### Visual Character

- Layered cards use translucent pearl-to-blue linear gradients over solid steel borders, with no text placed directly on low-contrast tint fields.
- Primary actions are dark ink or deep steel capsules with pale glacial inner highlights and a visible 3px mint-blue focus ring.
- Sections are divided by fine steel hairlines, offset frost panels, and compact status chips that reserve blush, lilac, and mint for small semantic accents.
- Dark mode is anticipated through charcoal surfaces with desaturated luminous glaze bands rather than inverted candy colors.

## Tokens

### Borders

- **Accent Width**: 3px
- **Character**: Cool steel borders define structure; accent borders are used only for focus, selected state, or active semantic emphasis.
- **Default Width**: 1px
- **Style**: solid hairline plus occasional inset highlight

### Colors

| Name | Value |
|------|-------|
| accent | `#BDEFE4` |
| background | `#F7FAFC` |
| border | `#A9B7C4` |
| error | `#9B2F46` |
| info | `#285C8F` |
| muted | `#647284` |
| primary | `#1F3142` |
| secondary | `#D9ECF4` |
| success | `#1F6F5B` |
| surface | `#FFFFFF` |
| text | `#152231` |
| warning | `#8A5B12` |

### Motion

- **Duration**: 160ms
- **Easing**: cubic-bezier(.2,.8,.2,1)
- **Philosophy**: Small lift, tint clarify, and focus-ring reveal; no floating pastel animations or gradient shimmer.

### Radii

- **Full**: 9999px
- **Lg**: 26px
- **Md**: 16px
- **None**: 0
- **Sm**: 10px

### Shadows

- **Lg**: 0 32px 80px rgba(31,49,66,.18), 0 0 0 1px rgba(169,183,196,.32)
- **Md**: 0 18px 48px rgba(31,49,66,.12), 0 0 0 1px rgba(169,183,196,.28)
- **Sm**: 0 1px 2px rgba(31,49,66,.08), 0 0 0 1px rgba(169,183,196,.24)

### Spacing

- **Base**: 8px
- **Scale**: [4,8,12,16,24,32,48,64]

### Surfaces

- **Bg Pattern**: Large blurred frost halos in blue, mint, lilac, and blush are anchored by a subtle 16px steel grid at very low opacity.
- **Card Style**: White or pearl cards use steel hairline borders, glacial top glints, and restrained tint underlays offset by 8-14px.
- **Treatment**: Pearl and frosted tint panels sit over #F7FAFC with solid white content wells; tint opacity stays below 52% behind interactive content.

### Typography

- **Base Size**: 16px
- **Body Font**: Source Sans 3
- **Google Fonts Url**: https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@500;600&family=Instrument+Sans:wght@500;600;700;800&family=Source+Sans+3:wght@400;500;600;700&display=swap
- **Heading Font**: Instrument Sans
- **Letter Spacing**: -0.015em
- **Line Height**: 1.52
- **Mono Font**: IBM Plex Mono
- **Scale Ratio**: 1.22

## Rules

### Composition

Build product screens from a steel-neutral app shell, white content wells, and frosted tint side panels so the tints frame work instead of competing with it.

### Density

Medium-dense enterprise spacing with 8px rhythm, generous card padding, and compact tables that remain readable.

### Hierarchy

Use ink text, bolder headings, compact mono labels, and dark primary controls; color emphasis appears as chips, rails, focus rings, and surface glazes.

### Signature Patterns

- Frost rail: a 4px vertical rail blends mint to blue beside important modules while text stays in ink on white.
- Pearl pane: cards include an offset translucent tint slab behind the lower-right edge to show atmosphere without lowering content contrast.
- Steel ledger: tables and forms use crisp steel dividers, mono metadata, and dark selected rows with pale tint badges.
- Glaze map: data-viz blocks use outlined swatches and patterned fills so tint families are distinguishable for colorblind users.

## Layout

### Breakpoints

mobile 375px, tablet 768px, desktop 1200px, wide 1440px

### Grid

12-column desktop grid with a 280px navigation rail, 24px gutters, and card spans that collapse to two columns on tablet and one on mobile.

### Whitespace

Use calm perimeter whitespace and tight internal groupings; keep frost halos at page edges and away from body copy.

## Guidance

### Do

- Use ink and steel for all primary text and core controls.
- Tokenize pale primitives separately from semantic status tokens.
- Provide dark mode as charcoal plus luminous glazes, not as saturated neon.
- Use strong focus rings and selected states that exceed WCAG non-text contrast expectations.

### Don't

- Do not set pastel text on white, pearl, or frosted tint surfaces.
- Do not use multiple candy gradients as the main brand gesture.
- Do not rely on hue alone for charts, alerts, or status.
- Do not let decorative blur reduce table, form, or navigation clarity.
DESIGN.md
---
version: "alpha"
name: "Frosted Tints With Steel Structure"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
  accent: "#BDEFE4"
  background: "#F7FAFC"
  border: "#A9B7C4"
  error: "#9B2F46"
  info: "#285C8F"
  muted: "#647284"
  primary: "#1F3142"
  secondary: "#D9ECF4"
  success: "#1F6F5B"
  surface: "#FFFFFF"
  text: "#152231"
  warning: "#8A5B12"
typography:
  headline-lg:
    fontFamily: "Instrument Sans"
    fontSize: "1.816rem"
    fontWeight: 700
    lineHeight: 1.1
    letterSpacing: "-0.015em"
  headline-md:
    fontFamily: "Instrument Sans"
    fontSize: "1.488rem"
    fontWeight: 600
    lineHeight: 1.15
    letterSpacing: "-0.015em"
  body-md:
    fontFamily: "Source Sans 3"
    fontSize: "16px"
    fontWeight: 400
    lineHeight: 1.52
    letterSpacing: "-0.015em"
  label-md:
    fontFamily: "IBM Plex Mono"
    fontSize: "0.75rem"
    fontWeight: 600
    lineHeight: 1
    letterSpacing: "0.08em"
rounded:
  full: "9999px"
  lg: "26px"
  md: "16px"
  none: "0px"
  sm: "10px"
spacing:
  base: "8px"
  xs: "4px"
  sm: "8px"
  md: "12px"
  lg: "16px"
  xl: "24px"
  2xl: "32px"
  3xl: "48px"
  4xl: "64px"
components:
  color-reference-accent:
    backgroundColor: "{colors.accent}"
  color-reference-background:
    backgroundColor: "{colors.background}"
  color-reference-border:
    backgroundColor: "{colors.border}"
  color-reference-error:
    backgroundColor: "{colors.error}"
  color-reference-info:
    backgroundColor: "{colors.info}"
  color-reference-muted:
    backgroundColor: "{colors.muted}"
  color-reference-primary:
    backgroundColor: "{colors.primary}"
  color-reference-secondary:
    backgroundColor: "{colors.secondary}"
  color-reference-success:
    backgroundColor: "{colors.success}"
  color-reference-surface:
    backgroundColor: "{colors.surface}"
  color-reference-text:
    backgroundColor: "{colors.text}"
  color-reference-warning:
    backgroundColor: "{colors.warning}"
  button-primary:
    backgroundColor: "{colors.primary}"
    textColor: "#ffffff"
    typography: "{typography.label-md}"
    rounded: "{rounded.md}"
    padding: "{spacing.md}"
  card-surface:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.text}"
    rounded: "{rounded.md}"
    padding: "{spacing.md}"
  input-default:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.text}"
    rounded: "{rounded.md}"
    height: "44px"
---

# Frosted Tints With Steel Structure

## Overview

A production-credible palette language for creative interfaces that uses frosted blue, mint, lilac, blush, and pearl as luminous environmental tints while steel and ink neutrals carry reading, hierarchy, and operational trust.

### Values

- Tint as atmosphere, not typography
- Steel-neutral structure for enterprise-grade contrast
- Semantic token readiness across light and dark modes
- Calm chroma discipline with warm/cool balance
- Accessible focus and data visualization safety

### Anti-Values

- Pastel-on-white copy, ghost controls, or disabled-looking primary actions
- Cotton-candy gradients that blur brand signal and reduce contrast
- Decorative tints used as status colors without accessible semantic anchors

### Visual Character

- Layered cards use translucent pearl-to-blue linear gradients over solid steel borders, with no text placed directly on low-contrast tint fields.
- Primary actions are dark ink or deep steel capsules with pale glacial inner highlights and a visible 3px mint-blue focus ring.
- Sections are divided by fine steel hairlines, offset frost panels, and compact status chips that reserve blush, lilac, and mint for small semantic accents.
- Dark mode is anticipated through charcoal surfaces with desaturated luminous glaze bands rather than inverted candy colors.

## Colors

Use the YAML color tokens as the normative palette. The prose below names the roles agents should preserve when generating UI.

| Token | Value |
|-------|-------|
| accent | `#BDEFE4` |
| background | `#F7FAFC` |
| border | `#A9B7C4` |
| error | `#9B2F46` |
| info | `#285C8F` |
| muted | `#647284` |
| primary | `#1F3142` |
| secondary | `#D9ECF4` |
| success | `#1F6F5B` |
| surface | `#FFFFFF` |
| text | `#152231` |
| warning | `#8A5B12` |

## Typography

- **Headline-Lg**: Instrument Sans, 1.816rem, weight 700, line-height 1.1.
- **Headline-Md**: Instrument Sans, 1.488rem, weight 600, line-height 1.15.
- **Body-Md**: Source Sans 3, 16px, weight 400, line-height 1.52.
- **Label-Md**: IBM Plex Mono, 0.75rem, weight 600, line-height 1.

## Layout

### Spacing Tokens

- **Base**: `8px`
- **Xs**: `4px`
- **Sm**: `8px`
- **Md**: `12px`
- **Lg**: `16px`
- **Xl**: `24px`
- **2xl**: `32px`
- **3xl**: `48px`
- **4xl**: `64px`

### Breakpoints

mobile 375px, tablet 768px, desktop 1200px, wide 1440px

### Grid

12-column desktop grid with a 280px navigation rail, 24px gutters, and card spans that collapse to two columns on tablet and one on mobile.

### Whitespace

Use calm perimeter whitespace and tight internal groupings; keep frost halos at page edges and away from body copy.

## Elevation & Depth

### Shadows

- **Lg**: 0 32px 80px rgba(31,49,66,.18), 0 0 0 1px rgba(169,183,196,.32)
- **Md**: 0 18px 48px rgba(31,49,66,.12), 0 0 0 1px rgba(169,183,196,.28)
- **Sm**: 0 1px 2px rgba(31,49,66,.08), 0 0 0 1px rgba(169,183,196,.24)

## Shapes

### Rounded

- **Full**: `9999px`
- **Lg**: `26px`
- **Md**: `16px`
- **None**: `0px`
- **Sm**: `10px`

### Surfaces

- **Bg Pattern**: Large blurred frost halos in blue, mint, lilac, and blush are anchored by a subtle 16px steel grid at very low opacity.
- **Card Style**: White or pearl cards use steel hairline borders, glacial top glints, and restrained tint underlays offset by 8-14px.
- **Treatment**: Pearl and frosted tint panels sit over #F7FAFC with solid white content wells; tint opacity stays below 52% behind interactive content.

### Borders

- **Accent Width**: 3px
- **Character**: Cool steel borders define structure; accent borders are used only for focus, selected state, or active semantic emphasis.
- **Default Width**: 1px
- **Style**: solid hairline plus occasional inset highlight

## Components

### Composition

Build product screens from a steel-neutral app shell, white content wells, and frosted tint side panels so the tints frame work instead of competing with it.

### Density

Medium-dense enterprise spacing with 8px rhythm, generous card padding, and compact tables that remain readable.

### Hierarchy

Use ink text, bolder headings, compact mono labels, and dark primary controls; color emphasis appears as chips, rails, focus rings, and surface glazes.

### Signature Patterns

- Frost rail: a 4px vertical rail blends mint to blue beside important modules while text stays in ink on white.
- Pearl pane: cards include an offset translucent tint slab behind the lower-right edge to show atmosphere without lowering content contrast.
- Steel ledger: tables and forms use crisp steel dividers, mono metadata, and dark selected rows with pale tint badges.
- Glaze map: data-viz blocks use outlined swatches and patterned fills so tint families are distinguishable for colorblind users.

## shadcn/ui Usage

When the target app uses shadcn/ui, copy DESIGN.md with shadcn instead of the plain DESIGN.md. It contains the same Katagami design-language source plus the shadcn/ui primitives, imports, theme variables, component recipes, and preview-shot guidance.

DESIGN.md with shadcn: `/language/en-019ea9b4-b606-7bf2-9590-1cd4671f5e36/DESIGN.with-shadcn.md`.

The shadcn page also exposes optional machine-readable files for automation, but the human-facing handoff is DESIGN.md with shadcn.

Install recommended primitives with `npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table`.

Use these primitives in shadcn apps:
- button
- card
- input
- textarea
- select
- dialog
- sheet
- tabs
- badge
- separator
- checkbox
- switch
- slider
- tooltip
- dropdown-menu
- table

Implementation rule for agents: import shadcn primitives from `@/components/ui/*`, apply the generated CSS variables first, then compose the language-specific recipes from the companion MD. Katagami remains the source of truth; shadcn names are the implementation surface.

## Do's and Don'ts

- Do Use ink and steel for all primary text and core controls.
- Do Tokenize pale primitives separately from semantic status tokens.
- Do Provide dark mode as charcoal plus luminous glazes, not as saturated neon.
- Do Use strong focus rings and selected states that exceed WCAG non-text contrast expectations.
- Don't Do not set pastel text on white, pearl, or frosted tint surfaces.
- Don't Do not use multiple candy gradients as the main brand gesture.
- Don't Do not rely on hue alone for charts, alerts, or status.
- Don't Do not let decorative blur reduce table, form, or navigation clarity.
shadcn/ui theme
```json
{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "frosted-tints-steel-structure",
  "type": "registry:theme",
  "title": "Frosted Tints With Steel Structure shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#F7FAFC",
      "foreground": "#152231",
      "card": "#FFFFFF",
      "card-foreground": "#152231",
      "popover": "#FFFFFF",
      "popover-foreground": "#152231",
      "primary": "#1F3142",
      "primary-foreground": "#ffffff",
      "secondary": "#D9ECF4",
      "secondary-foreground": "#111111",
      "muted": "#647284",
      "muted-foreground": "#152231",
      "accent": "#BDEFE4",
      "accent-foreground": "#111111",
      "destructive": "#9B2F46",
      "border": "#A9B7C4",
      "input": "#A9B7C4",
      "ring": "#BDEFE4",
      "chart-1": "#1F3142",
      "chart-2": "#D9ECF4",
      "chart-3": "#BDEFE4",
      "chart-4": "#1F6F5B",
      "chart-5": "#8A5B12",
      "sidebar": "#FFFFFF",
      "sidebar-foreground": "#152231",
      "sidebar-primary": "#1F3142",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#285C8F",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#A9B7C4",
      "sidebar-ring": "#BDEFE4",
      "radius": "16px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#1F3142",
      "primary-foreground": "#ffffff",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#BDEFE4",
      "accent-foreground": "#111111",
      "destructive": "#9B2F46",
      "border": "#303642",
      "input": "#303642",
      "ring": "#BDEFE4",
      "chart-1": "#1F3142",
      "chart-2": "#D9ECF4",
      "chart-3": "#BDEFE4",
      "chart-4": "#1F6F5B",
      "chart-5": "#8A5B12",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#1F3142",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#BDEFE4",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#303642",
      "sidebar-ring": "#BDEFE4",
      "radius": "16px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "en-019ea9b4-b606-7bf2-9590-1cd4671f5e36",
    "slug": "frosted-tints-steel-structure",
    "componentManifest": [
      "button",
      "card",
      "input",
      "textarea",
      "select",
      "dialog",
      "sheet",
      "tabs",
      "badge",
      "separator",
      "checkbox",
      "switch",
      "slider",
      "tooltip",
      "dropdown-menu",
      "table"
    ],
    "installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
    "nativeTokenNames": {
      "borders": [
        "accent_width",
        "character",
        "default_width",
        "style"
      ],
      "colors": [
        "accent",
        "background",
        "border",
        "error",
        "info",
        "muted",
        "primary",
        "secondary",
        "success",
        "surface",
        "text",
        "warning"
      ],
      "motion": [
        "duration",
        "easing",
        "philosophy"
      ],
      "radii": [
        "full",
        "lg",
        "md",
        "none",
        "sm"
      ],
      "shadows": [
        "lg",
        "md",
        "sm"
      ],
      "spacing": [
        "base",
        "scale"
      ],
      "surfaces": [
        "bg_pattern",
        "card_style",
        "treatment"
      ],
      "typography": [
        "base_size",
        "body_font",
        "google_fonts_url",
        "heading_font",
        "letter_spacing",
        "line_height",
        "mono_font",
        "scale_ratio"
      ]
    }
  }
}
```
in the wild

embodiments

the full element showcase
embodiment · frosted-tints-steel-structure
DESIGN.md

at a glance

Palette

Typography

headline-lgInstrument Sans · 29px · 700

The quick brown fox jumps

headline-mdInstrument Sans · 24px · 600

The quick brown fox jumps

body-mdSource Sans 3 · 16px · 400

The quick brown fox jumps

label-mdIBM Plex Mono · 12px · 600

The quick brown fox jumps

Components

New
Card title

Components rendered with this language’s tokens — colors, type, and rounded corners as specified.

Spacing

  • base8px
  • xs4px
  • sm8px
  • md12px
  • lg16px
  • xl24px
  • 2xl32px
  • 3xl48px
  • 4xl64px

Shape

full9999px
lg26px
md16px
none0px
sm10px
shadcn/ui

implementation kit

needs agent-authored kitstored
shadcn compatibility only
The generated theme variables are available, but the polished shadcn component recipes and shots have not been authored by the Katagami agent yet.
fallbackprimitives render
Compatibility proof
Local shadcn-style primitives accept the generated theme variables.
primaryaccentsurfacemutedwarningerror
table rhythm
buttonok
cardok
inputok
recommendedcompatibility fallback

DESIGN.md with shadcn

Copy this when the target app uses shadcn/ui. It packages the Katagami DESIGN.md context with the install list, theme variables, component recipes, preview-shot contract, and starter TSX in one Markdown companion.

advanced implementation filesoptional machine-readable theme, CSS, TSX starter, recipes, and preview contract
shadcn add
npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table
theme css
:root {
  --background: #F7FAFC;
  --foreground: #152231;
  --card: #FFFFFF;
  --card-foreground: #152231;
  --popover: #FFFFFF;
  --popover-foreground: #152231;
  --primary: #1F3142;
  --primary-foreground: #ffffff;
  --secondary: #D9ECF4;
  --secondary-foreground: #111111;
  --muted: #647284;
  --muted-foreground: #152231;
  --accent: #BDEFE4;
  --accent-foreground: #111111;
  --destructive: #9B2F46;
  --border: #A9B7C4;
  --input: #A9B7C4;
  --ring: #BDEFE4;
  --chart-1: #1F3142;
  --chart-2: #D9ECF4;
  --chart-3: #BDEFE4;
  --chart-4: #1F6F5B;
  --chart-5: #8A5B12;
  --sidebar: #FFFFFF;
  --sidebar-foreground: #152231;
  --sidebar-primary: #1F3142;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #285C8F;
  --sidebar-accent-foreground: #ffffff;
  --sidebar-border: #A9B7C4;
  --sidebar-ring: #BDEFE4;
  --radius: 16px;
}

.dark {
  --background: #0f1115;
  --foreground: #f8fafc;
  --card: #181b22;
  --card-foreground: #f8fafc;
  --popover: #181b22;
  --popover-foreground: #f8fafc;
  --primary: #1F3142;
  --primary-foreground: #ffffff;
  --secondary: #252a33;
  --secondary-foreground: #f8fafc;
  --muted: #252a33;
  --muted-foreground: #a1a1aa;
  --accent: #BDEFE4;
  --accent-foreground: #111111;
  --destructive: #9B2F46;
  --border: #303642;
  --input: #303642;
  --ring: #BDEFE4;
  --chart-1: #1F3142;
  --chart-2: #D9ECF4;
  --chart-3: #BDEFE4;
  --chart-4: #1F6F5B;
  --chart-5: #8A5B12;
  --sidebar: #181b22;
  --sidebar-foreground: #f8fafc;
  --sidebar-primary: #1F3142;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #BDEFE4;
  --sidebar-accent-foreground: #111111;
  --sidebar-border: #303642;
  --sidebar-ring: #BDEFE4;
  --radius: 16px;
}
tsx starter
import { Badge } from "@/components/ui/badge";
import { Button } from "@/components/ui/button";
import {
  Card,
  CardContent,
  CardDescription,
  CardFooter,
  CardHeader,
  CardTitle,
} from "@/components/ui/card";
import { Input } from "@/components/ui/input";
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs";

export function FrostedTintsWithSteelStructureShadcnKit() {
  return (
    <section className="grid gap-4 rounded-[var(--radius)] border bg-background p-4 text-foreground">
      <div className="flex items-start justify-between gap-4">
        <div>
          <Badge variant="outline">shadcn/ui</Badge>
          <h2 className="mt-3 text-2xl font-semibold tracking-tight">Frosted Tints With Steel Structure</h2>
          <p className="mt-1 max-w-xl text-sm text-muted-foreground">
            Use the Katagami registry theme, then compose these shadcn primitives
            with the language-specific component recipes.
          </p>
        </div>
        <Button>Apply theme</Button>
      </div>

      <Tabs defaultValue="components">
        <TabsList>
          <TabsTrigger value="components">Components</TabsTrigger>
          <TabsTrigger value="states">States</TabsTrigger>
          <TabsTrigger value="export">Export</TabsTrigger>
        </TabsList>
      </Tabs>

      <Card>
        <CardHeader>
          <CardTitle>Component recipe</CardTitle>
          <CardDescription>
            Replace this starter content with the agent-authored product scene
            from components.md and preview-shots.json.
          </CardDescription>
        </CardHeader>
        <CardContent className="grid gap-3 sm:grid-cols-[1fr_auto]">
          <Input defaultValue="Tokenized shadcn surface" aria-label="Recipe name" />
          <Button variant="secondary">Preview state</Button>
        </CardContent>
        <CardFooter className="justify-between">
          <Badge>Ready</Badge>
          <Button variant="outline">Copy recipe</Button>
        </CardFooter>
      </Card>
    </section>
  );
}
theme JSONcompatibility fallback
{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "frosted-tints-steel-structure",
  "type": "registry:theme",
  "title": "Frosted Tints With Steel Structure shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#F7FAFC",
      "foreground": "#152231",
      "card": "#FFFFFF",
      "card-foreground": "#152231",
      "popover": "#FFFFFF",
      "popover-foreground": "#152231",
      "primary": "#1F3142",
      "primary-foreground": "#ffffff",
      "secondary": "#D9ECF4",
      "secondary-foreground": "#111111",
      "muted": "#647284",
      "muted-foreground": "#152231",
      "accent": "#BDEFE4",
      "accent-foreground": "#111111",
      "destructive": "#9B2F46",
      "border": "#A9B7C4",
      "input": "#A9B7C4",
      "ring": "#BDEFE4",
      "chart-1": "#1F3142",
      "chart-2": "#D9ECF4",
      "chart-3": "#BDEFE4",
      "chart-4": "#1F6F5B",
      "chart-5": "#8A5B12",
      "sidebar": "#FFFFFF",
      "sidebar-foreground": "#152231",
      "sidebar-primary": "#1F3142",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#285C8F",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#A9B7C4",
      "sidebar-ring": "#BDEFE4",
      "radius": "16px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#1F3142",
      "primary-foreground": "#ffffff",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#BDEFE4",
      "accent-foreground": "#111111",
      "destructive": "#9B2F46",
      "border": "#303642",
      "input": "#303642",
      "ring": "#BDEFE4",
      "chart-1": "#1F3142",
      "chart-2": "#D9ECF4",
      "chart-3": "#BDEFE4",
      "chart-4": "#1F6F5B",
      "chart-5": "#8A5B12",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#1F3142",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#BDEFE4",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#303642",
      "sidebar-ring": "#BDEFE4",
      "radius": "16px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "en-019ea9b4-b606-7bf2-9590-1cd4671f5e36",
    "slug": "frosted-tints-steel-structure",
    "componentManifest": [
      "button",
      "card",
      "input",
      "textarea",
      "select",
      "dialog",
      "sheet",
      "tabs",
      "badge",
      "separator",
      "checkbox",
      "switch",
      "slider",
      "tooltip",
      "dropdown-menu",
      "table"
    ],
    "installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
    "nativeTokenNames": {
      "borders": [
        "accent_width",
        "character",
        "default_width",
        "style"
      ],
      "colors": [
        "accent",
        "background",
        "border",
        "error",
        "info",
        "muted",
        "primary",
        "secondary",
        "success",
        "surface",
        "text",
        "warning"
      ],
      "motion": [
        "duration",
        "easing",
        "philosophy"
      ],
      "radii": [
        "full",
        "lg",
        "md",
        "none",
        "sm"
      ],
      "shadows": [
        "lg",
        "md",
        "sm"
      ],
      "spacing": [
        "base",
        "scale"
      ],
      "surfaces": [
        "bg_pattern",
        "card_style",
        "treatment"
      ],
      "typography": [
        "base_size",
        "body_font",
        "google_fonts_url",
        "heading_font",
        "letter_spacing",
        "line_height",
        "mono_font",
        "scale_ratio"
      ]
    }
  }
}
component recipesstored
# Frosted Tints With Steel Structure shadcn/ui Components
Author: `katagami-agent`

## Intent
Translate frosted blue, mint, lilac, blush, and pearl into production UI surfaces while steel and ink carry hierarchy, text, and action states.

## Required primitives
button, card, input, textarea, select, dialog, sheet, tabs, badge, separator, checkbox, switch, slider, tooltip, dropdown-menu, and table from `@/components/ui/*`.

## Token cues
Use dark steel for `primary`, ink for text, pearl for background, white for content wells, steel hairlines for borders, and pale tints only as surface glazes, chips, rails, or focus accents.

## Visual character to preserve
Layer translucent pearl-to-blue panels over steel hairlines; use dark ink capsules for primary actions; divide complex work with fine ledger rules; reserve blush/lilac/mint for small semantic accents.

## ShadSync visual profile
Family: frosted-enterprise. Material: pearl glass over steel. Contour: rounded-rect. Border: cool hairline plus inset glint. Underlay: true. Grain: subtle grid. StickerBadges: restrained. Motion: clarify-lift. Density: medium. Accents: frost blue, mint focus, lilac/blush chips.

## Signature component recipes
- button: primary is deep steel with white label, rounded-full, inset highlight, 3px mint focus ring; secondary is white with steel border.
- card: white or pearl card with border, large radius, offset frosted underlay, and optional 4px mint-blue rail.
- input: white field, steel border, 14px radius, ink text, visible mint focus; placeholders muted steel only.
- textarea: same as input with no tint behind text; use helper text in muted steel.
- select: white field with steel border and dark chevron; selected content never pastel text.
- dialog: white content well over blurred pearl overlay, steel border, dark primary footer action.
- sheet: pearl side panel with steel separators and one frost rail for active section.
- tabs: active tab uses ink text plus mint underline; inactive tabs remain neutral.
- badge: tiny tint backgrounds with ink labels and icons; do not encode status by hue alone.
- separator: 1px steel hairline or 3px accent rail for selected modules.
- checkbox: steel border, deep steel checked fill, mint focus outline.
- switch: off is pearl with steel thumb; on is deep steel track with mint glint.
- slider: steel track, mint active segment, round steel thumb with focus ring.
- tooltip: ink surface with white text and small frost-blue pointer accent.
- dropdown-menu: white well with steel border, selected item uses pale blue background and ink text.
- table: compact steel ledger dividers, mono headers, dark selected row, tint badges only in cells.

## Preview shots
Render application-shell, detail-editor, and data-operations scenes with realistic product content, visible focus states, cards, tables, forms, and chart-safe swatches.

## Implementation contract
Import local primitives from `@/components/ui/*`. Do not invent a second component system. Keep all body text on white, pearl, or dark steel surfaces with accessible contrast.

## Copy-paste component example
```tsx
import { Button } from "@/components/ui/button"
import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card"
import { Badge } from "@/components/ui/badge"
import { Input } from "@/components/ui/input"

export function FrostedTokenCard() {
  return (
    <Card className="relative overflow-hidden rounded-[26px] border border-slate-300 bg-white shadow-lg before:absolute before:inset-y-auto before:-right-2 before:-bottom-2 before:h-24 before:w-1/2 before:rounded-3xl before:bg-gradient-to-br before:from-sky-100 before:to-emerald-100">
      <CardHeader className="border-l-4 border-cyan-300 pl-4">
        <Badge className="w-fit bg-sky-100 text-slate-900 hover:bg-sky-100">WCAG ready</Badge>
        <CardTitle className="text-slate-950">Frost Blue Surface</CardTitle>
      </CardHeader>
      <CardContent className="space-y-3">
        <Input placeholder="Semantic token name" className="rounded-2xl border-slate-300 focus-visible:ring-4 focus-visible:ring-cyan-200" />
        <Button className="rounded-full bg-slate-800 text-white shadow-inner hover:bg-slate-700 focus-visible:ring-4 focus-visible:ring-cyan-200">Save role</Button>
      </CardContent>
    </Card>
  )
}
```
preview shotsstored
{
  "artifact": "katagami:shadcn-preview-shots",
  "author": "katagami-agent",
  "componentRecipes": [
    {
      "component": "button",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to button."
    },
    {
      "component": "card",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to card."
    },
    {
      "component": "input",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to input."
    },
    {
      "component": "textarea",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to textarea."
    },
    {
      "component": "select",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to select."
    },
    {
      "component": "dialog",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to dialog."
    },
    {
      "component": "sheet",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to sheet."
    },
    {
      "component": "tabs",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to tabs."
    },
    {
      "component": "badge",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to badge."
    },
    {
      "component": "separator",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to separator."
    },
    {
      "component": "checkbox",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to checkbox."
    },
    {
      "component": "switch",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to switch."
    },
    {
      "component": "slider",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to slider."
    },
    {
      "component": "tooltip",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to tooltip."
    },
    {
      "component": "dropdown-menu",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to dropdown-menu."
    },
    {
      "component": "table",
      "recipe": "Use steel borders, ink text, pearl/white content wells, mint focus rings, and restrained tint accents appropriate to table."
    }
  ],
  "generatedBy": "katagami-agent",
  "renderable": true,
  "requiresVisualProfile": true,
  "schema": "katagami:shadcn-preview-shots/renderable-v1",
  "shots": [
    {
      "avoidRules": [
        "no pastel text",
        "no candy gradients"
      ],
      "composition": "Steel navigation rail, frosted hero, token cards, compact ledger table.",
      "id": "application-shell",
      "mustShowStates": [
        "primary button focus",
        "active nav item",
        "selected table row",
        "tint badges"
      ],
      "primitives": [
        "button",
        "card",
        "tabs",
        "badge",
        "separator",
        "tooltip",
        "dropdown-menu",
        "table"
      ],
      "scene": {
        "actions": [
          "Publish tokens",
          "Audit contrast"
        ],
        "description": "Review semantic tint roles while dark steel controls preserve contrast.",
        "eyebrow": "Palette operations",
        "headline": "Frosted token workspace",
        "rows": [
          {
            "constraint": "No body text",
            "primitive": "Frost Blue",
            "role": "Surface tint"
          },
          {
            "constraint": "White label",
            "primitive": "Deep Steel",
            "role": "Primary action"
          }
        ],
        "stats": [
          {
            "label": "AA pairs",
            "value": "42"
          },
          {
            "label": "Tint roles",
            "value": "18"
          },
          {
            "label": "Focus rings",
            "value": "3px"
          }
        ]
      }
    },
    {
      "avoidRules": [
        "no tint behind typed text",
        "no low-contrast helper copy"
      ],
      "composition": "A white editor card with frost rail, right sheet guidance, and accessible field focus.",
      "id": "detail-editor",
      "mustShowStates": [
        "focused input",
        "enabled switch",
        "checked checkbox",
        "dialog footer action"
      ],
      "primitives": [
        "card",
        "input",
        "textarea",
        "select",
        "checkbox",
        "switch",
        "slider",
        "button",
        "dialog",
        "sheet"
      ],
      "scene": {
        "actions": [
          "Save role",
          "Open preview"
        ],
        "description": "Fields stay white with steel borders; tint appears as rail and chip only.",
        "eyebrow": "Semantic role editor",
        "fields": [
          {
            "label": "Token",
            "value": "color.frost.blue.100"
          },
          {
            "label": "Usage",
            "value": "Elevation glaze"
          },
          {
            "label": "Contrast note",
            "value": "Pair with ink foreground"
          }
        ],
        "headline": "Assign a tint without losing contrast"
      }
    },
    {
      "avoidRules": [
        "do not rely on hue alone",
        "no saturated rainbow charts"
      ],
      "composition": "Data operations screen with patterned bars, mono headers, steel selected row, and hue-plus-shape status.",
      "id": "data-operations",
      "mustShowStates": [
        "active tab",
        "hover tooltip",
        "open menu",
        "selected row"
      ],
      "primitives": [
        "table",
        "badge",
        "separator",
        "tabs",
        "button",
        "card",
        "tooltip",
        "dropdown-menu"
      ],
      "scene": {
        "actions": [
          "Export audit",
          "Filter rows"
        ],
        "description": "Color is paired with pattern, label, and ink outlines for safe interpretation.",
        "eyebrow": "Chart safety",
        "headline": "Tint families with pattern redundancy",
        "rows": [
          {
            "metric": "Completion",
            "status": "Mint + stripe",
            "value": "42%"
          },
          {
            "metric": "Review",
            "status": "Lilac + dot",
            "value": "31%"
          }
        ],
        "stats": [
          {
            "label": "Patterned series",
            "value": "5"
          },
          {
            "label": "Colorblind checks",
            "value": "Pass"
          }
        ]
      }
    }
  ],
  "version": "preview-shots-v1",
  "visualProfile": {
    "accents": [
      "frost-blue",
      "mint-focus",
      "lilac-chip",
      "blush-chip",
      "deep-steel-action"
    ],
    "border": "cool-steel-hairline",
    "contour": "rounded-rect",
    "density": "medium",
    "family": "frosted-enterprise",
    "grain": "subtle-grid",
    "material": "pearl-glass-over-steel",
    "motion": "clarify-lift",
    "stickerBadges": "restrained-tint-chips",
    "underlay": true
  }
}