back to gallery
design language·shibuya-sign-density-pop

Shibuya Sign-Density Pop

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
Shibuya Sign-Density Pop translates Tokyo's layered commercial streetscape into an interface language that feels saturated, kinetic, and immediate. The design behaves like a dense pedestrian corridor of competing signals: oversized headlines, compressed side labels, glowing ad panels, transit arrows, warning strips, and fragments of posters all stacked into a navigable overload. Rather than smoothing complexity away, it choreographs simultaneous messages so the user feels energized instead of lost.
values
Urban simultaneity over quiet minimalismWayfinding through vivid cues and stacked emphasisCommercial spectacle as usable interface structureCollision between polished screens and pasted street ephemeraMotion-ready composition that implies live feeds, ads, and ambient refresh
anti-values
×Flat corporate neutrality×Single-scale typography×Large empty surfaces without signal layering×Muted monochrome palettes that suppress urgency×Symmetrical layouts that erase street-level friction
tokens
colors12 items
primary
#ff2d9a
secondary
#1fe3ff
accent
#ffe14d
background
#090713
surface
#151127
text
#f8f5ff
muted
#a89fc3
border
#3f3562
error
#ff5b6e
success
#4dff9c
warning
#ffb72b
info
#69a7ff
typography8 items
heading font
Bebas Neue
body font
Barlow Condensed
mono font
IBM Plex Mono
base size
16px
scale ratio
1.2
line height
1.45
letter spacing
0.02em
google fonts url
https://fonts.googleapis.com/css2?family=Barlow+Condensed:wght@400;500;600;700&family=Bebas+Neue&family=IBM+Plex+Mono:wght@400;500;600&display=swap
spacing2 items
base
8px
scale
4, 8, 12, 16, 24, 32, 48, 64
radii5 items
none
0
sm
8px
md
16px
lg
26px
full
9999px
shadows3 items
sm
0 0 0 1px rgba(255,255,255,0.03), 0 10px 24px rgba(0,0,0,0.22)
md
0 0 0 1px rgba(255,255,255,0.04), 0 18px 40px rgba(0,0,0,0.34), 0 0 24px rgba(255,45,154,0.14)
lg
0 0 0 1px rgba(255,255,255,0.05), 0 24px 60px rgba(0,0,0,0.45), 0 0 42px rgba(31,227,255,0.18)
surfaces3 items
treatment
gradient
card style
glossy billboard panels with translucent overlays, scanline sheen, and inset mini-screens
bg pattern
grid
borders4 items
default width
1px
accent width
3px
style
solid
character
crisp luminous separators, colored edge rails, and transit-label outlines that carve dense modules apart
motion3 items
duration
180ms
easing
cubic-bezier(0.2, 0.8, 0.2, 1)
philosophy
snappy
rules
composition
Compose as a compressed entertainment district: major content lives in stacked sign towers, while supporting details cling to the edges as stickers, route strips, and ticker fragments. Every major surface should feel like rentable visual real estate rather than a neutral container.
hierarchy
Use violent scale shifts: one oversized word, one numeric beacon, then dense supporting labels and metadata. Hierarchy should jump abruptly instead of stepping smoothly; users scan by color, number, and directional marker before reading paragraphs.
density
High density with disciplined lanes. Surfaces are crowded, but each crowding move must be bounded by rails, borders, and inset frames so the scene feels orchestrated rather than random.
signature patterns
Primary cards are built as vertical sign stacks with 3 to 5 compressed modules separated by thin luminous dividersSection titles pair giant condensed display text with rotated side labels or transit-chip metadataEach major surface includes at least one screen-within-screen inset framed like a billboard or live displayPoster fragments and sticker tags overlap card corners using absolute positioning, dashed outlines, and arrow pillsBackgrounds use layered neon gradients plus subtle grid or scanline textures to evoke electronic signage
layout
grid
Desktop uses a 14-column asymmetric grid with a dominant central boulevard, narrow left sign rail, and right-side status stack. Tablet collapses to 8 columns while preserving stacked towers. Mobile becomes a single dense feed of vertically clipped panels with preserved overlay tags.
breakpoints
Mobile base at 0px, tablet at 760px, desktop at 1180px. Each breakpoint must keep dense vertical stacking, inset screens, and side labels rather than flattening to generic cards.
whitespace
Whitespace is used as a hard gutter and separator, not as calm atmosphere. Breathing room exists between stacks and inside small labels, but the overall scene should feel packed with signals.
guidance
do
  • Stack related information in narrow vertical modules with contrasting color bands
  • Mix giant headlines with compressed utility labels and route markers
  • Use inset display windows, tickers, and secondary frames inside main cards
  • Let stickers, arrows, and labels overlap edges to create layered street energy
  • Maintain strong rails and separators so high density stays legible
