back to gallery
design language·luminous-ai-dark-glass

Luminous AI Dark Glass

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 dark, glass-forward product language for generative AI workspaces where grounded graphite hierarchy carries the interface and restrained cyan-violet lumens signal intelligence, focus, and synthetic activity without turning the application into a neon poster.
values
Grounded dark-mode readability before spectacleGlass surfaces used as navigational depth, not decorative blur everywhereSynthetic accents reserved for AI states, focus, and primary decisionsSemantic color tokens remain accessible and distinguishable from brand glowProduct-screen realism with dense but calm operational panels
anti-values
×Full-canvas cyberpunk neon gradients that exhaust the eye×Low-contrast translucent text floating over busy backgrounds×Generic AI sparkle decoration without semantic role×Equal-card dashboard monotony or marketing-landing-page composition
tokens
borders10 items
accent width
2px
active
1px solid rgba(40, 215, 255, 0.62)
character
crisp glass seams with brighter top-left catchlights and restrained cyan focus outlines
default width
1px
glow
0 0 0 1px rgba(40,215,255,.35), 0 18px 60px rgba(40,215,255,.12)
hairline
1px solid rgba(148, 199, 255, 0.22)
radius badge
999px
radius card
24px
radius control
14px
style
solid with translucent blue-gray defaults and gradient border masks on active AI modules
colors18 items
accent
#19F2B8
accent_foreground
#031914
background
#05070B
border
#263545
destructive
#FF4D6D
error
#FF5C8A
foreground
#F6FAFF
info
#71B7FF
muted
#8A9AAD
muted_foreground
#9CADBF
primary
#58E6FF
primary_foreground
#021018
secondary
#9B6CFF
secondary_foreground
#F7F2FF
success
#23E0A2
surface
#101722
text
#EDF7FF
warning
#FFD166
motion6 items
ambient
slow glass shimmer under 8s, disabled for reduced motion
duration
180ms
easing
cubic-bezier(0.2, 0.8, 0.2, 1)
focus
120ms outline expansion using #28D7FF
hover
180ms ease-out lift with cyan edge glow
philosophy
small opacity, glow, and translate changes imply live intelligence; avoid sweeping animated gradients or distracting shimmer loops
radii5 items
full
9999px
lg
28px
md
16px
none
0
sm
10px
shadows3 items
lg
0 32px 110px rgba(0,0,0,0.58), 0 0 72px rgba(88,230,255,0.16)
md
0 18px 60px rgba(0,0,0,0.42), 0 0 36px rgba(155,108,255,0.10)
sm
0 8px 24px rgba(0,0,0,0.32), 0 0 18px rgba(88,230,255,0.06)
spacing2 items
base
8px
scale
4, 8, 12, 16, 24, 32, 48, 64
surfaces7 items
base
#05070B
bg pattern
soft radial cyan and violet lumens, low-opacity grid arcs, and small noise texture kept under 8 percent opacity
card style
rgba(12,18,28,0.72) cards with inset top highlight, 1px blue-gray border, and clipped cyan/violet corner glows
elevated
rgba(16, 24, 40, 0.78)
glass panel
rgba(10, 16, 28, 0.68) with backdrop-filter blur(22px)
neon wash
radial-gradient(circle at top left, rgba(40,215,255,.26), transparent 42%), radial-gradient(circle at bottom right, rgba(139,92,246,.22), transparent 48%)
treatment
translucent graphite glass over a near-black luminous mesh, using blur only on elevated surfaces
typography8 items
base size
16px
body font
Inter
google fonts url
https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500;700&display=swap
heading font
Inter
letter spacing
-0.015em
line height
1.55
mono font
JetBrains Mono
scale ratio
1.22
rules
composition
Build a credible AI product workspace: navigation rail, prompt/generation canvas, model inspector, evidence queue, and telemetry strip. Use asymmetrical panel spans and depth layers so glass communicates state and grouping.
density

Medium-high operational density with compact controls, but each glass cluster needs enough breathing room and clear label/value pairs to prevent dark-mode mud.

hierarchy
Use graphite value steps for most hierarchy, then reserve luminous cyan for primary action/focus and violet for model intelligence or synthesis state. Text contrast must remain high on every translucent layer.
signature patterns
Gradient-masked active borders: active panes show a 2px cyan-violet border sweep while inactive panes keep quiet blue-gray seams.Lumen wells behind important panels: soft radial glows sit behind glass cards and are clipped by parent containers to suggest computational depth.AI state chips pair a tiny pulsing diode with monospace model metadata and never use sparkles as standalone decoration.Telemetry baselines use JetBrains Mono tabular numerals, hairline separators, and small cyan ticks aligned to a bottom rail.
layout
breakpoints

