back to gallery
design language·glassmorphism-frost

Glassmorphism Frost

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
Glassmorphism Frost turns interface chrome into layered frozen panes: translucent planes, cool spectral rims, and luminous depth cues that feel carved from winter air rather than solid material. It is not soft candy glass; it is crisp, quiet, and slightly atmospheric, balancing translucency with precise information legibility.
values
Layer information through translucent depth instead of opaque containmentUse cool light, blur, and edge highlights to suggest frozen materialityPreserve precision and readability inside decorative surfacesMake interaction feel weightless but controlled, like sliding over polished ice
anti-values
×Milky blur without hierarchy×Warm playful gradients that undermine the frost mood×Heavy borders or skeuomorphic bevels×Overcrowding panes until transparency loses meaning
tokens
colors12 items
primary
#A7D8FF
secondary
#D7E8FF
accent
#7AF0FF
background
#0A1020
surface
#1F2A44
text
#F5FBFF
muted
#A9B8D1
border
#E6F2FF
error
#FF7A94
success
#7DFFBE
warning
#FFD36E
info
#7FDBFF
typography8 items
heading font
Sora
body font
Manrope
mono font
IBM Plex Mono
base size
16px
scale ratio
1.2
line height
1.5
letter spacing
-0.02em
google fonts url
https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500&family=Manrope:wght@400;500;600;700;800&family=Sora:wght@400;500;600;700;800&display=swap
spacing2 items
base
8px
scale
4px, 8px, 12px, 16px, 24px, 32px, 48px, 64px
radii5 items
none
0px
sm
12px
md
20px
lg
28px
full
999px
shadows3 items
sm
0 10px 30px rgba(1,10,30,0.22)
md
0 20px 60px rgba(1,10,30,0.34)
lg
0 32px 90px rgba(1,10,30,0.46)
surfaces3 items
treatment
glass
card style
floating translucent panes with inner frost highlights and soft ambient separation
bg pattern
noise
borders4 items
default width
1px
accent width
1px
style
solid
character
hairline luminous borders that catch light rather than define structure heavily
motion3 items
duration
180ms
easing
cubic-bezier(0.2, 0.8, 0.2, 1)
philosophy
deliberate
responsive2 items
breakpoints
1280, 1024, 768, 480
column progression
12 → 8 → 4 → 1
rules
composition
Compose the screen as stacked atmospheric layers: background glow field, suspended navigation rail, hero glass slab, then clustered utility panes. Major regions should feel like separate sheets of ice floating at different z-depths instead of a single flat page.
hierarchy
Hierarchy comes from opacity, blur density, and glow intensity before color. Primary actions use brighter spectral fill, secondary actions sit inside nearly clear panes, and metadata is tucked into dimmer frosted subpanels.
density
Moderate density with generous breathing room inside each pane. Complex data is allowed, but every dense area must be wrapped in a calmer translucent container so information feels suspended rather than cramped.
signature patterns
every major panel uses layered pseudo-elements: a luminous 1px highlight rim and a soft inner shadow wash to create frozen depthsection groups are held inside glass rails or shells with inset padding, making controls appear nested inside a translucent trackbackground composition uses oversized blurred gradient orbs that remain visible through surfacesinteractive chips, tabs, badges, and toggles all use capsule geometry with translucent fill and subtle backdrop blurtable rows and accordion items brighten with a cool white-blue sheen on hover instead of using flat solid hover colors
layout
grid
Desktop uses a 12-column fluid grid with a wide central content slab and two supporting pane columns; tablet collapses to 8 columns with navigation and utility panes wrapping beneath the hero; phone becomes a single translucent stack with full-width actions and horizontally scrollable dense data blocks.
breakpoints
1280+: hero + side panes in 12 columns; 1024px: content spans 8 columns with sidebar modules paired; 768px: header actions stack and content panes become vertical; 480px: one-column flow, full-width controls, modal inset reduced, table scroll container enabled.
whitespace

Use large outer margins and 24-32px internal pane padding so blur has room to breathe. Space between panes should feel like cold air gaps, not generic gutters.

guidance
do
  • Layer clear text blocks on the most opaque interior surfaces for readability
  • Use cool spectral glows sparingly to signal focus, status, and action priority
  • Round controls and micro-components into capsules to reinforce suspended softness
  • Let background light sources remain partially visible through panels
avoid
  • Do not combine frost glass with hard black strokes or industrial framing
  • Do not fill every container with the same opacity; depth must vary
  • Do not use muddy gray blur without edge highlights
  • Do not compress controls so tightly that the floating atmosphere disappears
katagami spec
# Glassmorphism Frost

## Philosophy

Glassmorphism Frost turns interface chrome into layered frozen panes: translucent planes, cool spectral rims, and luminous depth cues that feel carved from winter air rather than solid material. It is not soft candy glass; it is crisp, quiet, and slightly atmospheric, balancing translucency with precise information legibility.

### Values

- Layer information through translucent depth instead of opaque containment
- Use cool light, blur, and edge highlights to suggest frozen materiality
- Preserve precision and readability inside decorative surfaces
- Make interaction feel weightless but controlled, like sliding over polished ice