avoid
  • Center everything into balanced hero layouts
  • Reduce the palette to one accent color
  • Use generic rounded SaaS cards without overlays or signage logic
  • Rely on long body copy blocks as the primary hierarchy device
  • Remove motion cues, glows, or inset screens from key surfaces
katagami spec
# Shibuya Sign-Density Pop

## Philosophy

Shibuya Sign-Density Pop translates Tokyo's layered commercial streetscape into an interface language that feels saturated, kinetic, and immediate. The design behaves like a dense pedestrian corridor of competing signals: oversized headlines, compressed side labels, glowing ad panels, transit arrows, warning strips, and fragments of posters all stacked into a navigable overload. Rather than smoothing complexity away, it choreographs simultaneous messages so the user feels energized instead of lost.

### Values

- Urban simultaneity over quiet minimalism
- Wayfinding through vivid cues and stacked emphasis
- Commercial spectacle as usable interface structure
- Collision between polished screens and pasted street ephemera
- Motion-ready composition that implies live feeds, ads, and ambient refresh

### Anti-Values

- Flat corporate neutrality
- Single-scale typography
- Large empty surfaces without signal layering
- Muted monochrome palettes that suppress urgency
- Symmetrical layouts that erase street-level friction

### Visual Character

- Tall vertical stacks of narrow modules and sign towers separated by hard gutters
- Abrupt type hierarchy jumps mixing giant condensed numerals, compact kana-style labels, and tiny metadata strips
- Glossy billboard gradients with LED-like glow, reflective color bands, and luminous edge highlights
- Poster-fragment overlays using stickers, arrows, transit tags, caution bars, and offset labels pinned across surfaces
- Screen-within-screen frames where cards contain smaller broadcast panels, tickers, and inset displays

## Tokens

### Colors

| Name | Value |
|------|-------|
| primary | `#ff2d9a` |
| secondary | `#1fe3ff` |
| accent | `#ffe14d` |
| background | `#090713` |
| surface | `#151127` |
| text | `#f8f5ff` |
| muted | `#a89fc3` |
| border | `#3f3562` |
| error | `#ff5b6e` |
| success | `#4dff9c` |
| warning | `#ffb72b` |
| info | `#69a7ff` |

### Typography

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

### Spacing

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

### Radii

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

### Shadows

- **Sm**: 0 0 0 1px rgba(255,255,255,0.03), 0 10px 24px rgba(0,0,0,0.22)
- **Md**: 0 0 0 1px rgba(255,255,255,0.04), 0 18px 40px rgba(0,0,0,0.34), 0 0 24px rgba(255,45,154,0.14)
- **Lg**: 0 0 0 1px rgba(255,255,255,0.05), 0 24px 60px rgba(0,0,0,0.45), 0 0 42px rgba(31,227,255,0.18)

### Surfaces

- **Treatment**: gradient
- **Card Style**: glossy billboard panels with translucent overlays, scanline sheen, and inset mini-screens
- **Bg Pattern**: grid

### Borders

- **Default Width**: 1px
- **Accent Width**: 3px
- **Style**: solid
- **Character**: crisp luminous separators, colored edge rails, and transit-label outlines that carve dense modules apart

### Motion

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

## Rules

### Composition

Compose as a compressed entertainment district: major content lives in stacked sign towers, while supporting details cling to the edges as stickers, route strips, and ticker fragments. Every major surface should feel like rentable visual real estate rather than a neutral container.

### Hierarchy