mobile <= 640px, tablet 641px-1024px, desktop >= 1025px

grid
Desktop uses a 12-column application shell with a 72px command rail, 7-column central canvas, 4-column inspector, and a full-width telemetry baseline; tablet collapses to two columns and mobile stacks rail actions as a top strip.
whitespace

Use compact internal spacing for controls, but preserve 24-32px gutters between major glass strata and 12-16px padding around dense telemetry rows.

guidance
do
  • Anchor every screen in near-black graphite neutrals before adding glow.
  • Use translucent glass to separate layers of AI work such as prompt, output, evidence, and model state.
  • Reserve cyan/violet highlights for active, focused, or generative states and keep semantic success/warning/error colors distinct.
  • Pair expressive surfaces with clear text hierarchy, tabular metrics, and visible focus rings.
avoid
  • Do not flood the whole interface with rainbow neon or cyberpunk poster gradients.
  • Do not put low-contrast gray text on blurred glass over bright glows.
  • Do not use sparkle icons as a substitute for meaningful AI state tokens.
  • Do not build generic equal marketing cards; the language should feel like a real AI operations product.
katagami spec
# Luminous AI Dark Glass

## Philosophy

A dark, glass-forward product language for generative AI workspaces where grounded graphite hierarchy carries the interface and restrained cyan-violet lumens signal intelligence, focus, and synthetic activity without turning the application into a neon poster.

### Values

- Grounded dark-mode readability before spectacle
- Glass surfaces used as navigational depth, not decorative blur everywhere
- Synthetic accents reserved for AI states, focus, and primary decisions
- Semantic color tokens remain accessible and distinguishable from brand glow
- Product-screen realism with dense but calm operational panels

### Anti-Values

- Full-canvas cyberpunk neon gradients that exhaust the eye
- Low-contrast translucent text floating over busy backgrounds
- Generic AI sparkle decoration without semantic role
- Equal-card dashboard monotony or marketing-landing-page composition

### Visual Character

- Near-black radial-gradient body background with graphite panels, faint cyan/violet underglow islands, and no pure black page voids.
- Layered glass cards use rgba graphite fills, backdrop-filter blur, 1px translucent borders, and inset highlight strokes to reveal stacked AI surfaces.
- Cyan-to-violet lumen rails, tiny status diodes, and focused ring shadows appear only on primary controls, active tabs, model-state chips, and live panels.
- Dense product layout combines a left command rail, central generation canvas, side inspection stack, and bottom telemetry strip with varied spans rather than equal tiles.
- Readable Inter text hierarchy is paired with JetBrains Mono telemetry, tabular numerals, and uppercase micro-labels with increased tracking.

## Tokens

### Borders

- **Accent Width**: 2px
- **Active**: 1px solid rgba(40, 215, 255, 0.62)
- **Character**: crisp glass seams with brighter top-left catchlights and restrained cyan focus outlines
- **Default Width**: 1px
- **Glow**: 0 0 0 1px rgba(40,215,255,.35), 0 18px 60px rgba(40,215,255,.12)
- **Hairline**: 1px solid rgba(148, 199, 255, 0.22)
- **Radius Badge**: 999px
- **Radius Card**: 24px
- **Radius Control**: 14px
- **Style**: solid with translucent blue-gray defaults and gradient border masks on active AI modules

### Colors

| Name | Value |
|------|-------|
| accent | `#19F2B8` |
| accent_foreground | `#031914` |
| background | `#05070B` |
| border | `#263545` |
| destructive | `#FF4D6D` |
| error | `#FF5C8A` |
| foreground | `#F6FAFF` |
| info | `#71B7FF` |
| muted | `#8A9AAD` |
| muted_foreground | `#9CADBF` |
| primary | `#58E6FF` |
| primary_foreground | `#021018` |
| secondary | `#9B6CFF` |
| secondary_foreground | `#F7F2FF` |
| success | `#23E0A2` |
| surface | `#101722` |
| text | `#EDF7FF` |
| warning | `#FFD166` |

### Motion

- **Ambient**: slow glass shimmer under 8s, disabled for reduced motion
- **Duration**: 180ms
- **Easing**: cubic-bezier(0.2, 0.8, 0.2, 1)
- **Focus**: 120ms outline expansion using #28D7FF
- **Hover**: 180ms ease-out lift with cyan edge glow
- **Philosophy**: small opacity, glow, and translate changes imply live intelligence; avoid sweeping animated gradients or distracting shimmer loops

### Radii

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

### Shadows

