back to gallery
design language·ghost-packet-metrograph

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.

the spec

specification

philosophy
summary
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.
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
accent
#8F1E1A
background
#F7F3EA
border
#D8D1C3
error
#8F1E1A
info
#465D6A
muted
#6B6962
primary
#11100E
secondary
#5C6262
success
#4D6656
surface
#FFFEF8
text
#151411
warning
#8B6A2D
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
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.
avoid
  • 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"
      ]
    }
  }
}
```
in the wild

embodiments

Design Language Preview

Ghost Packet Metrograph

Color Palette

primary
secondary
accent
background
surface
text
muted
border
error
success
warning
info

Typography

h1

Heading One

h2

Heading Two

h3

Heading Three

h4

Heading Four

body

Body text demonstrates the reading experience. Good typography is invisible — it lets the content speak without drawing attention to the letterforms themselves.

caption

Caption text for supplementary information and metadata.

code
const theme = applyTokens(designLanguage);
render(<App theme={theme} />);

Buttons

Form Controls

Navigation

tabs
Overview content area with contextual information about the design language.
segmented control
dropdown menu

Feedback & Status

badges
NewDefaultActivePendingErrorOutline
alerts
Info: A new version is available.
Success: Changes saved successfully.
Warning: Storage is almost full.
Error: Failed to process request.
progress
66% complete
tooltip
avatar
AKJDML

Containers & Overlays

card

Card Title

Cards group related content and actions. This example shows a basic content card with a title and description.

accordion

Design tokens are the atomic values of a design system — colors, spacing, typography, and other values stored as key-value pairs.

dialog
separator

Data Display

table
NameStatusCategoryScore
Neo BrutalismPublishedMaximalist94
Aero GlassDraftSpatial87
Signal UIReviewEnterprise91
stat cards
Languages
42
+12%
Elements
3,150
+8%
Usage
18.4k
+23%
DESIGN.md

at a glance

Palette

Typography

headline-lgArchivo Narrow · 31px · 700

The quick brown fox jumps

headline-mdArchivo Narrow · 25px · 600

The quick brown fox jumps

body-mdLibre Franklin · 16px · 400

The quick brown fox jumps

label-mdMartian 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
  • step-896px

Shape

full9999px
lg16px
md0px
none0px
sm0px
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.
primaryaccentsurfacemutedwarning
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: #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;
}
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 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>
  );
}
theme JSONcompatibility fallback
{
  "$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"
      ]
    }
  }
}
component recipescompatibility fallback
# 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."
}
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": "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."
    ]
  }
}
related

More like this