### Anti-Values

- Milky blur without hierarchy
- Warm playful gradients that undermine the frost mood
- Heavy borders or skeuomorphic bevels
- Overcrowding panes until transparency loses meaning

### Visual Character

- semi-transparent panels with 18-32px backdrop blur and milky white-to-ice-blue tinting
- 1px luminous top-left edge highlights paired with darker bottom-right inner shading to simulate chilled depth
- floating aurora gradient orbs behind content that glow through glass surfaces
- capsule badges, segmented tabs, and controls embedded inside inset glass rails rather than flat bars
- large rounded corners with layered shadow stacks that make cards appear suspended above a frosted field

## Tokens

### Colors

| Name | Value |
|------|-------|
| primary | `#A7D8FF` |
| secondary | `#D7E8FF` |
| accent | `#7AF0FF` |
| background | `#0A1020` |
| surface | `#1F2A44` |
| text | `#F5FBFF` |
| muted | `#A9B8D1` |
| border | `#E6F2FF` |
| error | `#FF7A94` |
| success | `#7DFFBE` |
| warning | `#FFD36E` |
| info | `#7FDBFF` |

### Typography

- **Heading Font**: Sora
- **Body Font**: Manrope
- **Mono Font**: IBM Plex Mono
- **Base Size**: 16px
- **Scale Ratio**: 1.2
- **Line Height**: 1.5
- **Letter Spacing**: -0.02em
- **Google Fonts Url**: https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500&family=Manrope:wght@400;500;600;700;800&family=Sora:wght@400;500;600;700;800&display=swap

### Spacing

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

### Radii

- **None**: 0px
- **Sm**: 12px
- **Md**: 20px
- **Lg**: 28px
- **Full**: 999px

### Shadows

- **Sm**: 0 10px 30px rgba(1,10,30,0.22)
- **Md**: 0 20px 60px rgba(1,10,30,0.34)
- **Lg**: 0 32px 90px rgba(1,10,30,0.46)

### Surfaces

- **Treatment**: glass
- **Card Style**: floating translucent panes with inner frost highlights and soft ambient separation
- **Bg Pattern**: noise

### Borders

- **Default Width**: 1px
- **Accent Width**: 1px
- **Style**: solid
- **Character**: hairline luminous borders that catch light rather than define structure heavily

### Motion

- **Duration**: 180ms
- **Easing**: cubic-bezier(0.2, 0.8, 0.2, 1)
- **Philosophy**: deliberate

### Responsive

- **Breakpoints**: [1280,1024,768,480]
- **Column Progression**: 12 → 8 → 4 → 1

## Rules

### Composition

Compose the screen as stacked atmospheric layers: background glow field, suspended navigation rail, hero glass slab, then clustered utility panes. Major regions should feel like separate sheets of ice floating at different z-depths instead of a single flat page.

### Hierarchy

Hierarchy comes from opacity, blur density, and glow intensity before color. Primary actions use brighter spectral fill, secondary actions sit inside nearly clear panes, and metadata is tucked into dimmer frosted subpanels.

### Density

Moderate density with generous breathing room inside each pane. Complex data is allowed, but every dense area must be wrapped in a calmer translucent container so information feels suspended rather than cramped.

### Signature Patterns

- every major panel uses layered pseudo-elements: a luminous 1px highlight rim and a soft inner shadow wash to create frozen depth
- section groups are held inside glass rails or shells with inset padding, making controls appear nested inside a translucent track
- background composition uses oversized blurred gradient orbs that remain visible through surfaces
- interactive chips, tabs, badges, and toggles all use capsule geometry with translucent fill and subtle backdrop blur
- table rows and accordion items brighten with a cool white-blue sheen on hover instead of using flat solid hover colors

## Layout

### Grid

Desktop uses a 12-column fluid grid with a wide central content slab and two supporting pane columns; tablet collapses to 8 columns with navigation and utility panes wrapping beneath the hero; phone becomes a single translucent stack with full-width actions and horizontally scrollable dense data blocks.

### Breakpoints

1280+: hero + side panes in 12 columns; 1024px: content spans 8 columns with sidebar modules paired; 768px: header actions stack and content panes become vertical; 480px: one-column flow, full-width controls, modal inset reduced, table scroll container enabled.

### Whitespace

Use large outer margins and 24-32px internal pane padding so blur has room to breathe. Space between panes should feel like cold air gaps, not generic gutters.

## Guidance

### Do

- Layer clear text blocks on the most opaque interior surfaces for readability
- Use cool spectral glows sparingly to signal focus, status, and action priority
- Round controls and micro-components into capsules to reinforce suspended softness
- Let background light sources remain partially visible through panels

### Don't