- **Lg**: 0 32px 110px rgba(0,0,0,0.58), 0 0 72px rgba(88,230,255,0.16)
- **Md**: 0 18px 60px rgba(0,0,0,0.42), 0 0 36px rgba(155,108,255,0.10)
- **Sm**: 0 8px 24px rgba(0,0,0,0.32), 0 0 18px rgba(88,230,255,0.06)

### Spacing

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

### Surfaces

- **Base**: #05070B
- **Bg Pattern**: soft radial cyan and violet lumens, low-opacity grid arcs, and small noise texture kept under 8 percent opacity
- **Card Style**: rgba(12,18,28,0.72) cards with inset top highlight, 1px blue-gray border, and clipped cyan/violet corner glows
- **Elevated**: rgba(16, 24, 40, 0.78)
- **Glass Panel**: rgba(10, 16, 28, 0.68) with backdrop-filter blur(22px)
- **Neon Wash**: radial-gradient(circle at top left, rgba(40,215,255,.26), transparent 42%), radial-gradient(circle at bottom right, rgba(139,92,246,.22), transparent 48%)
- **Treatment**: translucent graphite glass over a near-black luminous mesh, using blur only on elevated surfaces

### Typography

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

## Rules

### Composition

Build a credible AI product workspace: navigation rail, prompt/generation canvas, model inspector, evidence queue, and telemetry strip. Use asymmetrical panel spans and depth layers so glass communicates state and grouping.

### Density

Medium-high operational density with compact controls, but each glass cluster needs enough breathing room and clear label/value pairs to prevent dark-mode mud.

### Hierarchy

Use graphite value steps for most hierarchy, then reserve luminous cyan for primary action/focus and violet for model intelligence or synthesis state. Text contrast must remain high on every translucent layer.

### Signature Patterns

- Gradient-masked active borders: active panes show a 2px cyan-violet border sweep while inactive panes keep quiet blue-gray seams.
- Lumen wells behind important panels: soft radial glows sit behind glass cards and are clipped by parent containers to suggest computational depth.
- AI state chips pair a tiny pulsing diode with monospace model metadata and never use sparkles as standalone decoration.
- Telemetry baselines use JetBrains Mono tabular numerals, hairline separators, and small cyan ticks aligned to a bottom rail.

## Layout

### Breakpoints

mobile <= 640px, tablet 641px-1024px, desktop >= 1025px

### Grid

Desktop uses a 12-column application shell with a 72px command rail, 7-column central canvas, 4-column inspector, and a full-width telemetry baseline; tablet collapses to two columns and mobile stacks rail actions as a top strip.

### Whitespace

Use compact internal spacing for controls, but preserve 24-32px gutters between major glass strata and 12-16px padding around dense telemetry rows.

## Guidance

### Do

- Anchor every screen in near-black graphite neutrals before adding glow.
- Use translucent glass to separate layers of AI work such as prompt, output, evidence, and model state.
- Reserve cyan/violet highlights for active, focused, or generative states and keep semantic success/warning/error colors distinct.
- Pair expressive surfaces with clear text hierarchy, tabular metrics, and visible focus rings.

### Don't

- Do not flood the whole interface with rainbow neon or cyberpunk poster gradients.
- Do not put low-contrast gray text on blurred glass over bright glows.
- Do not use sparkle icons as a substitute for meaningful AI state tokens.
- Do not build generic equal marketing cards; the language should feel like a real AI operations product.

### Accessibility

Maintain WCAG AA contrast for all body text; never place muted labels below #8A9AAD on glass; primary cyan is for focus/action and must not be the only indicator of state.

### Usage Context

Best for generative AI studios, model observability tools, agent orchestration consoles, creative copilots, dark analytics products, and premium productivity surfaces that need futuristic identity without losing usability.
DESIGN.md
---
version: "alpha"
name: "Luminous AI Dark Glass"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
  accent: "#19F2B8"
  accent_foreground: "#031914"
  background: "#05070B"
  border: "#263545"
  destructive: "#FF4D6D"
  error: "#FF5C8A"
  foreground: "#F6FAFF"
  info: "#71B7FF"
  muted: "#8A9AAD"
  muted_foreground: "#9CADBF"
  primary: "#58E6FF"
  primary_foreground: "#021018"
  secondary: "#9B6CFF"
  secondary_foreground: "#F7F2FF"
  success: "#23E0A2"
  surface: "#101722"
  text: "#EDF7FF"
  warning: "#FFD166"