Use violent scale shifts: one oversized word, one numeric beacon, then dense supporting labels and metadata. Hierarchy should jump abruptly instead of stepping smoothly; users scan by color, number, and directional marker before reading paragraphs.

### Density

High density with disciplined lanes. Surfaces are crowded, but each crowding move must be bounded by rails, borders, and inset frames so the scene feels orchestrated rather than random.

### Signature Patterns

- Primary cards are built as vertical sign stacks with 3 to 5 compressed modules separated by thin luminous dividers
- Section titles pair giant condensed display text with rotated side labels or transit-chip metadata
- Each major surface includes at least one screen-within-screen inset framed like a billboard or live display
- Poster fragments and sticker tags overlap card corners using absolute positioning, dashed outlines, and arrow pills
- Backgrounds use layered neon gradients plus subtle grid or scanline textures to evoke electronic signage

## Layout

### Grid

Desktop uses a 14-column asymmetric grid with a dominant central boulevard, narrow left sign rail, and right-side status stack. Tablet collapses to 8 columns while preserving stacked towers. Mobile becomes a single dense feed of vertically clipped panels with preserved overlay tags.

### Breakpoints

Mobile base at 0px, tablet at 760px, desktop at 1180px. Each breakpoint must keep dense vertical stacking, inset screens, and side labels rather than flattening to generic cards.

### Whitespace

Whitespace is used as a hard gutter and separator, not as calm atmosphere. Breathing room exists between stacks and inside small labels, but the overall scene should feel packed with signals.

## Guidance

### Do

- Stack related information in narrow vertical modules with contrasting color bands
- Mix giant headlines with compressed utility labels and route markers
- Use inset display windows, tickers, and secondary frames inside main cards
- Let stickers, arrows, and labels overlap edges to create layered street energy
- Maintain strong rails and separators so high density stays legible

### Don't

- Center everything into balanced hero layouts
- Reduce the palette to one accent color
- Use generic rounded SaaS cards without overlays or signage logic
- Rely on long body copy blocks as the primary hierarchy device
- Remove motion cues, glows, or inset screens from key surfaces
DESIGN.md
---
version: "alpha"
name: "Shibuya Sign-Density Pop"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
  primary: "#ff2d9a"
  secondary: "#1fe3ff"
  accent: "#ffe14d"
  background: "#090713"
  surface: "#151127"
  text: "#f8f5ff"
  muted: "#a89fc3"
  border: "#3f3562"
  error: "#ff5b6e"
  success: "#4dff9c"
  warning: "#ffb72b"
  info: "#69a7ff"
typography:
  headline-lg:
    fontFamily: "Bebas Neue"
    fontSize: "1.728rem"
    fontWeight: 700
    lineHeight: 1.1
    letterSpacing: "0.02em"
  headline-md:
    fontFamily: "Bebas Neue"
    fontSize: "1.44rem"
    fontWeight: 600
    lineHeight: 1.15
    letterSpacing: "0.02em"
  body-md:
    fontFamily: "Barlow Condensed"
    fontSize: "16px"
    fontWeight: 400
    lineHeight: 1.45
    letterSpacing: "0.02em"
  label-md:
    fontFamily: "IBM Plex Mono"
    fontSize: "0.75rem"
    fontWeight: 600
    lineHeight: 1
    letterSpacing: "0.08em"
rounded:
  none: "0px"
  sm: "8px"
  md: "16px"
  lg: "26px"
  full: "9999px"
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"
---

# Shibuya Sign-Density Pop

## Overview

Shibuya Sign-Density Pop translates Tokyo's layered commercial streetscape into an interface language that feels saturated, kinetic, and immediate. The design behaves like a dense pedestrian corridor of competing signals: oversized headlines, compressed side labels, glowing ad panels, transit arrows, warning strips, and fragments of posters all stacked into a navigable overload. Rather than smoothing complexity away, it choreographs simultaneous messages so the user feels energized instead of lost.

### Values

- Urban simultaneity over quiet minimalism
- Wayfinding through vivid cues and stacked emphasis
- Commercial spectacle as usable interface structure
- Collision between polished screens and pasted street ephemera
- Motion-ready composition that implies live feeds, ads, and ambient refresh