- Do not combine frost glass with hard black strokes or industrial framing
- Do not fill every container with the same opacity; depth must vary
- Do not use muddy gray blur without edge highlights
- Do not compress controls so tightly that the floating atmosphere disappears
DESIGN.md
---
version: "alpha"
name: "Glassmorphism Frost"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
  primary: "#A7D8FF"
  secondary: "#D7E8FF"
  accent: "#7AF0FF"
  background: "#0A1020"
  surface: "#1F2A44"
  text: "#F5FBFF"
  muted: "#A9B8D1"
  border: "#E6F2FF"
  error: "#FF7A94"
  success: "#7DFFBE"
  warning: "#FFD36E"
  info: "#7FDBFF"
typography:
  headline-lg:
    fontFamily: "Sora"
    fontSize: "1.953rem"
    fontWeight: 700
    lineHeight: 1.1
    letterSpacing: "-0.02em"
  headline-md:
    fontFamily: "Sora"
    fontSize: "1.563rem"
    fontWeight: 600
    lineHeight: 1.15
    letterSpacing: "-0.02em"
  body-md:
    fontFamily: "Manrope"
    fontSize: "16px"
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: "-0.02em"
  label-md:
    fontFamily: "IBM Plex Mono"
    fontSize: "0.75rem"
    fontWeight: 600
    lineHeight: 1
    letterSpacing: "0.08em"
rounded:
  none: "0px"
  sm: "12px"
  md: "20px"
  lg: "28px"
  full: "999px"
spacing:
  base: "8px"
  xs: "4px"
  sm: "8px"
  md: "12px"
  lg: "16px"
  xl: "24px"
  2xl: "32px"
  3xl: "48px"
  4xl: "64px"
components:
  color-reference-primary:
    backgroundColor: "{colors.primary}"
  color-reference-secondary:
    backgroundColor: "{colors.secondary}"
  color-reference-accent:
    backgroundColor: "{colors.accent}"
  color-reference-background:
    backgroundColor: "{colors.background}"
  color-reference-surface:
    backgroundColor: "{colors.surface}"
  color-reference-text:
    backgroundColor: "{colors.text}"
  color-reference-muted:
    backgroundColor: "{colors.muted}"
  color-reference-border:
    backgroundColor: "{colors.border}"
  color-reference-error:
    backgroundColor: "{colors.error}"
  color-reference-success:
    backgroundColor: "{colors.success}"
  color-reference-warning:
    backgroundColor: "{colors.warning}"
  color-reference-info:
    backgroundColor: "{colors.info}"
  button-primary:
    backgroundColor: "{colors.primary}"
    textColor: "#000000"
    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"
---

# Glassmorphism Frost

## Overview

Glassmorphism Frost turns interface chrome into layered frozen panes: translucent planes, cool spectral rims, and luminous depth cues that feel carved from winter air rather than solid material. It is not soft candy glass; it is crisp, quiet, and slightly atmospheric, balancing translucency with precise information legibility.

### Values

- Layer information through translucent depth instead of opaque containment
- Use cool light, blur, and edge highlights to suggest frozen materiality
- Preserve precision and readability inside decorative surfaces
- Make interaction feel weightless but controlled, like sliding over polished ice

### Anti-Values

- Milky blur without hierarchy
- Warm playful gradients that undermine the frost mood
- Heavy borders or skeuomorphic bevels
- Overcrowding panes until transparency loses meaning

### Visual Character

- semi-transparent panels with 18-32px backdrop blur and milky white-to-ice-blue tinting
- 1px luminous top-left edge highlights paired with darker bottom-right inner shading to simulate chilled depth
- floating aurora gradient orbs behind content that glow through glass surfaces
- capsule badges, segmented tabs, and controls embedded inside inset glass rails rather than flat bars
- large rounded corners with layered shadow stacks that make cards appear suspended above a frosted field

## Colors

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

| Token | Value |
|-------|-------|
| primary | `#A7D8FF` |
| secondary | `#D7E8FF` |
| accent | `#7AF0FF` |
| background | `#0A1020` |
| surface | `#1F2A44` |
| text | `#F5FBFF` |
| muted | `#A9B8D1` |
| border | `#E6F2FF` |
| error | `#FF7A94` |
| success | `#7DFFBE` |
| warning | `#FFD36E` |
| info | `#7FDBFF` |

## Typography

