Ghost Packet Metrograph
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.
specification
philosophy
tokens
borders4 items
- accent width
- 3px
- character
- Near-invisible grout dividers alternate with heavy black transit sign rules and red exception ticks.
- default width
- 1px
- style
- solid
colors12 items
motion3 items
- duration
- 640ms
- easing
- steps(6, end)
- philosophy
- Movement should feel delayed and hardware-rendered: blink one red pip, advance one ghost bar, or shift a timestamp by steps rather than animate continuously.
radii5 items
- full
- 9999px
- lg
- 16px
- md
- 0px
- none
- 0px
- sm
- 0px
shadows3 items
- lg
- 0 32px 0 rgba(17,16,14,0.06)
- md
- 0 18px 0 rgba(17,16,14,0.04)
- sm
- none
spacing2 items
- base
- 8px
- scale
- 4, 8, 12, 16, 24, 32, 48, 64, 96
surfaces3 items
- bg pattern
- Large off-white field with thin tile grid, overprinted manga speed-line wedges, and clipped route traces.
- card style
- Squared station panels: 1px pale grout borders, occasional 3px black service caps, no glow, no glass, no soft radius.
- treatment
- Warm tile-white surfaces with subtle grout grids, black ink blocks, and CRT raster overlays at 4-7% opacity.
typography8 items
- base size
- 16px
- body font
- Libre Franklin
- google fonts url
- https://fonts.googleapis.com/css2?family=Archivo+Narrow:wght@500;600;700&family=Libre+Franklin:wght@400;500;600;700&family=Martian+Mono:wght@400;500;600&display=swap
- heading font
- Archivo Narrow
- letter spacing
- -0.02em
- line height
- 1.55
- mono font
- Martian Mono
- scale ratio
- 1.25
rules
Build screens as transit artifacts, not dashboards: one dominant map or strip diagram anchors the view, smaller station notices attach as tiled panels, and black speed-line vectors cross boundaries to imply signal flow. Use asymmetry, full-bleed ink bars, and dense annotation clusters against large absent platform-air whitespace.
Alternate dense telemetry knots with wide empty tile fields; the language should feel like a quiet platform monitor where only a few fragments have updated.
Public-service headings use compressed grotesk uppercase and heavy black bands; operational states use route bullets and red pips; ghost logs use tiny monospace rows. Size, weight, and border thickness must create hierarchy before additional color is added.
layout
Mobile at 640px collapses to one column with horizontal strip-map sequencing; tablet at 900px keeps a two-column route/notice split; desktop at 1200px unlocks full topology.
High-density diagnostic clusters occupy no more than one third of a composition; the remaining field stays open, tiled, and silent to make absence legible.
Desktop uses a 12-column transit-grid shell with 16px gutters and a max width of 1320px, allowing map panels to span 7-8 columns and notices to stack asymmetrically.
Whitespace behaves like platform air and missing sensor data: large 64-96px pauses separate route regions, while station ticks and packet rows cluster at 4-12px.
guidance
- Start with tile white, black linework, and route topology before adding any accent color.
- Use dim red only for exceptions, stale timestamps, vanished reads, or handoff failures.
- Represent people through route traces, turnstile events, timestamps, and gaps instead of figures.
- Make at least one panel structurally dominant and break the grid with a black vector field or full-bleed route line.
- Use monospace telemetry for packet IDs, station codes, scan counts, and ghost logs.
- Keep radii square except for route bullets and status pips.
- Pair every color-coded state with text, shape, or border-weight changes for accessibility.
- Do not use green terminal rain, neon gradients, cyberpunk skyline glow, or saturated RGB accents.
- Do not create three equal cards in a row or generic metric widgets unrelated to transit.
- Do not illustrate anime characters, riders, agents, or hacker avatars.
- Do not soften the system with glassmorphism, pill-heavy SaaS controls, or decorative shadows.
- Do not use color as decoration; route colors must feel like muted diagnostics.
- Do not let manga lines become random texture; they must point, divide, or imply signal motion.
- Do not hide essential text in tiny raster labels below readable sizes.
katagami spec
# Ghost Packet Metrograph ## Philosophy Ghost Packet Metrograph treats a metropolitan rail network as a haunted packet-switching instrument: the rider is never drawn, only inferred from route deltas, turnstile ticks, delayed timestamps, and gaps in sensor coverage. It borrows the discipline of NYCTA modular wayfinding, manga black motion grammar, and late-90s terminal telemetry without becoming a neon cyberpunk dashboard. ### Values - Infrastructure over character: presence is shown through traces, missed reads, handoffs, and absences rather than illustrated avatars. - Civic clarity first: public hierarchy uses direct transit typography, blunt labels, route bullets, and legible service language. - Monochrome pressure: black ink, tile white, and warm paper create most of the identity before color is allowed. - Error as atmosphere: dim red pips, cancelled service strips, and stale timestamps carry tension without spectacle. - Diagrammatic embodiment: every decorative mark must also read as route geometry, signal vector, station tile, or telemetry artifact. - Temporal quiet: motion is sparse, delayed, and diagnostic, like a monitor noticing an afterimage too late. ### Anti-Values - No green matrix rain, neon city glow, or luminous hacker fantasy palettes. - No equal SaaS card grids, generic analytics widgets, or decorative dashboard filler. - No anime character portraits; the network presence must remain unseen and infrastructural. - No glossy rounded surfaces, glassmorphism, or friendly app softness that weakens the transit-system severity. ### Visual Character - Tile-white page grounds are divided by oxidized grout lines using hard 1px and 3px black borders, with squared panels and no default card radius. - Subway-route topology is drawn with orthogonal CSS grid tracks, circular route bullets, station ticks, and ghosted train-position bars clipped through panels. - Black manga speed-line fields appear as repeating-linear-gradient vectors that cut across negative space like signal direction rather than decoration. - Terminal telemetry uses narrow monospace microcopy, packet IDs, delayed timestamps, raster scan bands, and sparse dim-red alert pips beside service states. - The unseen rider is represented by missing segments, reflected silhouette slivers, transparent route gaps, and labels that describe absence instead of a person. ## Tokens ### Borders - **Accent Width**: 3px - **Character**: Near-invisible grout dividers alternate with heavy black transit sign rules and red exception ticks. - **Default Width**: 1px - **Style**: solid ### Colors | Name | Value | |------|-------| | accent | `#8F1E1A` | | background | `#F7F3EA` | | border | `#D8D1C3` | | error | `#8F1E1A` | | info | `#465D6A` | | muted | `#6B6962` | | primary | `#11100E` | | secondary | `#5C6262` | | success | `#4D6656` | | surface | `#FFFEF8` | | text | `#151411` | | warning | `#8B6A2D` | ### Motion - **Duration**: 640ms - **Easing**: steps(6, end) - **Philosophy**: Movement should feel delayed and hardware-rendered: blink one red pip, advance one ghost bar, or shift a timestamp by steps rather than animate continuously. ### Radii - **Full**: 9999px - **Lg**: 16px - **Md**: 0px - **None**: 0px - **Sm**: 0px ### Shadows - **Lg**: 0 32px 0 rgba(17,16,14,0.06) - **Md**: 0 18px 0 rgba(17,16,14,0.04) - **Sm**: none ### Spacing - **Base**: 8px - **Scale**: [4,8,12,16,24,32,48,64,96] ### Surfaces - **Bg Pattern**: Large off-white field with thin tile grid, overprinted manga speed-line wedges, and clipped route traces. - **Card Style**: Squared station panels: 1px pale grout borders, occasional 3px black service caps, no glow, no glass, no soft radius. - **Treatment**: Warm tile-white surfaces with subtle grout grids, black ink blocks, and CRT raster overlays at 4-7% opacity. ### Typography - **Base Size**: 16px - **Body Font**: Libre Franklin - **Google Fonts Url**: https://fonts.googleapis.com/css2?family=Archivo+Narrow:wght@500;600;700&family=Libre+Franklin:wght@400;500;600;700&family=Martian+Mono:wght@400;500;600&display=swap - **Heading Font**: Archivo Narrow - **Letter Spacing**: -0.02em - **Line Height**: 1.55 - **Mono Font**: Martian Mono - **Scale Ratio**: 1.25 ## Rules ### Composition Build screens as transit artifacts, not dashboards: one dominant map or strip diagram anchors the view, smaller station notices attach as tiled panels, and black speed-line vectors cross boundaries to imply signal flow. Use asymmetry, full-bleed ink bars, and dense annotation clusters against large absent platform-air whitespace. ### Density Alternate dense telemetry knots with wide empty tile fields; the language should feel like a quiet platform monitor where only a few fragments have updated. ### Hierarchy Public-service headings use compressed grotesk uppercase and heavy black bands; operational states use route bullets and red pips; ghost logs use tiny monospace rows. Size, weight, and border thickness must create hierarchy before additional color is added. ### Signature Patterns - Route bullets become packet identifiers: circular colored or black disks with monospace IDs are aligned to orthogonal map lines and service notices. - Ghost gaps interrupt CSS route lines with translucent masks, dashed borders, and labels like SENSOR VOID or RIDER NOT DRAWN to embody absence. - Manga signal vectors use black repeating-linear-gradient wedges that point along the network and overlap tiles without becoming illustration. - CRT service captions use pixel-step blinking red pips, scanline overlays, bracketed timestamps, and narrow monospace alignment for hardware texture. - Station panels are tiled by grout-line borders and black caps, creating modular NYCTA signage rhythm without equal-card SaaS symmetry. ## Layout ### Breakpoints Mobile at 640px collapses to one column with horizontal strip-map sequencing; tablet at 900px keeps a two-column route/notice split; desktop at 1200px unlocks full topology. ### Density High-density diagnostic clusters occupy no more than one third of a composition; the remaining field stays open, tiled, and silent to make absence legible. ### Grid Desktop uses a 12-column transit-grid shell with 16px gutters and a max width of 1320px, allowing map panels to span 7-8 columns and notices to stack asymmetrically. ### Whitespace Whitespace behaves like platform air and missing sensor data: large 64-96px pauses separate route regions, while station ticks and packet rows cluster at 4-12px. ## Guidance ### Do - Start with tile white, black linework, and route topology before adding any accent color. - Use dim red only for exceptions, stale timestamps, vanished reads, or handoff failures. - Represent people through route traces, turnstile events, timestamps, and gaps instead of figures. - Make at least one panel structurally dominant and break the grid with a black vector field or full-bleed route line. - Use monospace telemetry for packet IDs, station codes, scan counts, and ghost logs. - Keep radii square except for route bullets and status pips. - Pair every color-coded state with text, shape, or border-weight changes for accessibility. ### Don't - Do not use green terminal rain, neon gradients, cyberpunk skyline glow, or saturated RGB accents. - Do not create three equal cards in a row or generic metric widgets unrelated to transit. - Do not illustrate anime characters, riders, agents, or hacker avatars. - Do not soften the system with glassmorphism, pill-heavy SaaS controls, or decorative shadows. - Do not use color as decoration; route colors must feel like muted diagnostics. - Do not let manga lines become random texture; they must point, divide, or imply signal motion. - Do not hide essential text in tiny raster labels below readable sizes. ### Accessibility Maintain high contrast for black text on warm white, keep body text at 15-16px with -0.02em tracking, provide text labels for red alerts, and reduce motion to static pips under prefers-reduced-motion. ### Usage Context Best for fictional transit observability, identity-infrastructure tools, speculative civic terminals, route monitoring, and quiet cybernetic story interfaces.
DESIGN.md
---
version: "alpha"
name: "Ghost Packet Metrograph"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
accent: "#8F1E1A"
background: "#F7F3EA"
border: "#D8D1C3"
error: "#8F1E1A"
info: "#465D6A"
muted: "#6B6962"
primary: "#11100E"
secondary: "#5C6262"
success: "#4D6656"
surface: "#FFFEF8"
text: "#151411"
warning: "#8B6A2D"
typography:
headline-lg:
fontFamily: "Archivo Narrow"
fontSize: "1.953rem"
fontWeight: 700
lineHeight: 1.1
letterSpacing: "-0.02em"
headline-md:
fontFamily: "Archivo Narrow"
fontSize: "1.563rem"
fontWeight: 600
lineHeight: 1.15
letterSpacing: "-0.02em"
body-md:
fontFamily: "Libre Franklin"
fontSize: "16px"
fontWeight: 400
lineHeight: 1.55
letterSpacing: "-0.02em"
label-md:
fontFamily: "Martian Mono"
fontSize: "0.75rem"
fontWeight: 600
lineHeight: 1
letterSpacing: "0.08em"
rounded:
full: "9999px"
lg: "16px"
md: "0px"
none: "0px"
sm: "0px"
spacing:
base: "8px"
xs: "4px"
sm: "8px"
md: "12px"
lg: "16px"
xl: "24px"
2xl: "32px"
3xl: "48px"
4xl: "64px"
step-8: "96px"
components:
color-reference-accent:
backgroundColor: "{colors.accent}"
color-reference-background:
backgroundColor: "{colors.background}"
color-reference-border:
backgroundColor: "{colors.border}"
color-reference-error:
backgroundColor: "{colors.error}"
color-reference-info:
backgroundColor: "{colors.info}"
color-reference-muted:
backgroundColor: "{colors.muted}"
color-reference-primary:
backgroundColor: "{colors.primary}"
color-reference-secondary:
backgroundColor: "{colors.secondary}"
color-reference-success:
backgroundColor: "{colors.success}"
color-reference-surface:
backgroundColor: "{colors.surface}"
color-reference-text:
backgroundColor: "{colors.text}"
color-reference-warning:
backgroundColor: "{colors.warning}"
button-primary:
backgroundColor: "{colors.primary}"
textColor: "#ffffff"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
card-surface:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
input-default:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.md}"
height: "44px"
---
# Ghost Packet Metrograph
## Overview
Ghost Packet Metrograph treats a metropolitan rail network as a haunted packet-switching instrument: the rider is never drawn, only inferred from route deltas, turnstile ticks, delayed timestamps, and gaps in sensor coverage. It borrows the discipline of NYCTA modular wayfinding, manga black motion grammar, and late-90s terminal telemetry without becoming a neon cyberpunk dashboard.
### Values
- Infrastructure over character: presence is shown through traces, missed reads, handoffs, and absences rather than illustrated avatars.
- Civic clarity first: public hierarchy uses direct transit typography, blunt labels, route bullets, and legible service language.
- Monochrome pressure: black ink, tile white, and warm paper create most of the identity before color is allowed.
- Error as atmosphere: dim red pips, cancelled service strips, and stale timestamps carry tension without spectacle.
- Diagrammatic embodiment: every decorative mark must also read as route geometry, signal vector, station tile, or telemetry artifact.
- Temporal quiet: motion is sparse, delayed, and diagnostic, like a monitor noticing an afterimage too late.
### Anti-Values
- No green matrix rain, neon city glow, or luminous hacker fantasy palettes.
- No equal SaaS card grids, generic analytics widgets, or decorative dashboard filler.
- No anime character portraits; the network presence must remain unseen and infrastructural.
- No glossy rounded surfaces, glassmorphism, or friendly app softness that weakens the transit-system severity.
### Visual Character
- Tile-white page grounds are divided by oxidized grout lines using hard 1px and 3px black borders, with squared panels and no default card radius.
- Subway-route topology is drawn with orthogonal CSS grid tracks, circular route bullets, station ticks, and ghosted train-position bars clipped through panels.
- Black manga speed-line fields appear as repeating-linear-gradient vectors that cut across negative space like signal direction rather than decoration.
- Terminal telemetry uses narrow monospace microcopy, packet IDs, delayed timestamps, raster scan bands, and sparse dim-red alert pips beside service states.
- The unseen rider is represented by missing segments, reflected silhouette slivers, transparent route gaps, and labels that describe absence instead of a person.
## 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 | `#8F1E1A` |
| background | `#F7F3EA` |
| border | `#D8D1C3` |
| error | `#8F1E1A` |
| info | `#465D6A` |
| muted | `#6B6962` |
| primary | `#11100E` |
| secondary | `#5C6262` |
| success | `#4D6656` |
| surface | `#FFFEF8` |
| text | `#151411` |
| warning | `#8B6A2D` |
## Typography
- **Headline-Lg**: Archivo Narrow, 1.953rem, weight 700, line-height 1.1.
- **Headline-Md**: Archivo Narrow, 1.563rem, weight 600, line-height 1.15.
- **Body-Md**: Libre Franklin, 16px, weight 400, line-height 1.55.
- **Label-Md**: Martian 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`
- **Step-8**: `96px`
### Breakpoints
Mobile at 640px collapses to one column with horizontal strip-map sequencing; tablet at 900px keeps a two-column route/notice split; desktop at 1200px unlocks full topology.
### Density
High-density diagnostic clusters occupy no more than one third of a composition; the remaining field stays open, tiled, and silent to make absence legible.
### Grid
Desktop uses a 12-column transit-grid shell with 16px gutters and a max width of 1320px, allowing map panels to span 7-8 columns and notices to stack asymmetrically.
### Whitespace
Whitespace behaves like platform air and missing sensor data: large 64-96px pauses separate route regions, while station ticks and packet rows cluster at 4-12px.
## Elevation & Depth
### Shadows
- **Lg**: 0 32px 0 rgba(17,16,14,0.06)
- **Md**: 0 18px 0 rgba(17,16,14,0.04)
- **Sm**: none
## Shapes
### Rounded
- **Full**: `9999px`
- **Lg**: `16px`
- **Md**: `0px`
- **None**: `0px`
- **Sm**: `0px`
### Surfaces
- **Bg Pattern**: Large off-white field with thin tile grid, overprinted manga speed-line wedges, and clipped route traces.
- **Card Style**: Squared station panels: 1px pale grout borders, occasional 3px black service caps, no glow, no glass, no soft radius.
- **Treatment**: Warm tile-white surfaces with subtle grout grids, black ink blocks, and CRT raster overlays at 4-7% opacity.
### Borders
- **Accent Width**: 3px
- **Character**: Near-invisible grout dividers alternate with heavy black transit sign rules and red exception ticks.
- **Default Width**: 1px
- **Style**: solid
## Components
### Composition
Build screens as transit artifacts, not dashboards: one dominant map or strip diagram anchors the view, smaller station notices attach as tiled panels, and black speed-line vectors cross boundaries to imply signal flow. Use asymmetry, full-bleed ink bars, and dense annotation clusters against large absent platform-air whitespace.
### Density
Alternate dense telemetry knots with wide empty tile fields; the language should feel like a quiet platform monitor where only a few fragments have updated.
### Hierarchy
Public-service headings use compressed grotesk uppercase and heavy black bands; operational states use route bullets and red pips; ghost logs use tiny monospace rows. Size, weight, and border thickness must create hierarchy before additional color is added.
### Signature Patterns
- Route bullets become packet identifiers: circular colored or black disks with monospace IDs are aligned to orthogonal map lines and service notices.
- Ghost gaps interrupt CSS route lines with translucent masks, dashed borders, and labels like SENSOR VOID or RIDER NOT DRAWN to embody absence.
- Manga signal vectors use black repeating-linear-gradient wedges that point along the network and overlap tiles without becoming illustration.
- CRT service captions use pixel-step blinking red pips, scanline overlays, bracketed timestamps, and narrow monospace alignment for hardware texture.
- Station panels are tiled by grout-line borders and black caps, creating modular NYCTA signage rhythm without equal-card SaaS symmetry.
## 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/ghost-packet-metrograph/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 Start with tile white, black linework, and route topology before adding any accent color.
- Do Use dim red only for exceptions, stale timestamps, vanished reads, or handoff failures.
- Do Represent people through route traces, turnstile events, timestamps, and gaps instead of figures.
- Do Make at least one panel structurally dominant and break the grid with a black vector field or full-bleed route line.
- Do Use monospace telemetry for packet IDs, station codes, scan counts, and ghost logs.
- Do Keep radii square except for route bullets and status pips.
- Do Pair every color-coded state with text, shape, or border-weight changes for accessibility.
- Don't Do not use green terminal rain, neon gradients, cyberpunk skyline glow, or saturated RGB accents.
- Don't Do not create three equal cards in a row or generic metric widgets unrelated to transit.
- Don't Do not illustrate anime characters, riders, agents, or hacker avatars.
- Don't Do not soften the system with glassmorphism, pill-heavy SaaS controls, or decorative shadows.
- Don't Do not use color as decoration; route colors must feel like muted diagnostics.
- Don't Do not let manga lines become random texture; they must point, divide, or imply signal motion.
- Don't Do not hide essential text in tiny raster labels below readable sizes.
### Accessibility
Maintain high contrast for black text on warm white, keep body text at 15-16px with -0.02em tracking, provide text labels for red alerts, and reduce motion to static pips under prefers-reduced-motion.
### Usage Context
Best for fictional transit observability, identity-infrastructure tools, speculative civic terminals, route monitoring, and quiet cybernetic story interfaces.
shadcn/ui theme
```json
{
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
"name": "ghost-packet-metrograph",
"type": "registry:theme",
"title": "Ghost Packet Metrograph shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#F7F3EA",
"foreground": "#151411",
"card": "#FFFEF8",
"card-foreground": "#151411",
"popover": "#FFFEF8",
"popover-foreground": "#151411",
"primary": "#11100E",
"primary-foreground": "#ffffff",
"secondary": "#5C6262",
"secondary-foreground": "#ffffff",
"muted": "#6B6962",
"muted-foreground": "#151411",
"accent": "#8F1E1A",
"accent-foreground": "#ffffff",
"destructive": "#8F1E1A",
"border": "#D8D1C3",
"input": "#D8D1C3",
"ring": "#8F1E1A",
"chart-1": "#11100E",
"chart-2": "#5C6262",
"chart-3": "#8F1E1A",
"chart-4": "#4D6656",
"chart-5": "#8B6A2D",
"sidebar": "#FFFEF8",
"sidebar-foreground": "#151411",
"sidebar-primary": "#11100E",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#465D6A",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#D8D1C3",
"sidebar-ring": "#8F1E1A",
"radius": "0px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#11100E",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#8F1E1A",
"accent-foreground": "#ffffff",
"destructive": "#8F1E1A",
"border": "#303642",
"input": "#303642",
"ring": "#8F1E1A",
"chart-1": "#11100E",
"chart-2": "#5C6262",
"chart-3": "#8F1E1A",
"chart-4": "#4D6656",
"chart-5": "#8B6A2D",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#11100E",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#8F1E1A",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#303642",
"sidebar-ring": "#8F1E1A",
"radius": "0px"
}
},
"meta": {
"source": "katagami",
"languageId": "ghost-packet-metrograph",
"slug": "ghost-packet-metrograph",
"componentManifest": [
"button",
"card",
"input",
"textarea",
"select",
"dialog",
"sheet",
"tabs",
"badge",
"separator",
"checkbox",
"switch",
"slider",
"tooltip",
"dropdown-menu",
"table"
],
"installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
"nativeTokenNames": {
"borders": [
"accent_width",
"character",
"default_width",
"style"
],
"colors": [
"accent",
"background",
"border",
"error",
"info",
"muted",
"primary",
"secondary",
"success",
"surface",
"text",
"warning"
],
"motion": [
"duration",
"easing",
"philosophy"
],
"radii": [
"full",
"lg",
"md",
"none",
"sm"
],
"shadows": [
"lg",
"md",
"sm"
],
"spacing": [
"base",
"scale"
],
"surfaces": [
"bg_pattern",
"card_style",
"treatment"
],
"typography": [
"base_size",
"body_font",
"google_fonts_url",
"heading_font",
"letter_spacing",
"line_height",
"mono_font",
"scale_ratio"
]
}
}
}
```embodiments
at a glance
Typography
The quick brown fox jumps
The quick brown fox jumps
The quick brown fox jumps
The quick brown fox jumps
Components
Components rendered with this language’s tokens — colors, type, and rounded corners as specified.
Spacing
- base8px
- xs4px
- sm8px
- md12px
- lg16px
- xl24px
- 2xl32px
- 3xl48px
- 4xl64px
- step-896px
Shape
implementation kit
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
npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table:root {
--background: #F7F3EA;
--foreground: #151411;
--card: #FFFEF8;
--card-foreground: #151411;
--popover: #FFFEF8;
--popover-foreground: #151411;
--primary: #11100E;
--primary-foreground: #ffffff;
--secondary: #5C6262;
--secondary-foreground: #ffffff;
--muted: #6B6962;
--muted-foreground: #151411;
--accent: #8F1E1A;
--accent-foreground: #ffffff;
--destructive: #8F1E1A;
--border: #D8D1C3;
--input: #D8D1C3;
--ring: #8F1E1A;
--chart-1: #11100E;
--chart-2: #5C6262;
--chart-3: #8F1E1A;
--chart-4: #4D6656;
--chart-5: #8B6A2D;
--sidebar: #FFFEF8;
--sidebar-foreground: #151411;
--sidebar-primary: #11100E;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #465D6A;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #D8D1C3;
--sidebar-ring: #8F1E1A;
--radius: 0px;
}
.dark {
--background: #0f1115;
--foreground: #f8fafc;
--card: #181b22;
--card-foreground: #f8fafc;
--popover: #181b22;
--popover-foreground: #f8fafc;
--primary: #11100E;
--primary-foreground: #ffffff;
--secondary: #252a33;
--secondary-foreground: #f8fafc;
--muted: #252a33;
--muted-foreground: #a1a1aa;
--accent: #8F1E1A;
--accent-foreground: #ffffff;
--destructive: #8F1E1A;
--border: #303642;
--input: #303642;
--ring: #8F1E1A;
--chart-1: #11100E;
--chart-2: #5C6262;
--chart-3: #8F1E1A;
--chart-4: #4D6656;
--chart-5: #8B6A2D;
--sidebar: #181b22;
--sidebar-foreground: #f8fafc;
--sidebar-primary: #11100E;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #8F1E1A;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #303642;
--sidebar-ring: #8F1E1A;
--radius: 0px;
}
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 GhostPacketMetrographShadcnKit() {
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">Ghost Packet Metrograph</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>
);
}
{
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
"name": "ghost-packet-metrograph",
"type": "registry:theme",
"title": "Ghost Packet Metrograph shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#F7F3EA",
"foreground": "#151411",
"card": "#FFFEF8",
"card-foreground": "#151411",
"popover": "#FFFEF8",
"popover-foreground": "#151411",
"primary": "#11100E",
"primary-foreground": "#ffffff",
"secondary": "#5C6262",
"secondary-foreground": "#ffffff",
"muted": "#6B6962",
"muted-foreground": "#151411",
"accent": "#8F1E1A",
"accent-foreground": "#ffffff",
"destructive": "#8F1E1A",
"border": "#D8D1C3",
"input": "#D8D1C3",
"ring": "#8F1E1A",
"chart-1": "#11100E",
"chart-2": "#5C6262",
"chart-3": "#8F1E1A",
"chart-4": "#4D6656",
"chart-5": "#8B6A2D",
"sidebar": "#FFFEF8",
"sidebar-foreground": "#151411",
"sidebar-primary": "#11100E",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#465D6A",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#D8D1C3",
"sidebar-ring": "#8F1E1A",
"radius": "0px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#11100E",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#8F1E1A",
"accent-foreground": "#ffffff",
"destructive": "#8F1E1A",
"border": "#303642",
"input": "#303642",
"ring": "#8F1E1A",
"chart-1": "#11100E",
"chart-2": "#5C6262",
"chart-3": "#8F1E1A",
"chart-4": "#4D6656",
"chart-5": "#8B6A2D",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#11100E",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#8F1E1A",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#303642",
"sidebar-ring": "#8F1E1A",
"radius": "0px"
}
},
"meta": {
"source": "katagami",
"languageId": "ghost-packet-metrograph",
"slug": "ghost-packet-metrograph",
"componentManifest": [
"button",
"card",
"input",
"textarea",
"select",
"dialog",
"sheet",
"tabs",
"badge",
"separator",
"checkbox",
"switch",
"slider",
"tooltip",
"dropdown-menu",
"table"
],
"installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
"nativeTokenNames": {
"borders": [
"accent_width",
"character",
"default_width",
"style"
],
"colors": [
"accent",
"background",
"border",
"error",
"info",
"muted",
"primary",
"secondary",
"success",
"surface",
"text",
"warning"
],
"motion": [
"duration",
"easing",
"philosophy"
],
"radii": [
"full",
"lg",
"md",
"none",
"sm"
],
"shadows": [
"lg",
"md",
"sm"
],
"spacing": [
"base",
"scale"
],
"surfaces": [
"bg_pattern",
"card_style",
"treatment"
],
"typography": [
"base_size",
"body_font",
"google_fonts_url",
"heading_font",
"letter_spacing",
"line_height",
"mono_font",
"scale_ratio"
]
}
}
}
# Ghost Packet Metrograph shadcn/ui Components
Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `ghost-packet-metrograph`
Slug: `ghost-packet-metrograph`
## Intent
Ghost Packet Metrograph treats a metropolitan rail network as a haunted packet-switching instrument: the rider is never drawn, only inferred from route deltas, turnstile ticks, delayed timestamps, and gaps in sensor coverage. It borrows the discipline of NYCTA modular wayfinding, manga black motion grammar, and late-90s terminal telemetry without becoming a neon cyberpunk dashboard.
## 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:
{
"accent": "#8F1E1A",
"background": "#F7F3EA",
"border": "#D8D1C3",
"error": "#8F1E1A",
"info": "#465D6A",
"muted": "#6B6962",
"primary": "#11100E",
"secondary": "#5C6262",
"success": "#4D6656",
"surface": "#FFFEF8",
"text": "#151411",
"warning": "#8B6A2D"
}
Typography:
{
"base_size": "16px",
"body_font": "Libre Franklin",
"google_fonts_url": "https://fonts.googleapis.com/css2?family=Archivo+Narrow:wght@500;600;700&family=Libre+Franklin:wght@400;500;600;700&family=Martian+Mono:wght@400;500;600&display=swap",
"heading_font": "Archivo Narrow",
"letter_spacing": "-0.02em",
"line_height": 1.55,
"mono_font": "Martian Mono",
"scale_ratio": 1.25
}
## Visual character to preserve
- Tile-white page grounds are divided by oxidized grout lines using hard 1px and 3px black borders, with squared panels and no default card radius.
- Subway-route topology is drawn with orthogonal CSS grid tracks, circular route bullets, station ticks, and ghosted train-position bars clipped through panels.
- Black manga speed-line fields appear as repeating-linear-gradient vectors that cut across negative space like signal direction rather than decoration.
- Terminal telemetry uses narrow monospace microcopy, packet IDs, delayed timestamps, raster scan bands, and sparse dim-red alert pips beside service states.
- The unseen rider is represented by missing segments, reflected silhouette slivers, transparent route gaps, and labels that describe absence instead of a person.
## ShadSync visual profile
{
"family": "brutalist",
"material": "ink",
"contour": "default",
"border": "dashed",
"underlay": false,
"grain": true,
"stickerBadges": true,
"motion": "still",
"density": "balanced",
"accents": [
"primary",
"accent",
"secondary",
"muted"
]
}
## Signature component recipes
### Button
Use `Button` for primary, secondary, outline, and ghost actions. Primary actions must expose the language's strongest contrast pair, while secondary and ghost actions should preserve the surface treatment instead of falling back to default neutral SaaS styling.
### Card
Use `Card`, `CardHeader`, `CardContent`, `CardFooter`, and `CardAction` as the main composition frame. Cards should demonstrate the language's surface, border, hierarchy, and density rules rather than appearing as generic rounded rectangles.
### Input and Textarea
Use `Input` and `Textarea` with visible focus rings, field labels, validation states, and the language's rhythm. Forms should show real product content, not placeholder-only controls.
### Select, Tabs, and Table
Use `Select`, `Tabs`, and `Table` to prove navigation, filtering, and dense data states. The table should show row rhythm, separators, hover/focus states, and an empty or status state when the language calls for it.
### Dialog and Sheet
Use `Dialog` for centered decisions and `Sheet` for contextual editing. Both should inherit the language's spacing, border, overlay, and motion rules.
## Preview shots
- `application-shell`: dashboard or workspace shell with navigation, cards, forms, and state badges.
- `detail-editor`: focused editing flow using input, textarea, select, switch/checkbox, dialog or sheet, and action buttons.
- `data-operations`: table-heavy operational view with tabs, dropdown menu affordances, badges, and destructive/empty states.
- Each preview shot must include a renderable `scene` payload with concrete headline, description, actions, and rows/fields/stats for the UI preview.
## Implementation contract
- Start from local `ui/src/components/ui` shadcn-style primitives; do not create a second component system.
- Apply `/katagami/shadcn/ghost-packet-metrograph/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: Start with tile white, black linework, and route topology before adding any accent color.; Use dim red only for exceptions, stale timestamps, vanished reads, or handoff failures.; Represent people through route traces, turnstile events, timestamps, and gaps instead of figures.; Make at least one panel structurally dominant and break the grid with a black vector field or full-bleed route line.; Use monospace telemetry for packet IDs, station codes, scan counts, and ghost logs.; Keep radii square except for route bullets and status pips.; Pair every color-coded state with text, shape, or border-weight changes for accessibility.
- Do not: Do not use green terminal rain, neon gradients, cyberpunk skyline glow, or saturated RGB accents.; Do not create three equal cards in a row or generic metric widgets unrelated to transit.; Do not illustrate anime characters, riders, agents, or hacker avatars.; Do not soften the system with glassmorphism, pill-heavy SaaS controls, or decorative shadows.; Do not use color as decoration; route colors must feel like muted diagnostics.; Do not let manga lines become random texture; they must point, divide, or imply signal motion.; Do not hide essential text in tiny raster labels below readable sizes.
## 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 GhostPacketMetrographShadcnKit() {
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">Ghost Packet Metrograph</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
{
"breakpoints": "Mobile at 640px collapses to one column with horizontal strip-map sequencing; tablet at 900px keeps a two-column route/notice split; desktop at 1200px unlocks full topology.",
"density": "High-density diagnostic clusters occupy no more than one third of a composition; the remaining field stays open, tiled, and silent to make absence legible.",
"grid": "Desktop uses a 12-column transit-grid shell with 16px gutters and a max width of 1320px, allowing map panels to span 7-8 columns and notices to stack asymmetrically.",
"whitespace": "Whitespace behaves like platform air and missing sensor data: large 64-96px pauses separate route regions, while station ticks and packet rows cluster at 4-12px."
}
{
"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": "ghost-packet-metrograph",
"name": "Ghost Packet Metrograph",
"slug": "ghost-packet-metrograph"
},
"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": [
"Tile-white page grounds are divided by oxidized grout lines using hard 1px and 3px black borders, with squared panels and no default card radius.",
"Subway-route topology is drawn with orthogonal CSS grid tracks, circular route bullets, station ticks, and ghosted train-position bars clipped through panels.",
"Black manga speed-line fields appear as repeating-linear-gradient vectors that cut across negative space like signal direction rather than decoration.",
"Terminal telemetry uses narrow monospace microcopy, packet IDs, delayed timestamps, raster scan bands, and sparse dim-red alert pips beside service states.",
"The unseen rider is represented by missing segments, reflected silhouette slivers, transparent route gaps, and labels that describe absence instead of a person."
],
"visualProfile": {
"family": "brutalist",
"material": "ink",
"contour": "default",
"border": "dashed",
"underlay": false,
"grain": true,
"stickerBadges": true,
"motion": "still",
"density": "balanced",
"accents": [
"primary",
"accent",
"secondary",
"muted"
]
},
"shots": [
{
"id": "application-shell",
"title": "Application shell",
"viewport": "desktop",
"primitives": [
"button",
"card",
"input",
"select",
"tabs",
"badge",
"separator",
"table"
],
"composition": "A real product workspace with navigation, summary cards, filtering controls, and one dense content region.",
"mustShow": [
"primary and secondary actions",
"card hierarchy",
"filterable state",
"table or list density"
],
"avoid": [
"component inventory walls",
"placeholder-only content",
"generic rounded SaaS chrome"
],
"scene": {
"eyebrow": "workspace spread",
"headline": "Ghost Packet Metrograph 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": [
"Start with tile white, black linework, and route topology before adding any accent color.",
"Use dim red only for exceptions, stale timestamps, vanished reads, or handoff failures.",
"Represent people through route traces, turnstile events, timestamps, and gaps instead of figures.",
"Make at least one panel structurally dominant and break the grid with a black vector field or full-bleed route line.",
"Use monospace telemetry for packet IDs, station codes, scan counts, and ghost logs.",
"Keep radii square except for route bullets and status pips.",
"Pair every color-coded state with text, shape, or border-weight changes for accessibility."
],
"dont": [
"Do not use green terminal rain, neon gradients, cyberpunk skyline glow, or saturated RGB accents.",
"Do not create three equal cards in a row or generic metric widgets unrelated to transit.",
"Do not illustrate anime characters, riders, agents, or hacker avatars.",
"Do not soften the system with glassmorphism, pill-heavy SaaS controls, or decorative shadows.",
"Do not use color as decoration; route colors must feel like muted diagnostics.",
"Do not let manga lines become random texture; they must point, divide, or imply signal motion.",
"Do not hide essential text in tiny raster labels below readable sizes."
]
}
}