### Anti-Values

- Flat corporate neutrality
- Single-scale typography
- Large empty surfaces without signal layering
- Muted monochrome palettes that suppress urgency
- Symmetrical layouts that erase street-level friction

### Visual Character

- Tall vertical stacks of narrow modules and sign towers separated by hard gutters
- Abrupt type hierarchy jumps mixing giant condensed numerals, compact kana-style labels, and tiny metadata strips
- Glossy billboard gradients with LED-like glow, reflective color bands, and luminous edge highlights
- Poster-fragment overlays using stickers, arrows, transit tags, caution bars, and offset labels pinned across surfaces
- Screen-within-screen frames where cards contain smaller broadcast panels, tickers, and inset displays

## 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 | `#ff2d9a` |
| secondary | `#1fe3ff` |
| accent | `#ffe14d` |
| background | `#090713` |
| surface | `#151127` |
| text | `#f8f5ff` |
| muted | `#a89fc3` |
| border | `#3f3562` |
| error | `#ff5b6e` |
| success | `#4dff9c` |
| warning | `#ffb72b` |
| info | `#69a7ff` |

## Typography

- **Headline-Lg**: Bebas Neue, 1.728rem, weight 700, line-height 1.1.
- **Headline-Md**: Bebas Neue, 1.44rem, weight 600, line-height 1.15.
- **Body-Md**: Barlow Condensed, 16px, weight 400, line-height 1.45.
- **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 14-column asymmetric grid with a dominant central boulevard, narrow left sign rail, and right-side status stack. Tablet collapses to 8 columns while preserving stacked towers. Mobile becomes a single dense feed of vertically clipped panels with preserved overlay tags.

### Breakpoints

Mobile base at 0px, tablet at 760px, desktop at 1180px. Each breakpoint must keep dense vertical stacking, inset screens, and side labels rather than flattening to generic cards.

### Whitespace

Whitespace is used as a hard gutter and separator, not as calm atmosphere. Breathing room exists between stacks and inside small labels, but the overall scene should feel packed with signals.

## Elevation & Depth

### Shadows

- **Sm**: 0 0 0 1px rgba(255,255,255,0.03), 0 10px 24px rgba(0,0,0,0.22)
- **Md**: 0 0 0 1px rgba(255,255,255,0.04), 0 18px 40px rgba(0,0,0,0.34), 0 0 24px rgba(255,45,154,0.14)
- **Lg**: 0 0 0 1px rgba(255,255,255,0.05), 0 24px 60px rgba(0,0,0,0.45), 0 0 42px rgba(31,227,255,0.18)

## Shapes

### Rounded

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

### Surfaces

- **Treatment**: gradient
- **Card Style**: glossy billboard panels with translucent overlays, scanline sheen, and inset mini-screens
- **Bg Pattern**: grid

### Borders

- **Default Width**: 1px
- **Accent Width**: 3px
- **Style**: solid
- **Character**: crisp luminous separators, colored edge rails, and transit-label outlines that carve dense modules apart

## Components

### Composition

Compose as a compressed entertainment district: major content lives in stacked sign towers, while supporting details cling to the edges as stickers, route strips, and ticker fragments. Every major surface should feel like rentable visual real estate rather than a neutral container.

### Hierarchy

Use violent scale shifts: one oversized word, one numeric beacon, then dense supporting labels and metadata. Hierarchy should jump abruptly instead of stepping smoothly; users scan by color, number, and directional marker before reading paragraphs.

### Density

High density with disciplined lanes. Surfaces are crowded, but each crowding move must be bounded by rails, borders, and inset frames so the scene feels orchestrated rather than random.

### Signature Patterns

- Primary cards are built as vertical sign stacks with 3 to 5 compressed modules separated by thin luminous dividers
- Section titles pair giant condensed display text with rotated side labels or transit-chip metadata
- Each major surface includes at least one screen-within-screen inset framed like a billboard or live display
- Poster fragments and sticker tags overlap card corners using absolute positioning, dashed outlines, and arrow pills
- Backgrounds use layered neon gradients plus subtle grid or scanline textures to evoke electronic signage