typography:
  headline-lg:
    fontFamily: "Inter"
    fontSize: "1.816rem"
    fontWeight: 700
    lineHeight: 1.1
    letterSpacing: "-0.015em"
  headline-md:
    fontFamily: "Inter"
    fontSize: "1.488rem"
    fontWeight: 600
    lineHeight: 1.15
    letterSpacing: "-0.015em"
  body-md:
    fontFamily: "Inter"
    fontSize: "16px"
    fontWeight: 400
    lineHeight: 1.55
    letterSpacing: "-0.015em"
  label-md:
    fontFamily: "JetBrains Mono"
    fontSize: "0.75rem"
    fontWeight: 600
    lineHeight: 1
    letterSpacing: "0.08em"
rounded:
  full: "9999px"
  lg: "28px"
  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-accent_foreground:
    backgroundColor: "{colors.accent_foreground}"
  color-reference-background:
    backgroundColor: "{colors.background}"
  color-reference-border:
    backgroundColor: "{colors.border}"
  color-reference-destructive:
    backgroundColor: "{colors.destructive}"
  color-reference-error:
    backgroundColor: "{colors.error}"
  color-reference-foreground:
    backgroundColor: "{colors.foreground}"
  color-reference-info:
    backgroundColor: "{colors.info}"
  color-reference-muted:
    backgroundColor: "{colors.muted}"
  color-reference-muted_foreground:
    backgroundColor: "{colors.muted_foreground}"
  color-reference-primary:
    backgroundColor: "{colors.primary}"
  color-reference-primary_foreground:
    backgroundColor: "{colors.primary_foreground}"
  color-reference-secondary:
    backgroundColor: "{colors.secondary}"
  color-reference-secondary_foreground:
    backgroundColor: "{colors.secondary_foreground}"
  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: "#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"
---

# Luminous AI Dark Glass

## Overview

A dark, glass-forward product language for generative AI workspaces where grounded graphite hierarchy carries the interface and restrained cyan-violet lumens signal intelligence, focus, and synthetic activity without turning the application into a neon poster.

### Values

- Grounded dark-mode readability before spectacle
- Glass surfaces used as navigational depth, not decorative blur everywhere
- Synthetic accents reserved for AI states, focus, and primary decisions
- Semantic color tokens remain accessible and distinguishable from brand glow
- Product-screen realism with dense but calm operational panels

### Anti-Values

- Full-canvas cyberpunk neon gradients that exhaust the eye
- Low-contrast translucent text floating over busy backgrounds
- Generic AI sparkle decoration without semantic role
- Equal-card dashboard monotony or marketing-landing-page composition

### Visual Character

- Near-black radial-gradient body background with graphite panels, faint cyan/violet underglow islands, and no pure black page voids.
- Layered glass cards use rgba graphite fills, backdrop-filter blur, 1px translucent borders, and inset highlight strokes to reveal stacked AI surfaces.
- Cyan-to-violet lumen rails, tiny status diodes, and focused ring shadows appear only on primary controls, active tabs, model-state chips, and live panels.
- Dense product layout combines a left command rail, central generation canvas, side inspection stack, and bottom telemetry strip with varied spans rather than equal tiles.
- Readable Inter text hierarchy is paired with JetBrains Mono telemetry, tabular numerals, and uppercase micro-labels with increased tracking.

## 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 | `#19F2B8` |
| accent_foreground | `#031914` |
| background | `#05070B` |
| border | `#263545` |
| destructive | `#FF4D6D` |
| error | `#FF5C8A` |
| foreground | `#F6FAFF` |
| info | `#71B7FF` |
| muted | `#8A9AAD` |
| muted_foreground | `#9CADBF` |
| primary | `#58E6FF` |
| primary_foreground | `#021018` |
| secondary | `#9B6CFF` |
| secondary_foreground | `#F7F2FF` |
| success | `#23E0A2` |
| surface | `#101722` |
| text | `#EDF7FF` |
| warning | `#FFD166` |

## Typography

- **Headline-Lg**: Inter, 1.816rem, weight 700, line-height 1.1.
- **Headline-Md**: Inter, 1.488rem, weight 600, line-height 1.15.
- **Body-Md**: Inter, 16px, weight 400, line-height 1.55.
- **Label-Md**: JetBrains 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 <= 640px, tablet 641px-1024px, desktop >= 1025px

### Grid

Desktop uses a 12-column application shell with a 72px command rail, 7-column central canvas, 4-column inspector, and a full-width telemetry baseline; tablet collapses to two columns and mobile stacks rail actions as a top strip.

### Whitespace

Use compact internal spacing for controls, but preserve 24-32px gutters between major glass strata and 12-16px padding around dense telemetry rows.

## Elevation & Depth