- **Headline-Lg**: Sora, 1.953rem, weight 700, line-height 1.1.
- **Headline-Md**: Sora, 1.563rem, weight 600, line-height 1.15.
- **Body-Md**: Manrope, 16px, weight 400, line-height 1.5.
- **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`

### Grid

Desktop uses a 12-column fluid grid with a wide central content slab and two supporting pane columns; tablet collapses to 8 columns with navigation and utility panes wrapping beneath the hero; phone becomes a single translucent stack with full-width actions and horizontally scrollable dense data blocks.

### Breakpoints

1280+: hero + side panes in 12 columns; 1024px: content spans 8 columns with sidebar modules paired; 768px: header actions stack and content panes become vertical; 480px: one-column flow, full-width controls, modal inset reduced, table scroll container enabled.

### Whitespace

Use large outer margins and 24-32px internal pane padding so blur has room to breathe. Space between panes should feel like cold air gaps, not generic gutters.

## Elevation & Depth

### Shadows

- **Sm**: 0 10px 30px rgba(1,10,30,0.22)
- **Md**: 0 20px 60px rgba(1,10,30,0.34)
- **Lg**: 0 32px 90px rgba(1,10,30,0.46)

## Shapes

### Rounded

- **None**: `0px`
- **Sm**: `12px`
- **Md**: `20px`
- **Lg**: `28px`
- **Full**: `999px`

### Surfaces

- **Treatment**: glass
- **Card Style**: floating translucent panes with inner frost highlights and soft ambient separation
- **Bg Pattern**: noise

### Borders

- **Default Width**: 1px
- **Accent Width**: 1px
- **Style**: solid
- **Character**: hairline luminous borders that catch light rather than define structure heavily

## Components

### Composition

Compose the screen as stacked atmospheric layers: background glow field, suspended navigation rail, hero glass slab, then clustered utility panes. Major regions should feel like separate sheets of ice floating at different z-depths instead of a single flat page.

### Hierarchy

Hierarchy comes from opacity, blur density, and glow intensity before color. Primary actions use brighter spectral fill, secondary actions sit inside nearly clear panes, and metadata is tucked into dimmer frosted subpanels.

### Density

Moderate density with generous breathing room inside each pane. Complex data is allowed, but every dense area must be wrapped in a calmer translucent container so information feels suspended rather than cramped.

### Signature Patterns

- every major panel uses layered pseudo-elements: a luminous 1px highlight rim and a soft inner shadow wash to create frozen depth
- section groups are held inside glass rails or shells with inset padding, making controls appear nested inside a translucent track
- background composition uses oversized blurred gradient orbs that remain visible through surfaces
- interactive chips, tabs, badges, and toggles all use capsule geometry with translucent fill and subtle backdrop blur
- table rows and accordion items brighten with a cool white-blue sheen on hover instead of using flat solid hover colors

## 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-019d9bb7-6228-7540-983c-cc20fd6d48e6/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 Layer clear text blocks on the most opaque interior surfaces for readability
- Do Use cool spectral glows sparingly to signal focus, status, and action priority
- Do Round controls and micro-components into capsules to reinforce suspended softness
- Do Let background light sources remain partially visible through panels
- Don't Do not combine frost glass with hard black strokes or industrial framing
- Don't Do not fill every container with the same opacity; depth must vary
- Don't Do not use muddy gray blur without edge highlights
- Don't Do not compress controls so tightly that the floating atmosphere disappears
shadcn/ui theme
```json
{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "glassmorphism-frost",
  "type": "registry:theme",
  "title": "Glassmorphism Frost shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#0A1020",
      "foreground": "#F5FBFF",
      "card": "#1F2A44",
      "card-foreground": "#F5FBFF",
      "popover": "#1F2A44",
      "popover-foreground": "#F5FBFF",
      "primary": "#A7D8FF",
      "primary-foreground": "#111111",
      "secondary": "#D7E8FF",
      "secondary-foreground": "#111111",
      "muted": "#A9B8D1",
      "muted-foreground": "#F5FBFF",
      "accent": "#7AF0FF",
      "accent-foreground": "#111111",
      "destructive": "#FF7A94",
      "border": "#E6F2FF",
      "input": "#E6F2FF",
      "ring": "#7AF0FF",
      "chart-1": "#A7D8FF",
      "chart-2": "#D7E8FF",
      "chart-3": "#7AF0FF",
      "chart-4": "#7DFFBE",
      "chart-5": "#FFD36E",
      "sidebar": "#1F2A44",
      "sidebar-foreground": "#F5FBFF",
      "sidebar-primary": "#A7D8FF",
      "sidebar-primary-foreground": "#111111",
      "sidebar-accent": "#7FDBFF",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#E6F2FF",
      "sidebar-ring": "#7AF0FF",
      "radius": "20px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#A7D8FF",
      "primary-foreground": "#111111",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#7AF0FF",
      "accent-foreground": "#111111",
      "destructive": "#FF7A94",
      "border": "#303642",
      "input": "#303642",
      "ring": "#7AF0FF",
      "chart-1": "#A7D8FF",
      "chart-2": "#D7E8FF",
      "chart-3": "#7AF0FF",
      "chart-4": "#7DFFBE",
      "chart-5": "#FFD36E",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#A7D8FF",
      "sidebar-primary-foreground": "#111111",
      "sidebar-accent": "#7AF0FF",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#303642",
      "sidebar-ring": "#7AF0FF",
      "radius": "20px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "en-019d9bb7-6228-7540-983c-cc20fd6d48e6",
    "slug": "glassmorphism-frost",
    "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": {
      "colors": [
        "accent",
        "background",
        "border",
        "error",
        "info",
        "muted",
        "primary",
        "secondary",
        "success",
        "surface",
        "text",
        "warning"
      ],
      "typography": [
        "base_size",
        "body_font",
        "google_fonts_url",
        "heading_font",
        "letter_spacing",
        "line_height",
        "mono_font",
        "scale_ratio"
      ],
      "spacing": [
        "base",
        "scale"
      ],
      "radii": [
        "full",
        "lg",
        "md",
        "none",
        "sm"
      ],
      "shadows": [
        "lg",
        "md",
        "sm"
      ],
      "surfaces": [
        "bg_pattern",
        "card_style",
        "treatment"
      ],
      "borders": [
        "accent_width",
        "character",
        "default_width",
        "style"
      ],
      "motion": [
        "duration",
        "easing",
        "philosophy"
      ],
      "responsive": [
        "breakpoints",
        "column_progression"
      ]
    }
  }
}
```
in the wild

embodiments

the full element showcase
embodiment · glassmorphism-frost
DESIGN.md

at a glance

Palette

Typography

headline-lgSora · 31px · 700

The quick brown fox jumps

headline-mdSora · 25px · 600

The quick brown fox jumps

body-mdManrope · 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

none0px
sm12px
md20px
lg28px
full999px
shadcn/ui

implementation kit

needs agent-authored kitcompatibility fallback
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: #0A1020;
  --foreground: #F5FBFF;
  --card: #1F2A44;
  --card-foreground: #F5FBFF;
  --popover: #1F2A44;
  --popover-foreground: #F5FBFF;
  --primary: #A7D8FF;
  --primary-foreground: #111111;
  --secondary: #D7E8FF;
  --secondary-foreground: #111111;
  --muted: #A9B8D1;
  --muted-foreground: #F5FBFF;
  --accent: #7AF0FF;
  --accent-foreground: #111111;
  --destructive: #FF7A94;
  --border: #E6F2FF;
  --input: #E6F2FF;
  --ring: #7AF0FF;
  --chart-1: #A7D8FF;
  --chart-2: #D7E8FF;
  --chart-3: #7AF0FF;
  --chart-4: #7DFFBE;
  --chart-5: #FFD36E;
  --sidebar: #1F2A44;
  --sidebar-foreground: #F5FBFF;
  --sidebar-primary: #A7D8FF;
  --sidebar-primary-foreground: #111111;
  --sidebar-accent: #7FDBFF;
  --sidebar-accent-foreground: #111111;
  --sidebar-border: #E6F2FF;
  --sidebar-ring: #7AF0FF;
  --radius: 20px;
}

.dark {
  --background: #0f1115;
  --foreground: #f8fafc;
  --card: #181b22;
  --card-foreground: #f8fafc;
  --popover: #181b22;
  --popover-foreground: #f8fafc;
  --primary: #A7D8FF;
  --primary-foreground: #111111;
  --secondary: #252a33;
  --secondary-foreground: #f8fafc;
  --muted: #252a33;
  --muted-foreground: #a1a1aa;
  --accent: #7AF0FF;
  --accent-foreground: #111111;
  --destructive: #FF7A94;
  --border: #303642;
  --input: #303642;
  --ring: #7AF0FF;
  --chart-1: #A7D8FF;
  --chart-2: #D7E8FF;
  --chart-3: #7AF0FF;
  --chart-4: #7DFFBE;
  --chart-5: #FFD36E;
  --sidebar: #181b22;
  --sidebar-foreground: #f8fafc;
  --sidebar-primary: #A7D8FF;
  --sidebar-primary-foreground: #111111;
  --sidebar-accent: #7AF0FF;
  --sidebar-accent-foreground: #111111;
  --sidebar-border: #303642;
  --sidebar-ring: #7AF0FF;
  --radius: 20px;
}
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 GlassmorphismFrostShadcnKit() {
  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">Glassmorphism Frost</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": "glassmorphism-frost",
  "type": "registry:theme",
  "title": "Glassmorphism Frost shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#0A1020",
      "foreground": "#F5FBFF",
      "card": "#1F2A44",
      "card-foreground": "#F5FBFF",
      "popover": "#1F2A44",
      "popover-foreground": "#F5FBFF",
      "primary": "#A7D8FF",
      "primary-foreground": "#111111",
      "secondary": "#D7E8FF",
      "secondary-foreground": "#111111",
      "muted": "#A9B8D1",
      "muted-foreground": "#F5FBFF",
      "accent": "#7AF0FF",
      "accent-foreground": "#111111",
      "destructive": "#FF7A94",
      "border": "#E6F2FF",
      "input": "#E6F2FF",
      "ring": "#7AF0FF",
      "chart-1": "#A7D8FF",
      "chart-2": "#D7E8FF",
      "chart-3": "#7AF0FF",
      "chart-4": "#7DFFBE",
      "chart-5": "#FFD36E",
      "sidebar": "#1F2A44",
      "sidebar-foreground": "#F5FBFF",
      "sidebar-primary": "#A7D8FF",
      "sidebar-primary-foreground": "#111111",
      "sidebar-accent": "#7FDBFF",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#E6F2FF",
      "sidebar-ring": "#7AF0FF",
      "radius": "20px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#A7D8FF",
      "primary-foreground": "#111111",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#7AF0FF",
      "accent-foreground": "#111111",
      "destructive": "#FF7A94",
      "border": "#303642",
      "input": "#303642",
      "ring": "#7AF0FF",
      "chart-1": "#A7D8FF",
      "chart-2": "#D7E8FF",
      "chart-3": "#7AF0FF",
      "chart-4": "#7DFFBE",
      "chart-5": "#FFD36E",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#A7D8FF",
      "sidebar-primary-foreground": "#111111",
      "sidebar-accent": "#7AF0FF",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#303642",
      "sidebar-ring": "#7AF0FF",
      "radius": "20px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "en-019d9bb7-6228-7540-983c-cc20fd6d48e6",
    "slug": "glassmorphism-frost",
    "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": {
      "colors": [
        "accent",
        "background",
        "border",
        "error",
        "info",
        "muted",
        "primary",
        "secondary",
        "success",
        "surface",
        "text",
        "warning"
      ],
      "typography": [
        "base_size",
        "body_font",
        "google_fonts_url",
        "heading_font",
        "letter_spacing",
        "line_height",
        "mono_font",
        "scale_ratio"
      ],
      "spacing": [
        "base",
        "scale"
      ],
      "radii": [
        "full",
        "lg",
        "md",
        "none",
        "sm"
      ],
      "shadows": [
        "lg",
        "md",
        "sm"
      ],
      "surfaces": [
        "bg_pattern",
        "card_style",
        "treatment"
      ],
      "borders": [
        "accent_width",
        "character",
        "default_width",
        "style"
      ],
      "motion": [
        "duration",
        "easing",
        "philosophy"
      ],
      "responsive": [
        "breakpoints",
        "column_progression"
      ]
    }
  }
}
component recipescompatibility fallback
# Glassmorphism Frost shadcn/ui Components

Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `en-019d9bb7-6228-7540-983c-cc20fd6d48e6`
Slug: `glassmorphism-frost`

## Intent

Glassmorphism Frost turns interface chrome into layered frozen panes: translucent planes, cool spectral rims, and luminous depth cues that feel carved from winter air rather than solid material. It is not soft candy glass; it is crisp, quiet, and slightly atmospheric, balancing translucency with precise information legibility.

## Required primitives

- button
- card
- input
- textarea
- select
- dialog
- sheet
- tabs
- badge
- separator
- checkbox
- switch
- slider
- tooltip
- dropdown-menu
- table

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

## Token cues

Colors:

{
  "primary": "#A7D8FF",
  "secondary": "#D7E8FF",
  "accent": "#7AF0FF",
  "background": "#0A1020",
  "surface": "#1F2A44",
  "text": "#F5FBFF",
  "muted": "#A9B8D1",
  "border": "#E6F2FF",
  "error": "#FF7A94",
  "success": "#7DFFBE",
  "warning": "#FFD36E",
  "info": "#7FDBFF"
}

Typography:

{
  "heading_font": "Sora",
  "body_font": "Manrope",
  "mono_font": "IBM Plex Mono",
  "base_size": "16px",
  "scale_ratio": "1.2",
  "line_height": "1.5",
  "letter_spacing": "-0.02em",
  "google_fonts_url": "https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500&family=Manrope:wght@400;500;600;700;800&family=Sora:wght@400;500;600;700;800&display=swap"
}

## Visual character to preserve

- semi-transparent panels with 18-32px backdrop blur and milky white-to-ice-blue tinting
- 1px luminous top-left edge highlights paired with darker bottom-right inner shading to simulate chilled depth
- floating aurora gradient orbs behind content that glow through glass surfaces
- capsule badges, segmented tabs, and controls embedded inside inset glass rails rather than flat bars
- large rounded corners with layered shadow stacks that make cards appear suspended above a frosted field

## ShadSync visual profile

{
  "family": "system",
  "material": "flat",
  "contour": "default",
  "border": "solid",
  "underlay": true,
  "grain": false,
  "stickerBadges": true,
  "motion": "still",
  "density": "balanced",
  "accents": [
    "primary",
    "accent",
    "secondary",
    "muted"
  ]
}

## Signature component recipes

### Button
Use `Button` for primary, secondary, outline, and ghost actions. Primary actions must expose the language's strongest contrast pair, while secondary and ghost actions should preserve the surface treatment instead of falling back to default neutral SaaS styling.

### Card
Use `Card`, `CardHeader`, `CardContent`, `CardFooter`, and `CardAction` as the main composition frame. Cards should demonstrate the language's surface, border, hierarchy, and density rules rather than appearing as generic rounded rectangles.

### Input and Textarea
Use `Input` and `Textarea` with visible focus rings, field labels, validation states, and the language's rhythm. Forms should show real product content, not placeholder-only controls.

### Select, Tabs, and Table
Use `Select`, `Tabs`, and `Table` to prove navigation, filtering, and dense data states. The table should show row rhythm, separators, hover/focus states, and an empty or status state when the language calls for it.

### Dialog and Sheet
Use `Dialog` for centered decisions and `Sheet` for contextual editing. Both should inherit the language's spacing, border, overlay, and motion rules.

## Preview shots

- `application-shell`: dashboard or workspace shell with navigation, cards, forms, and state badges.
- `detail-editor`: focused editing flow using input, textarea, select, switch/checkbox, dialog or sheet, and action buttons.
- `data-operations`: table-heavy operational view with tabs, dropdown menu affordances, badges, and destructive/empty states.
- Each preview shot must include a renderable `scene` payload with concrete headline, description, actions, and rows/fields/stats for the UI preview.

## Implementation contract

- Start from local `ui/src/components/ui` shadcn-style primitives; do not create a second component system.
- Apply `/katagami/shadcn/glassmorphism-frost/registry-theme.json` variables, then use these recipes for composition and state design.
- Preserve Katagami token names as source metadata; shadcn semantic names are only the export surface.
- Do: Layer clear text blocks on the most opaque interior surfaces for readability; Use cool spectral glows sparingly to signal focus, status, and action priority; Round controls and micro-components into capsules to reinforce suspended softness; Let background light sources remain partially visible through panels
- Do not: Do not combine frost glass with hard black strokes or industrial framing; Do not fill every container with the same opacity; depth must vary; Do not use muddy gray blur without edge highlights; Do not compress controls so tightly that the floating atmosphere disappears

## Copy-paste component example

This generated starter proves the import shape. Production Katagami agents should replace it with a language-specific product composition.

```tsx
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 GlassmorphismFrostShadcnKit() {
  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">Glassmorphism Frost</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>
  );
}
```

## Layout notes

{
  "grid": "Desktop uses a 12-column fluid grid with a wide central content slab and two supporting pane columns; tablet collapses to 8 columns with navigation and utility panes wrapping beneath the hero; phone becomes a single translucent stack with full-width actions and horizontally scrollable dense data blocks.",
  "breakpoints": "1280+: hero + side panes in 12 columns; 1024px: content spans 8 columns with sidebar modules paired; 768px: header actions stack and content panes become vertical; 480px: one-column flow, full-width controls, modal inset reduced, table scroll container enabled.",
  "whitespace": "Use large outer margins and 24-32px internal pane padding so blur has room to breathe. Space between panes should feel like cold air gaps, not generic gutters."
}
preview shotscompatibility fallback
{
  "artifact": "katagami:shadcn-preview-shots",
  "version": "preview-shots-v1",
  "generator": "katagami-ui-compatibility-projection",
  "generatedBy": "katagami-ui-projection",
  "requiresVisualProfile": true,
  "schema": "katagami:shadcn-preview-shots/renderable-v1",
  "renderable": true,
  "language": {
    "id": "en-019d9bb7-6228-7540-983c-cc20fd6d48e6",
    "name": "Glassmorphism Frost",
    "slug": "glassmorphism-frost"
  },
  "installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
  "primitives": [
    "button",
    "card",
    "input",
    "textarea",
    "select",
    "dialog",
    "sheet",
    "tabs",
    "badge",
    "separator",
    "checkbox",
    "switch",
    "slider",
    "tooltip",
    "dropdown-menu",
    "table"
  ],
  "identityNotes": [
    "semi-transparent panels with 18-32px backdrop blur and milky white-to-ice-blue tinting",
    "1px luminous top-left edge highlights paired with darker bottom-right inner shading to simulate chilled depth",
    "floating aurora gradient orbs behind content that glow through glass surfaces",
    "capsule badges, segmented tabs, and controls embedded inside inset glass rails rather than flat bars",
    "large rounded corners with layered shadow stacks that make cards appear suspended above a frosted field"
  ],
  "visualProfile": {
    "family": "system",
    "material": "flat",
    "contour": "default",
    "border": "solid",
    "underlay": true,
    "grain": false,
    "stickerBadges": true,
    "motion": "still",
    "density": "balanced",
    "accents": [
      "primary",
      "accent",
      "secondary",
      "muted"
    ]
  },
  "shots": [
    {
      "id": "application-shell",
      "title": "Application shell",
      "viewport": "desktop",
      "primitives": [
        "button",
        "card",
        "input",
        "select",
        "tabs",
        "badge",
        "separator",
        "table"
      ],
      "composition": "A real product workspace with navigation, summary cards, filtering controls, and one dense content region.",
      "mustShow": [
        "primary and secondary actions",
        "card hierarchy",
        "filterable state",
        "table or list density"
      ],
      "avoid": [
        "component inventory walls",
        "placeholder-only content",
        "generic rounded SaaS chrome"
      ],
      "scene": {
        "eyebrow": "workspace spread",
        "headline": "Glassmorphism Frost launch room",
        "description": "A product team workspace where navigation, filters, metrics, and dense rows carry the language's visible structure.",
        "primaryAction": "Apply theme",
        "secondaryAction": "Review states",
        "stats": [
          {
            "label": "components",
            "value": "16",
            "tone": "accent"
          },
          {
            "label": "states",
            "value": "ready"
          },
          {
            "label": "density",
            "value": "balanced",
            "tone": "warning"
          }
        ],
        "rows": [
          {
            "label": "Primary flow",
            "value": "mapped",
            "status": "active"
          },
          {
            "label": "Token coverage",
            "value": "semantic",
            "status": "synced"
          },
          {
            "label": "Responsive proof",
            "value": "queued",
            "status": "review"
          }
        ],
        "statuses": [
          "Active",
          "Synced",
          "Draft"
        ]
      }
    },
    {
      "id": "detail-editor",
      "title": "Detail editor",
      "viewport": "tablet",
      "primitives": [
        "button",
        "card",
        "input",
        "textarea",
        "select",
        "checkbox",
        "switch",
        "slider",
        "dialog",
        "sheet"
      ],
      "composition": "A focused editing flow with form fields, validation, confirmation, and a contextual side panel.",
      "mustShow": [
        "focus ring",
        "error or destructive state",
        "dialog or sheet treatment",
        "written guidance content"
      ],
      "avoid": [
        "unstyled browser controls",
        "floating cards inside cards",
        "missing labels"
      ],
      "scene": {
        "eyebrow": "editing flow",
        "headline": "Language recipe editor",
        "description": "A focused form proving labels, validation, toggles, panel rhythm, and action hierarchy.",
        "primaryAction": "Save recipe",
        "secondaryAction": "Open sheet",
        "fields": [
          {
            "label": "Component family",
            "value": "Narrative cards"
          },
          {
            "label": "State treatment",
            "value": "Visible focus + validation"
          },
          {
            "label": "Motion",
            "value": "Small lift, no opacity-only fade"
          }
        ],
        "statuses": [
          "Focus",
          "Invalid",
          "Confirmed"
        ]
      }
    },
    {
      "id": "data-operations",
      "title": "Data operations",
      "viewport": "mobile",
      "primitives": [
        "button",
        "tabs",
        "badge",
        "dropdown-menu",
        "table",
        "tooltip",
        "separator"
      ],
      "composition": "A compact operational view proving row rhythm, stacked actions, menu states, badges, and empty/destructive states.",
      "mustShow": [
        "responsive reflow",
        "dense row styling",
        "menu affordance",
        "status badge system"
      ],
      "avoid": [
        "desktop-only tables",
        "text overflow",
        "default shadcn spacing without Katagami character"
      ],
      "scene": {
        "eyebrow": "operations",
        "headline": "Compact review queue",
        "description": "A narrow viewport scene with rows, menus, tooltips, badges, and destructive affordances.",
        "primaryAction": "Resolve",
        "secondaryAction": "Filter",
        "rows": [
          {
            "label": "Button hierarchy",
            "value": "approved",
            "status": "ok"
          },
          {
            "label": "Table rhythm",
            "value": "needs pass",
            "status": "watch"
          },
          {
            "label": "Empty state",
            "value": "designed",
            "status": "done"
          }
        ],
        "statuses": [
          "Queued",
          "Blocked",
          "Done"
        ]
      }
    }
  ],
  "componentRecipes": [
    {
      "primitive": "button",
      "intent": "Prove action hierarchy, focus, disabled, and destructive states."
    },
    {
      "primitive": "card",
      "intent": "Carry the language surface, border, elevation, and density rules."
    },
    {
      "primitive": "input",
      "intent": "Show labels, focus rings, validation, and spacing rhythm."
    },
    {
      "primitive": "textarea",
      "intent": "Show longer guidance, validation copy, and writing density."
    },
    {
      "primitive": "select",
      "intent": "Show filtering, selection contrast, and menu trigger styling."
    },
    {
      "primitive": "dialog",
      "intent": "Show centered decision states and overlay treatment."
    },
    {
      "primitive": "sheet",
      "intent": "Show contextual side panels and responsive editing."
    },
    {
      "primitive": "tabs",
      "intent": "Show navigational structure and active/inactive contrast."
    },
    {
      "primitive": "badge",
      "intent": "Show compact status vocabulary and semantic colors."
    },
    {
      "primitive": "separator",
      "intent": "Show section rhythm without generic gray dividers."
    },
    {
      "primitive": "checkbox",
      "intent": "Show binary selection with visible focus and checked states."
    },
    {
      "primitive": "switch",
      "intent": "Show settings toggles and on/off contrast."
    },
    {
      "primitive": "slider",
      "intent": "Show numeric adjustment with track/thumb styling."
    },
    {
      "primitive": "tooltip",
      "intent": "Show concise explanation styling above compact controls."
    },
    {
      "primitive": "dropdown-menu",
      "intent": "Show action menus, destructive items, and grouped choices."
    },
    {
      "primitive": "table",
      "intent": "Show dense operational data, separators, row states, and responsive behavior."
    }
  ],
  "qualityRules": {
    "do": [
      "Layer clear text blocks on the most opaque interior surfaces for readability",
      "Use cool spectral glows sparingly to signal focus, status, and action priority",
      "Round controls and micro-components into capsules to reinforce suspended softness",
      "Let background light sources remain partially visible through panels"
    ],
    "dont": [
      "Do not combine frost glass with hard black strokes or industrial framing",
      "Do not fill every container with the same opacity; depth must vary",
      "Do not use muddy gray blur without edge highlights",
      "Do not compress controls so tightly that the floating atmosphere disappears"
    ]
  }
}
related

More like this