## 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-019d9bb9-2ea1-7d91-a5d7-35d3065d7de3/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 Stack related information in narrow vertical modules with contrasting color bands
- Do Mix giant headlines with compressed utility labels and route markers
- Do Use inset display windows, tickers, and secondary frames inside main cards
- Do Let stickers, arrows, and labels overlap edges to create layered street energy
- Do Maintain strong rails and separators so high density stays legible
- Don't Center everything into balanced hero layouts
- Don't Reduce the palette to one accent color
- Don't Use generic rounded SaaS cards without overlays or signage logic
- Don't Rely on long body copy blocks as the primary hierarchy device
- Don't Remove motion cues, glows, or inset screens from key surfaces
shadcn/ui theme
```json
{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "shibuya-sign-density-pop",
  "type": "registry:theme",
  "title": "Shibuya Sign-Density Pop shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#090713",
      "foreground": "#f8f5ff",
      "card": "#151127",
      "card-foreground": "#f8f5ff",
      "popover": "#151127",
      "popover-foreground": "#f8f5ff",
      "primary": "#ff2d9a",
      "primary-foreground": "#ffffff",
      "secondary": "#1fe3ff",
      "secondary-foreground": "#111111",
      "muted": "#a89fc3",
      "muted-foreground": "#f8f5ff",
      "accent": "#ffe14d",
      "accent-foreground": "#111111",
      "destructive": "#ff5b6e",
      "border": "#3f3562",
      "input": "#3f3562",
      "ring": "#ffe14d",
      "chart-1": "#ff2d9a",
      "chart-2": "#1fe3ff",
      "chart-3": "#ffe14d",
      "chart-4": "#4dff9c",
      "chart-5": "#ffb72b",
      "sidebar": "#151127",
      "sidebar-foreground": "#f8f5ff",
      "sidebar-primary": "#ff2d9a",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#69a7ff",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#3f3562",
      "sidebar-ring": "#ffe14d",
      "radius": "16px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#ff2d9a",
      "primary-foreground": "#ffffff",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#ffe14d",
      "accent-foreground": "#111111",
      "destructive": "#ff5b6e",
      "border": "#303642",
      "input": "#303642",
      "ring": "#ffe14d",
      "chart-1": "#ff2d9a",
      "chart-2": "#1fe3ff",
      "chart-3": "#ffe14d",
      "chart-4": "#4dff9c",
      "chart-5": "#ffb72b",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#ff2d9a",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#ffe14d",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#303642",
      "sidebar-ring": "#ffe14d",
      "radius": "16px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "en-019d9bb9-2ea1-7d91-a5d7-35d3065d7de3",
    "slug": "shibuya-sign-density-pop",
    "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"
      ]
    }
  }
}
```
in the wild

embodiments

the full element showcase
embodiment · shibuya-sign-density-pop
DESIGN.md

at a glance

Palette

Typography

headline-lgBebas Neue · 28px · 700

The quick brown fox jumps

headline-mdBebas Neue · 23px · 600

The quick brown fox jumps

body-mdBarlow Condensed · 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
sm8px
md16px
lg26px
full9999px
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: #090713;
  --foreground: #f8f5ff;
  --card: #151127;
  --card-foreground: #f8f5ff;
  --popover: #151127;
  --popover-foreground: #f8f5ff;
  --primary: #ff2d9a;
  --primary-foreground: #ffffff;
  --secondary: #1fe3ff;
  --secondary-foreground: #111111;
  --muted: #a89fc3;
  --muted-foreground: #f8f5ff;
  --accent: #ffe14d;
  --accent-foreground: #111111;
  --destructive: #ff5b6e;
  --border: #3f3562;
  --input: #3f3562;
  --ring: #ffe14d;
  --chart-1: #ff2d9a;
  --chart-2: #1fe3ff;
  --chart-3: #ffe14d;
  --chart-4: #4dff9c;
  --chart-5: #ffb72b;
  --sidebar: #151127;
  --sidebar-foreground: #f8f5ff;
  --sidebar-primary: #ff2d9a;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #69a7ff;
  --sidebar-accent-foreground: #ffffff;
  --sidebar-border: #3f3562;
  --sidebar-ring: #ffe14d;
  --radius: 16px;
}