### Shadows

- **Lg**: 0 32px 110px rgba(0,0,0,0.58), 0 0 72px rgba(88,230,255,0.16)
- **Md**: 0 18px 60px rgba(0,0,0,0.42), 0 0 36px rgba(155,108,255,0.10)
- **Sm**: 0 8px 24px rgba(0,0,0,0.32), 0 0 18px rgba(88,230,255,0.06)

## Shapes

### Rounded

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

### Surfaces

- **Base**: #05070B
- **Bg Pattern**: soft radial cyan and violet lumens, low-opacity grid arcs, and small noise texture kept under 8 percent opacity
- **Card Style**: rgba(12,18,28,0.72) cards with inset top highlight, 1px blue-gray border, and clipped cyan/violet corner glows
- **Elevated**: rgba(16, 24, 40, 0.78)
- **Glass Panel**: rgba(10, 16, 28, 0.68) with backdrop-filter blur(22px)
- **Neon Wash**: radial-gradient(circle at top left, rgba(40,215,255,.26), transparent 42%), radial-gradient(circle at bottom right, rgba(139,92,246,.22), transparent 48%)
- **Treatment**: translucent graphite glass over a near-black luminous mesh, using blur only on elevated surfaces

### Borders

- **Accent Width**: 2px
- **Active**: 1px solid rgba(40, 215, 255, 0.62)
- **Character**: crisp glass seams with brighter top-left catchlights and restrained cyan focus outlines
- **Default Width**: 1px
- **Glow**: 0 0 0 1px rgba(40,215,255,.35), 0 18px 60px rgba(40,215,255,.12)
- **Hairline**: 1px solid rgba(148, 199, 255, 0.22)
- **Radius Badge**: 999px
- **Radius Card**: 24px
- **Radius Control**: 14px
- **Style**: solid with translucent blue-gray defaults and gradient border masks on active AI modules

## Components

### Composition

Build a credible AI product workspace: navigation rail, prompt/generation canvas, model inspector, evidence queue, and telemetry strip. Use asymmetrical panel spans and depth layers so glass communicates state and grouping.

### Density

Medium-high operational density with compact controls, but each glass cluster needs enough breathing room and clear label/value pairs to prevent dark-mode mud.

### Hierarchy

Use graphite value steps for most hierarchy, then reserve luminous cyan for primary action/focus and violet for model intelligence or synthesis state. Text contrast must remain high on every translucent layer.

### Signature Patterns

- Gradient-masked active borders: active panes show a 2px cyan-violet border sweep while inactive panes keep quiet blue-gray seams.
- Lumen wells behind important panels: soft radial glows sit behind glass cards and are clipped by parent containers to suggest computational depth.
- AI state chips pair a tiny pulsing diode with monospace model metadata and never use sparkles as standalone decoration.
- Telemetry baselines use JetBrains Mono tabular numerals, hairline separators, and small cyan ticks aligned to a bottom rail.

## 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-019ea9a3-1125-7f13-a8e8-b7966b1c4b93/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 Anchor every screen in near-black graphite neutrals before adding glow.
- Do Use translucent glass to separate layers of AI work such as prompt, output, evidence, and model state.
- Do Reserve cyan/violet highlights for active, focused, or generative states and keep semantic success/warning/error colors distinct.
- Do Pair expressive surfaces with clear text hierarchy, tabular metrics, and visible focus rings.
- Don't Do not flood the whole interface with rainbow neon or cyberpunk poster gradients.
- Don't Do not put low-contrast gray text on blurred glass over bright glows.
- Don't Do not use sparkle icons as a substitute for meaningful AI state tokens.
- Don't Do not build generic equal marketing cards; the language should feel like a real AI operations product.

### Accessibility

Maintain WCAG AA contrast for all body text; never place muted labels below #8A9AAD on glass; primary cyan is for focus/action and must not be the only indicator of state.

### Usage Context