.dark {
  --background: #0f1115;
  --foreground: #f8fafc;
  --card: #181b22;
  --card-foreground: #f8fafc;
  --popover: #181b22;
  --popover-foreground: #f8fafc;
  --primary: #ff2d9a;
  --primary-foreground: #ffffff;
  --secondary: #252a33;
  --secondary-foreground: #f8fafc;
  --muted: #252a33;
  --muted-foreground: #a1a1aa;
  --accent: #ffe14d;
  --accent-foreground: #111111;
  --destructive: #ff5b6e;
  --border: #303642;
  --input: #303642;
  --ring: #ffe14d;
  --chart-1: #ff2d9a;
  --chart-2: #1fe3ff;
  --chart-3: #ffe14d;
  --chart-4: #4dff9c;
  --chart-5: #ffb72b;
  --sidebar: #181b22;
  --sidebar-foreground: #f8fafc;
  --sidebar-primary: #ff2d9a;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #ffe14d;
  --sidebar-accent-foreground: #111111;
  --sidebar-border: #303642;
  --sidebar-ring: #ffe14d;
  --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 ShibuyaSignDensityPopShadcnKit() {
  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">Shibuya Sign-Density Pop</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": "shibuya-sign-density-pop",
  "type": "registry:theme",
  "title": "Shibuya Sign-Density Pop shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#090713",
      "foreground": "#f8f5ff",
      "card": "#151127",
      "card-foreground": "#f8f5ff",
      "popover": "#151127",
      "popover-foreground": "#f8f5ff",
      "primary": "#ff2d9a",
      "primary-foreground": "#ffffff",
      "secondary": "#1fe3ff",
      "secondary-foreground": "#111111",
      "muted": "#a89fc3",
      "muted-foreground": "#f8f5ff",
      "accent": "#ffe14d",
      "accent-foreground": "#111111",
      "destructive": "#ff5b6e",
      "border": "#3f3562",
      "input": "#3f3562",
      "ring": "#ffe14d",
      "chart-1": "#ff2d9a",
      "chart-2": "#1fe3ff",
      "chart-3": "#ffe14d",
      "chart-4": "#4dff9c",
      "chart-5": "#ffb72b",
      "sidebar": "#151127",
      "sidebar-foreground": "#f8f5ff",
      "sidebar-primary": "#ff2d9a",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#69a7ff",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#3f3562",
      "sidebar-ring": "#ffe14d",
      "radius": "16px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#ff2d9a",
      "primary-foreground": "#ffffff",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#ffe14d",
      "accent-foreground": "#111111",
      "destructive": "#ff5b6e",
      "border": "#303642",
      "input": "#303642",
      "ring": "#ffe14d",
      "chart-1": "#ff2d9a",
      "chart-2": "#1fe3ff",
      "chart-3": "#ffe14d",
      "chart-4": "#4dff9c",
      "chart-5": "#ffb72b",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#ff2d9a",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#ffe14d",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#303642",
      "sidebar-ring": "#ffe14d",
      "radius": "16px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "en-019d9bb9-2ea1-7d91-a5d7-35d3065d7de3",
    "slug": "shibuya-sign-density-pop",
    "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"
      ]
    }
  }
}
component recipescompatibility fallback
# Shibuya Sign-Density Pop shadcn/ui Components

Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `en-019d9bb9-2ea1-7d91-a5d7-35d3065d7de3`
Slug: `shibuya-sign-density-pop`

## Intent

Shibuya Sign-Density Pop translates Tokyo's layered commercial streetscape into an interface language that feels saturated, kinetic, and immediate. The design behaves like a dense pedestrian corridor of competing signals: oversized headlines, compressed side labels, glowing ad panels, transit arrows, warning strips, and fragments of posters all stacked into a navigable overload. Rather than smoothing complexity away, it choreographs simultaneous messages so the user feels energized instead of lost.