Best for generative AI studios, model observability tools, agent orchestration consoles, creative copilots, dark analytics products, and premium productivity surfaces that need futuristic identity without losing usability.
shadcn/ui theme
```json
{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "luminous-ai-dark-glass",
  "type": "registry:theme",
  "title": "Luminous AI Dark Glass shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#05070B",
      "foreground": "#F6FAFF",
      "card": "#101722",
      "card-foreground": "#F6FAFF",
      "popover": "#101722",
      "popover-foreground": "#F6FAFF",
      "primary": "#58E6FF",
      "primary-foreground": "#111111",
      "secondary": "#9B6CFF",
      "secondary-foreground": "#ffffff",
      "muted": "#8A9AAD",
      "muted-foreground": "#9CADBF",
      "accent": "#19F2B8",
      "accent-foreground": "#111111",
      "destructive": "#FF4D6D",
      "border": "#263545",
      "input": "#263545",
      "ring": "#19F2B8",
      "chart-1": "#58E6FF",
      "chart-2": "#9B6CFF",
      "chart-3": "#19F2B8",
      "chart-4": "#23E0A2",
      "chart-5": "#FFD166",
      "sidebar": "#101722",
      "sidebar-foreground": "#F6FAFF",
      "sidebar-primary": "#58E6FF",
      "sidebar-primary-foreground": "#111111",
      "sidebar-accent": "#71B7FF",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#263545",
      "sidebar-ring": "#19F2B8",
      "radius": "16px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#58E6FF",
      "primary-foreground": "#111111",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#19F2B8",
      "accent-foreground": "#111111",
      "destructive": "#FF4D6D",
      "border": "#303642",
      "input": "#303642",
      "ring": "#19F2B8",
      "chart-1": "#58E6FF",
      "chart-2": "#9B6CFF",
      "chart-3": "#19F2B8",
      "chart-4": "#23E0A2",
      "chart-5": "#FFD166",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#58E6FF",
      "sidebar-primary-foreground": "#111111",
      "sidebar-accent": "#19F2B8",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#303642",
      "sidebar-ring": "#19F2B8",
      "radius": "16px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "en-019ea9a3-1125-7f13-a8e8-b7966b1c4b93",
    "slug": "luminous-ai-dark-glass",
    "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",
        "active",
        "character",
        "default_width",
        "glow",
        "hairline",
        "radius_badge",
        "radius_card",
        "radius_control",
        "style"
      ],
      "colors": [
        "accent",
        "accent_foreground",
        "background",
        "border",
        "destructive",
        "error",
        "foreground",
        "info",
        "muted",
        "muted_foreground",
        "primary",
        "primary_foreground",
        "secondary",
        "secondary_foreground",
        "success",
        "surface",
        "text",
        "warning"
      ],
      "motion": [
        "ambient",
        "duration",
        "easing",
        "focus",
        "hover",
        "philosophy"
      ],
      "radii": [
        "full",
        "lg",
        "md",
        "none",
        "sm"
      ],
      "shadows": [
        "lg",
        "md",
        "sm"
      ],
      "spacing": [
        "base",
        "scale"
      ],
      "surfaces": [
        "base",
        "bg_pattern",
        "card_style",
        "elevated",
        "glass_panel",
        "neon_wash",
        "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 · luminous-ai-dark-glass
DESIGN.md

at a glance

Palette

Typography

headline-lgInter · 29px · 700

The quick brown fox jumps

headline-mdInter · 24px · 600

The quick brown fox jumps

body-mdInter · 16px · 400

The quick brown fox jumps

label-mdJetBrains 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
lg28px
md16px
none0px
sm10px
shadcn/ui

implementation kit

needs agent-authored kitrecipes storedshots compatibility 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: #05070B;
  --foreground: #F6FAFF;
  --card: #101722;
  --card-foreground: #F6FAFF;
  --popover: #101722;
  --popover-foreground: #F6FAFF;
  --primary: #58E6FF;
  --primary-foreground: #111111;
  --secondary: #9B6CFF;
  --secondary-foreground: #ffffff;
  --muted: #8A9AAD;
  --muted-foreground: #9CADBF;
  --accent: #19F2B8;
  --accent-foreground: #111111;
  --destructive: #FF4D6D;
  --border: #263545;
  --input: #263545;
  --ring: #19F2B8;
  --chart-1: #58E6FF;
  --chart-2: #9B6CFF;
  --chart-3: #19F2B8;
  --chart-4: #23E0A2;
  --chart-5: #FFD166;
  --sidebar: #101722;
  --sidebar-foreground: #F6FAFF;
  --sidebar-primary: #58E6FF;
  --sidebar-primary-foreground: #111111;
  --sidebar-accent: #71B7FF;
  --sidebar-accent-foreground: #ffffff;
  --sidebar-border: #263545;
  --sidebar-ring: #19F2B8;
  --radius: 16px;
}

.dark {
  --background: #0f1115;
  --foreground: #f8fafc;
  --card: #181b22;
  --card-foreground: #f8fafc;
  --popover: #181b22;
  --popover-foreground: #f8fafc;
  --primary: #58E6FF;
  --primary-foreground: #111111;
  --secondary: #252a33;
  --secondary-foreground: #f8fafc;
  --muted: #252a33;
  --muted-foreground: #a1a1aa;
  --accent: #19F2B8;
  --accent-foreground: #111111;
  --destructive: #FF4D6D;
  --border: #303642;
  --input: #303642;
  --ring: #19F2B8;
  --chart-1: #58E6FF;
  --chart-2: #9B6CFF;
  --chart-3: #19F2B8;
  --chart-4: #23E0A2;
  --chart-5: #FFD166;
  --sidebar: #181b22;
  --sidebar-foreground: #f8fafc;
  --sidebar-primary: #58E6FF;
  --sidebar-primary-foreground: #111111;
  --sidebar-accent: #19F2B8;
  --sidebar-accent-foreground: #111111;
  --sidebar-border: #303642;
  --sidebar-ring: #19F2B8;
  --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 LuminousAiDarkGlassShadcnKit() {
  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">Luminous AI Dark Glass</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": "luminous-ai-dark-glass",
  "type": "registry:theme",
  "title": "Luminous AI Dark Glass shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#05070B",
      "foreground": "#F6FAFF",
      "card": "#101722",
      "card-foreground": "#F6FAFF",
      "popover": "#101722",
      "popover-foreground": "#F6FAFF",
      "primary": "#58E6FF",
      "primary-foreground": "#111111",
      "secondary": "#9B6CFF",
      "secondary-foreground": "#ffffff",
      "muted": "#8A9AAD",
      "muted-foreground": "#9CADBF",
      "accent": "#19F2B8",
      "accent-foreground": "#111111",
      "destructive": "#FF4D6D",
      "border": "#263545",
      "input": "#263545",
      "ring": "#19F2B8",
      "chart-1": "#58E6FF",
      "chart-2": "#9B6CFF",
      "chart-3": "#19F2B8",
      "chart-4": "#23E0A2",
      "chart-5": "#FFD166",
      "sidebar": "#101722",
      "sidebar-foreground": "#F6FAFF",
      "sidebar-primary": "#58E6FF",
      "sidebar-primary-foreground": "#111111",
      "sidebar-accent": "#71B7FF",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#263545",
      "sidebar-ring": "#19F2B8",
      "radius": "16px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#58E6FF",
      "primary-foreground": "#111111",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#19F2B8",
      "accent-foreground": "#111111",
      "destructive": "#FF4D6D",
      "border": "#303642",
      "input": "#303642",
      "ring": "#19F2B8",
      "chart-1": "#58E6FF",
      "chart-2": "#9B6CFF",
      "chart-3": "#19F2B8",
      "chart-4": "#23E0A2",
      "chart-5": "#FFD166",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#58E6FF",
      "sidebar-primary-foreground": "#111111",
      "sidebar-accent": "#19F2B8",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#303642",
      "sidebar-ring": "#19F2B8",
      "radius": "16px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "en-019ea9a3-1125-7f13-a8e8-b7966b1c4b93",
    "slug": "luminous-ai-dark-glass",
    "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",
        "active",
        "character",
        "default_width",
        "glow",
        "hairline",
        "radius_badge",
        "radius_card",
        "radius_control",
        "style"
      ],
      "colors": [
        "accent",
        "accent_foreground",
        "background",
        "border",
        "destructive",
        "error",
        "foreground",
        "info",
        "muted",
        "muted_foreground",
        "primary",
        "primary_foreground",
        "secondary",
        "secondary_foreground",
        "success",
        "surface",
        "text",
        "warning"
      ],
      "motion": [
        "ambient",
        "duration",
        "easing",
        "focus",
        "hover",
        "philosophy"
      ],
      "radii": [
        "full",
        "lg",
        "md",
        "none",
        "sm"
      ],
      "shadows": [
        "lg",
        "md",
        "sm"
      ],
      "spacing": [
        "base",
        "scale"
      ],
      "surfaces": [
        "base",
        "bg_pattern",
        "card_style",
        "elevated",
        "glass_panel",
        "neon_wash",
        "treatment"
      ],
      "typography": [
        "base_size",
        "body_font",
        "google_fonts_url",
        "heading_font",
        "letter_spacing",
        "line_height",
        "mono_font",
        "scale_ratio"
      ]
    }
  }
}
component recipesstored
# shadcn/ui Components — Luminous AI Dark Glass

Author: `katagami-agent`

## ShadSync visual profile
- Family: luminous dark glass AI product surface
- Material: translucent graphite glass with blur, hairline borders, and restrained neon glow
- Shape scale: 24px cards, 14px controls, pill badges; roles stay consistent across screens
- Density: compact operations UI with high-contrast labels, tabular numeric telemetry, and responsive grid collapse
- Motion: subtle 180ms lift, focus ring expansion, and low-amplitude ambient shimmer with reduced-motion support

## Signature component recipes
### button
Use the local `@/components/ui/button` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep button content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### card
Use the local `@/components/ui/card` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep card content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### input
Use the local `@/components/ui/input` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep input content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### textarea
Use the local `@/components/ui/textarea` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep textarea content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### select
Use the local `@/components/ui/select` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep select content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### dialog
Use the local `@/components/ui/dialog` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep dialog content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### sheet
Use the local `@/components/ui/sheet` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep sheet content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### tabs
Use the local `@/components/ui/tabs` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep tabs content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### badge
Use the local `@/components/ui/badge` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep badge content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### separator
Use the local `@/components/ui/separator` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep separator content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### checkbox
Use the local `@/components/ui/checkbox` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep checkbox content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### switch
Use the local `@/components/ui/switch` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep switch content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### slider
Use the local `@/components/ui/slider` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep slider content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### tooltip
Use the local `@/components/ui/tooltip` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep tooltip content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### dropdown-menu
Use the local `@/components/ui/dropdown-menu` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep dropdown-menu content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.
### table
Use the local `@/components/ui/table` primitive with dark glass styling, `border-cyan-300/25`, `bg-slate-950/70`, cyan focus-visible rings, and violet/mint accents. Keep table content concrete: AI jobs, prompts, model routing, confidence, latency, or review state rather than placeholder lorem ipsum.

## Preview shots
- `application-shell`: command center with navigation, model routing, prompt queue, and live generation health.
- `detail-editor`: prompt tuning editor with glass form controls, sheet/dialog overlays, and confidence badges.
- `data-operations`: evaluation table with filters, sliders, switches, checkboxes, and dropdown actions.

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

export function LuminousAIOperationsCard() {
  return (
    <Card className="border-cyan-300/25 bg-slate-950/70 text-slate-50 shadow-[0_0_60px_rgba(40,215,255,.14)] backdrop-blur-2xl">
      <CardHeader className="space-y-2">
        <Badge className="w-fit rounded-full border border-cyan-300/40 bg-cyan-300/10 text-cyan-100">Model live</Badge>
        <CardTitle className="font-semibold tracking-tight">Generate launch palette</CardTitle>
      </CardHeader>
      <CardContent className="flex gap-3">
        <Input className="border-cyan-300/20 bg-slate-900/70 focus-visible:ring-cyan-300" placeholder="Describe the next AI state" />
        <Button className="bg-cyan-300 text-slate-950 hover:bg-cyan-200">Run</Button>
      </CardContent>
    </Card>
  )
}
```
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-019ea9a3-1125-7f13-a8e8-b7966b1c4b93",
    "name": "Luminous AI Dark Glass",
    "slug": "luminous-ai-dark-glass"
  },
  "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": [
    "Near-black radial-gradient body background with graphite panels, faint cyan/violet underglow islands, and no pure black page voids.",
    "Layered glass cards use rgba graphite fills, backdrop-filter blur, 1px translucent borders, and inset highlight strokes to reveal stacked AI surfaces.",
    "Cyan-to-violet lumen rails, tiny status diodes, and focused ring shadows appear only on primary controls, active tabs, model-state chips, and live panels.",
    "Dense product layout combines a left command rail, central generation canvas, side inspection stack, and bottom telemetry strip with varied spans rather than equal tiles.",
    "Readable Inter text hierarchy is paired with JetBrains Mono telemetry, tabular numerals, and uppercase micro-labels with increased tracking."
  ],
  "visualProfile": {
    "family": "system",
    "material": "flat",
    "contour": "default",
    "border": "solid",
    "underlay": true,
    "grain": false,
    "stickerBadges": false,
    "motion": "still",
    "density": "dense",
    "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": "Luminous AI Dark Glass 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": [
      "Anchor every screen in near-black graphite neutrals before adding glow.",
      "Use translucent glass to separate layers of AI work such as prompt, output, evidence, and model state.",
      "Reserve cyan/violet highlights for active, focused, or generative states and keep semantic success/warning/error colors distinct.",
      "Pair expressive surfaces with clear text hierarchy, tabular metrics, and visible focus rings."
    ],
    "dont": [
      "Do not flood the whole interface with rainbow neon or cyberpunk poster gradients.",
      "Do not put low-contrast gray text on blurred glass over bright glows.",
      "Do not use sparkle icons as a substitute for meaningful AI state tokens.",
      "Do not build generic equal marketing cards; the language should feel like a real AI operations product."
    ]
  }
}
related

More like this