## 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": "#ff2d9a",
  "secondary": "#1fe3ff",
  "accent": "#ffe14d",
  "background": "#090713",
  "surface": "#151127",
  "text": "#f8f5ff",
  "muted": "#a89fc3",
  "border": "#3f3562",
  "error": "#ff5b6e",
  "success": "#4dff9c",
  "warning": "#ffb72b",
  "info": "#69a7ff"
}

Typography:

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

## Visual character to preserve

- Tall vertical stacks of narrow modules and sign towers separated by hard gutters
- Abrupt type hierarchy jumps mixing giant condensed numerals, compact kana-style labels, and tiny metadata strips
- Glossy billboard gradients with LED-like glow, reflective color bands, and luminous edge highlights
- Poster-fragment overlays using stickers, arrows, transit tags, caution bars, and offset labels pinned across surfaces
- Screen-within-screen frames where cards contain smaller broadcast panels, tickers, and inset displays

## ShadSync visual profile

{
  "family": "paper-collage",
  "material": "paper",
  "contour": "pebble",
  "border": "dashed",
  "underlay": true,
  "grain": true,
  "stickerBadges": true,
  "motion": "lift-rotate",
  "density": "dense",
  "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/shibuya-sign-density-pop/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: Stack related information in narrow vertical modules with contrasting color bands; Mix giant headlines with compressed utility labels and route markers; Use inset display windows, tickers, and secondary frames inside main cards; Let stickers, arrows, and labels overlap edges to create layered street energy; Maintain strong rails and separators so high density stays legible
- Do not: Center everything into balanced hero layouts; Reduce the palette to one accent color; Use generic rounded SaaS cards without overlays or signage logic; Rely on long body copy blocks as the primary hierarchy device; Remove motion cues, glows, or inset screens from key surfaces

## 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 ShibuyaSignDensityPopShadcnKit() {
  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">Shibuya Sign-Density Pop</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 14-column asymmetric grid with a dominant central boulevard, narrow left sign rail, and right-side status stack. Tablet collapses to 8 columns while preserving stacked towers. Mobile becomes a single dense feed of vertically clipped panels with preserved overlay tags.",
  "breakpoints": "Mobile base at 0px, tablet at 760px, desktop at 1180px. Each breakpoint must keep dense vertical stacking, inset screens, and side labels rather than flattening to generic cards.",
  "whitespace": "Whitespace is used as a hard gutter and separator, not as calm atmosphere. Breathing room exists between stacks and inside small labels, but the overall scene should feel packed with signals."
}
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-019d9bb9-2ea1-7d91-a5d7-35d3065d7de3",
    "name": "Shibuya Sign-Density Pop",
    "slug": "shibuya-sign-density-pop"
  },
  "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": [
    "Tall vertical stacks of narrow modules and sign towers separated by hard gutters",
    "Abrupt type hierarchy jumps mixing giant condensed numerals, compact kana-style labels, and tiny metadata strips",
    "Glossy billboard gradients with LED-like glow, reflective color bands, and luminous edge highlights",
    "Poster-fragment overlays using stickers, arrows, transit tags, caution bars, and offset labels pinned across surfaces",
    "Screen-within-screen frames where cards contain smaller broadcast panels, tickers, and inset displays"
  ],
  "visualProfile": {
    "family": "paper-collage",
    "material": "paper",
    "contour": "pebble",
    "border": "dashed",
    "underlay": true,
    "grain": true,
    "stickerBadges": true,
    "motion": "lift-rotate",
    "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": "Shibuya Sign-Density Pop 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": [
      "Stack related information in narrow vertical modules with contrasting color bands",
      "Mix giant headlines with compressed utility labels and route markers",
      "Use inset display windows, tickers, and secondary frames inside main cards",
      "Let stickers, arrows, and labels overlap edges to create layered street energy",
      "Maintain strong rails and separators so high density stays legible"
    ],
    "dont": [
      "Center everything into balanced hero layouts",
      "Reduce the palette to one accent color",
      "Use generic rounded SaaS cards without overlays or signage logic",
      "Rely on long body copy blocks as the primary hierarchy device",
      "Remove motion cues, glows, or inset screens from key surfaces"
    ]
  }
}
related

More like this