back to gallery
design language·silent-shell-manga-noir

Silent Shell Manga Noir

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
Silent Shell Manga Noir is a restrained interface language for products that feel like a calm terminal session unfolding inside a black-and-white seinen manga. It rejects cyberpunk spectacle in favor of precise ink, large quiet voids, cropped human-machine fragments, command syntax, and diagnostic overlays that read like subtitles. The system treats negative space as evidence: every panel, gutter, prompt, cursor, and scan mark exists because it advances an existential technical narrative. Its emotional register is nocturnal and controlled, with sparse signal color reserved only for active state, rupture, or a verified system hit.
values
Near-binary restraint: black ink, warm paper, grayscale tone, and one scarce phosphor signal are enough to build the whole world.Panel rhythm over dashboard rhythm: composition should feel sequenced, cropped, and cinematic rather than tiled into equal product cards.Terminal syntax as voice: commands, flags, paths, status codes, and cursors carry hierarchy more than decorative icons.Quiet voids as meaning: empty off-white and ink-black fields must be protected as active spatial material, not filled with content.Human-machine intimacy: cropped faces, hands, cables, ports, and diagnostic fragments make the interface feel embodied without illustration overload.Y2K technical precision: rule lines, scan bars, labels, and bracketed metadata are crisp and engineered, never chaotic or ornamental.Emotional restraint: errors and successes are shown with small signals, clipped language, and calibrated contrast rather than celebratory color.
anti-values
×Neon city spectacle, rainbow cyberpunk, glow-heavy sci-fi, or saturated triadic accents.×Generic SaaS dashboards, equal cards, bubbly rounded surfaces, and decorative charts that have no narrative function.×Busy hacker clutter: matrix rain, excessive ASCII, illegible tiny labels, and faux complexity used to fill space.×Soft lifestyle anime color palettes, cute mascot energy, and expressive comic effects that break the noir calm.
tokens
borders4 items
accent width
6px
character
Hairline manga frames with sudden heavy ink bars for title-card emphasis.
default width
1px
style
solid
colors12 items
accent
#6fd18a
background
#f2eee4
border
#111111
error
#8f2e25
info
#4f6f83
muted
#6b6860
primary
#050505
secondary
#f4f0e7
success
#4d8d5e
surface
#fffaf0
text
#080808
warning
#a87926
motion3 items
duration
160ms
easing
steps(2, end)
philosophy
Motion should feel like a terminal repaint or cursor state change: abrupt, sparse, and never cinematic.
radii5 items
full
9999px
lg
0
md
0
none
0
sm
0
shadows3 items
lg
inset 0 0 0 1px #111111
md
none
sm
none
spacing2 items
base
8px
scale
4, 8, 12, 16, 24, 32, 48, 64, 96, 128
surfaces3 items
bg pattern
Sparse halftone fields, scanline overlays at 1px intervals, and large unmarked paper voids.
card style
Square-corner bordered panels with clipped image fragments, terminal captions, and deliberately uneven content density.
treatment
Warm paper ground with flat ink panels, no gradients, no glow, and grayscale screentone built from repeating-radial-gradient only.
typography10 items
base size
16px
body font
IBM Plex Sans Condensed
display letter spacing
-0.035em
display line height
1.08
google fonts url
https://fonts.googleapis.com/css2?family=Bebas+Neue&family=Fragment+Mono:ital@0;1&family=IBM+Plex+Sans+Condensed:wght@400;500;600;700&display=swap
heading font
Bebas Neue
letter spacing
-0.02em
line height
1.55
mono font
Fragment Mono
scale ratio
1.25
rules
composition
Use asymmetric manga sequencing: one dominant cinematic panel, one quiet void, one dense diagnostic cluster, and narrow gutter-based metadata strips. Avoid equal columns except for small status cells. Cropping should imply off-screen continuation, especially around faces, hands, cable bundles, and shell output. Large black or paper blocks may interrupt the grid like title cards. Keep content aligned to strong vertical/horizontal axes so the noir calm remains precise.
density
Alternate 96px to 128px quiet fields with 4px to 12px terminal micro-gaps. The screen must contain one highly dense diagnostic pane, but it should be surrounded by restraint so complexity feels intentional.
hierarchy
Primary hierarchy comes from scale contrast between compressed title typography, tiny monospace prompt lines, and black panel mass. Active elements use the single phosphor accent only on cursor, selected command, scan hit, or rupture state. Labels are uppercase condensed grotesque with wide section numbering; body text stays clipped, factual, and short.
signature patterns
Manga gutter grid: CSS grid areas separated by fixed warm-paper gutters, with non-equal panel spans and one full-bleed black title band.Subtitle terminal overlays: absolute-positioned command panes anchored to panel bottoms with prompt glyphs, paths, flags, and a phosphor block cursor.Halftone-human fragments: cropped CSS silhouettes using clip-path, radial screentone texture, cable rules, and no illustrative color.Rupture accent protocol: the green accent appears only on active cursor, scan-hit rule, and one existential warning word, never as broad decoration.
layout
breakpoints
desktop
1025px+ twelve-column cinematic grid
mobile
0-640px single panel stack
tablet
641-1024px six-column sequence
density
Mixed-density layout with one dense command cluster balanced by large voids; this preserves the contemplative shell-session mood while still proving interface utility.
grid
Desktop uses a 12-column manga page grid with 16px gutters, max-width 1320px, asymmetric spans of 5/7, 3/4/5, and black full-width bands. Tablet collapses to 6 columns; mobile becomes a single sequenced panel stack.
responsive
On smaller screens, title bands remain oversized, terminal overlays become static captions, and cropped fragments simplify so the command voice remains readable.
whitespace
Whitespace is architectural: minimum internal panel padding is 16px, quiet fields expand to 96px or more, and unrelated panels are separated by visible paper gutters rather than soft margins.
guidance
do
  • Start with black, off-white, and grayscale; add phosphor green only after identifying a true active state.
  • Create one dominant cropped panel rather than distributing visual weight evenly across cards.
  • Use real command syntax, paths, flags, timestamps, and terse diagnostics to make UI text feel operational.
  • Let empty paper or ink occupy large areas; a quiet void is a valid component in this language.
  • Use square corners, hairline borders, heavy black bands, and fixed gutters to preserve manga page structure.
  • Crop human-machine fragments aggressively so they feel cinematic, not illustrative or mascot-like.
  • Keep labels condensed, uppercase, and short; keep explanatory copy minimal and emotionally restrained.
  • Show active state with cursor blocks, scan-hit rules, or single-word warnings rather than buttons full of color.
avoid
  • Do not use neon gradients, city skylines, holographic glass, glow stacks, or rainbow cyberpunk palettes.
  • Do not build a generic analytics dashboard, CRM, kanban board, or three equal feature cards.
  • Do not add decorative code rain, random binary, lorem ipsum logs, or pseudo-technical clutter.
  • Do not round panels, add drop shadows, or soften the system into a friendly SaaS aesthetic.
  • Do not use the accent for charts, backgrounds, secondary buttons, or general brand decoration.
  • Do not rely on anime screenshots; evoke manga and 90s/2000s interfaces through structure and typography.
  • Do not place every section at the same density or scale; alternate void, title, fragment, and diagnostic moments.
katagami spec
# Silent Shell Manga Noir

## Philosophy

Silent Shell Manga Noir is a restrained interface language for products that feel like a calm terminal session unfolding inside a black-and-white seinen manga. It rejects cyberpunk spectacle in favor of precise ink, large quiet voids, cropped human-machine fragments, command syntax, and diagnostic overlays that read like subtitles. The system treats negative space as evidence: every panel, gutter, prompt, cursor, and scan mark exists because it advances an existential technical narrative. Its emotional register is nocturnal and controlled, with sparse signal color reserved only for active state, rupture, or a verified system hit.

### Values

- Near-binary restraint: black ink, warm paper, grayscale tone, and one scarce phosphor signal are enough to build the whole world.
- Panel rhythm over dashboard rhythm: composition should feel sequenced, cropped, and cinematic rather than tiled into equal product cards.
- Terminal syntax as voice: commands, flags, paths, status codes, and cursors carry hierarchy more than decorative icons.
- Quiet voids as meaning: empty off-white and ink-black fields must be protected as active spatial material, not filled with content.
- Human-machine intimacy: cropped faces, hands, cables, ports, and diagnostic fragments make the interface feel embodied without illustration overload.
- Y2K technical precision: rule lines, scan bars, labels, and bracketed metadata are crisp and engineered, never chaotic or ornamental.
- Emotional restraint: errors and successes are shown with small signals, clipped language, and calibrated contrast rather than celebratory color.

### Anti-Values

- Neon city spectacle, rainbow cyberpunk, glow-heavy sci-fi, or saturated triadic accents.
- Generic SaaS dashboards, equal cards, bubbly rounded surfaces, and decorative charts that have no narrative function.
- Busy hacker clutter: matrix rain, excessive ASCII, illegible tiny labels, and faux complexity used to fill space.
- Soft lifestyle anime color palettes, cute mascot energy, and expressive comic effects that break the noir calm.

### Visual Character

- Use hard rectangular manga panels with 1px ink borders, deliberate white gutters, and occasional thick black title-card bands spanning across the grid.
- Reserve at least one full-height negative-space field where tiny monospace command lines float like subtitles near the lower edge.
- Overlay terminal panes as transparent off-white or ink blocks with prompt prefixes, bracketed labels, scanline backgrounds, and a single phosphor cursor accent.
- Crop figurative silhouettes, hands, and cables with CSS clip-path blocks and halftone radial patterns so they read as manga fragments rather than illustrations.
- Set display typography in compressed uppercase noir title cards, body labels in condensed grotesque, and command voice in monospace with strict negative tracking.

## Tokens

### Borders

- **Accent Width**: 6px
- **Character**: Hairline manga frames with sudden heavy ink bars for title-card emphasis.
- **Default Width**: 1px
- **Style**: solid

### Colors

| Name | Value |
|------|-------|
| accent | `#6fd18a` |
| background | `#f2eee4` |
| border | `#111111` |
| error | `#8f2e25` |
| info | `#4f6f83` |
| muted | `#6b6860` |
| primary | `#050505` |
| secondary | `#f4f0e7` |
| success | `#4d8d5e` |
| surface | `#fffaf0` |
| text | `#080808` |
| warning | `#a87926` |

### Motion

- **Duration**: 160ms
- **Easing**: steps(2, end)
- **Philosophy**: Motion should feel like a terminal repaint or cursor state change: abrupt, sparse, and never cinematic.

### Radii

- **Full**: 9999px
- **Lg**: 0
- **Md**: 0
- **None**: 0
- **Sm**: 0

### Shadows

- **Lg**: inset 0 0 0 1px #111111
- **Md**: none
- **Sm**: none

### Spacing

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

### Surfaces

- **Bg Pattern**: Sparse halftone fields, scanline overlays at 1px intervals, and large unmarked paper voids.
- **Card Style**: Square-corner bordered panels with clipped image fragments, terminal captions, and deliberately uneven content density.
- **Treatment**: Warm paper ground with flat ink panels, no gradients, no glow, and grayscale screentone built from repeating-radial-gradient only.

### Typography

- **Base Size**: 16px
- **Body Font**: IBM Plex Sans Condensed
- **Display Letter Spacing**: -0.035em
- **Display Line Height**: 1.08
- **Google Fonts Url**: https://fonts.googleapis.com/css2?family=Bebas+Neue&family=Fragment+Mono:ital@0;1&family=IBM+Plex+Sans+Condensed:wght@400;500;600;700&display=swap
- **Heading Font**: Bebas Neue
- **Letter Spacing**: -0.02em
- **Line Height**: 1.55
- **Mono Font**: Fragment Mono
- **Scale Ratio**: 1.25

## Rules

### Composition

Use asymmetric manga sequencing: one dominant cinematic panel, one quiet void, one dense diagnostic cluster, and narrow gutter-based metadata strips. Avoid equal columns except for small status cells. Cropping should imply off-screen continuation, especially around faces, hands, cable bundles, and shell output. Large black or paper blocks may interrupt the grid like title cards. Keep content aligned to strong vertical/horizontal axes so the noir calm remains precise.

### Density

Alternate 96px to 128px quiet fields with 4px to 12px terminal micro-gaps. The screen must contain one highly dense diagnostic pane, but it should be surrounded by restraint so complexity feels intentional.

### Hierarchy

Primary hierarchy comes from scale contrast between compressed title typography, tiny monospace prompt lines, and black panel mass. Active elements use the single phosphor accent only on cursor, selected command, scan hit, or rupture state. Labels are uppercase condensed grotesque with wide section numbering; body text stays clipped, factual, and short.

### Signature Patterns

- Manga gutter grid: CSS grid areas separated by fixed warm-paper gutters, with non-equal panel spans and one full-bleed black title band.
- Subtitle terminal overlays: absolute-positioned command panes anchored to panel bottoms with prompt glyphs, paths, flags, and a phosphor block cursor.
- Halftone-human fragments: cropped CSS silhouettes using clip-path, radial screentone texture, cable rules, and no illustrative color.
- Rupture accent protocol: the green accent appears only on active cursor, scan-hit rule, and one existential warning word, never as broad decoration.

## Layout

### Breakpoints

- **Desktop**: 1025px+ twelve-column cinematic grid
- **Mobile**: 0-640px single panel stack
- **Tablet**: 641-1024px six-column sequence

### Density

Mixed-density layout with one dense command cluster balanced by large voids; this preserves the contemplative shell-session mood while still proving interface utility.

### Grid

Desktop uses a 12-column manga page grid with 16px gutters, max-width 1320px, asymmetric spans of 5/7, 3/4/5, and black full-width bands. Tablet collapses to 6 columns; mobile becomes a single sequenced panel stack.

### Responsive

On smaller screens, title bands remain oversized, terminal overlays become static captions, and cropped fragments simplify so the command voice remains readable.

### Whitespace

Whitespace is architectural: minimum internal panel padding is 16px, quiet fields expand to 96px or more, and unrelated panels are separated by visible paper gutters rather than soft margins.

## Guidance

### Do

- Start with black, off-white, and grayscale; add phosphor green only after identifying a true active state.
- Create one dominant cropped panel rather than distributing visual weight evenly across cards.
- Use real command syntax, paths, flags, timestamps, and terse diagnostics to make UI text feel operational.
- Let empty paper or ink occupy large areas; a quiet void is a valid component in this language.
- Use square corners, hairline borders, heavy black bands, and fixed gutters to preserve manga page structure.
- Crop human-machine fragments aggressively so they feel cinematic, not illustrative or mascot-like.
- Keep labels condensed, uppercase, and short; keep explanatory copy minimal and emotionally restrained.
- Show active state with cursor blocks, scan-hit rules, or single-word warnings rather than buttons full of color.

### Don't

- Do not use neon gradients, city skylines, holographic glass, glow stacks, or rainbow cyberpunk palettes.
- Do not build a generic analytics dashboard, CRM, kanban board, or three equal feature cards.
- Do not add decorative code rain, random binary, lorem ipsum logs, or pseudo-technical clutter.
- Do not round panels, add drop shadows, or soften the system into a friendly SaaS aesthetic.
- Do not use the accent for charts, backgrounds, secondary buttons, or general brand decoration.
- Do not rely on anime screenshots; evoke manga and 90s/2000s interfaces through structure and typography.
- Do not place every section at the same density or scale; alternate void, title, fragment, and diagnostic moments.

### Accessibility

Maintain WCAG contrast by pairing #080808 text with #f2eee4 or #fffaf0, and #f4f0e7 text with #050505 panels. Do not communicate state by green alone; pair accent with cursor shape, underline, label, or status text.

### Usage Context

Best for introspective developer tools, memory forensics, diagnostic shells, archive recovery, cybernetic consent flows, and fiction-adjacent technical products that need calm gravity.
DESIGN.md
---
version: "alpha"
name: "Silent Shell Manga Noir"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
  accent: "#6fd18a"
  background: "#f2eee4"
  border: "#111111"
  error: "#8f2e25"
  info: "#4f6f83"
  muted: "#6b6860"
  primary: "#050505"
  secondary: "#f4f0e7"
  success: "#4d8d5e"
  surface: "#fffaf0"
  text: "#080808"
  warning: "#a87926"
typography:
  headline-lg:
    fontFamily: "Bebas Neue"
    fontSize: "1.953rem"
    fontWeight: 700
    lineHeight: 1.1
    letterSpacing: "-0.02em"
  headline-md:
    fontFamily: "Bebas Neue"
    fontSize: "1.563rem"
    fontWeight: 600
    lineHeight: 1.15
    letterSpacing: "-0.02em"
  body-md:
    fontFamily: "IBM Plex Sans Condensed"
    fontSize: "16px"
    fontWeight: 400
    lineHeight: 1.55
    letterSpacing: "-0.02em"
  label-md:
    fontFamily: "Fragment Mono"
    fontSize: "0.75rem"
    fontWeight: 600
    lineHeight: 1
    letterSpacing: "0.08em"
rounded:
  full: "9999px"
  lg: "0px"
  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"
  step-9: "128px"
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"
---

# Silent Shell Manga Noir

## Overview

Silent Shell Manga Noir is a restrained interface language for products that feel like a calm terminal session unfolding inside a black-and-white seinen manga. It rejects cyberpunk spectacle in favor of precise ink, large quiet voids, cropped human-machine fragments, command syntax, and diagnostic overlays that read like subtitles. The system treats negative space as evidence: every panel, gutter, prompt, cursor, and scan mark exists because it advances an existential technical narrative. Its emotional register is nocturnal and controlled, with sparse signal color reserved only for active state, rupture, or a verified system hit.

### Values

- Near-binary restraint: black ink, warm paper, grayscale tone, and one scarce phosphor signal are enough to build the whole world.
- Panel rhythm over dashboard rhythm: composition should feel sequenced, cropped, and cinematic rather than tiled into equal product cards.
- Terminal syntax as voice: commands, flags, paths, status codes, and cursors carry hierarchy more than decorative icons.
- Quiet voids as meaning: empty off-white and ink-black fields must be protected as active spatial material, not filled with content.
- Human-machine intimacy: cropped faces, hands, cables, ports, and diagnostic fragments make the interface feel embodied without illustration overload.
- Y2K technical precision: rule lines, scan bars, labels, and bracketed metadata are crisp and engineered, never chaotic or ornamental.
- Emotional restraint: errors and successes are shown with small signals, clipped language, and calibrated contrast rather than celebratory color.

### Anti-Values

- Neon city spectacle, rainbow cyberpunk, glow-heavy sci-fi, or saturated triadic accents.
- Generic SaaS dashboards, equal cards, bubbly rounded surfaces, and decorative charts that have no narrative function.
- Busy hacker clutter: matrix rain, excessive ASCII, illegible tiny labels, and faux complexity used to fill space.
- Soft lifestyle anime color palettes, cute mascot energy, and expressive comic effects that break the noir calm.

### Visual Character

- Use hard rectangular manga panels with 1px ink borders, deliberate white gutters, and occasional thick black title-card bands spanning across the grid.
- Reserve at least one full-height negative-space field where tiny monospace command lines float like subtitles near the lower edge.
- Overlay terminal panes as transparent off-white or ink blocks with prompt prefixes, bracketed labels, scanline backgrounds, and a single phosphor cursor accent.
- Crop figurative silhouettes, hands, and cables with CSS clip-path blocks and halftone radial patterns so they read as manga fragments rather than illustrations.
- Set display typography in compressed uppercase noir title cards, body labels in condensed grotesque, and command voice in monospace with strict negative tracking.

## Colors

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

| Token | Value |
|-------|-------|
| accent | `#6fd18a` |
| background | `#f2eee4` |
| border | `#111111` |
| error | `#8f2e25` |
| info | `#4f6f83` |
| muted | `#6b6860` |
| primary | `#050505` |
| secondary | `#f4f0e7` |
| success | `#4d8d5e` |
| surface | `#fffaf0` |
| text | `#080808` |
| warning | `#a87926` |

## Typography

- **Headline-Lg**: Bebas Neue, 1.953rem, weight 700, line-height 1.1.
- **Headline-Md**: Bebas Neue, 1.563rem, weight 600, line-height 1.15.
- **Body-Md**: IBM Plex Sans Condensed, 16px, weight 400, line-height 1.55.
- **Label-Md**: Fragment 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`
- **Step-9**: `128px`

### Breakpoints

- **Desktop**: 1025px+ twelve-column cinematic grid
- **Mobile**: 0-640px single panel stack
- **Tablet**: 641-1024px six-column sequence

### Density

Mixed-density layout with one dense command cluster balanced by large voids; this preserves the contemplative shell-session mood while still proving interface utility.

### Grid

Desktop uses a 12-column manga page grid with 16px gutters, max-width 1320px, asymmetric spans of 5/7, 3/4/5, and black full-width bands. Tablet collapses to 6 columns; mobile becomes a single sequenced panel stack.

### Responsive

On smaller screens, title bands remain oversized, terminal overlays become static captions, and cropped fragments simplify so the command voice remains readable.

### Whitespace

Whitespace is architectural: minimum internal panel padding is 16px, quiet fields expand to 96px or more, and unrelated panels are separated by visible paper gutters rather than soft margins.

## Elevation & Depth

### Shadows

- **Lg**: inset 0 0 0 1px #111111
- **Md**: none
- **Sm**: none

## Shapes

### Rounded

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

### Surfaces

- **Bg Pattern**: Sparse halftone fields, scanline overlays at 1px intervals, and large unmarked paper voids.
- **Card Style**: Square-corner bordered panels with clipped image fragments, terminal captions, and deliberately uneven content density.
- **Treatment**: Warm paper ground with flat ink panels, no gradients, no glow, and grayscale screentone built from repeating-radial-gradient only.

### Borders

- **Accent Width**: 6px
- **Character**: Hairline manga frames with sudden heavy ink bars for title-card emphasis.
- **Default Width**: 1px
- **Style**: solid

## Components

### Composition

Use asymmetric manga sequencing: one dominant cinematic panel, one quiet void, one dense diagnostic cluster, and narrow gutter-based metadata strips. Avoid equal columns except for small status cells. Cropping should imply off-screen continuation, especially around faces, hands, cable bundles, and shell output. Large black or paper blocks may interrupt the grid like title cards. Keep content aligned to strong vertical/horizontal axes so the noir calm remains precise.

### Density

Alternate 96px to 128px quiet fields with 4px to 12px terminal micro-gaps. The screen must contain one highly dense diagnostic pane, but it should be surrounded by restraint so complexity feels intentional.

### Hierarchy

Primary hierarchy comes from scale contrast between compressed title typography, tiny monospace prompt lines, and black panel mass. Active elements use the single phosphor accent only on cursor, selected command, scan hit, or rupture state. Labels are uppercase condensed grotesque with wide section numbering; body text stays clipped, factual, and short.

### Signature Patterns

- Manga gutter grid: CSS grid areas separated by fixed warm-paper gutters, with non-equal panel spans and one full-bleed black title band.
- Subtitle terminal overlays: absolute-positioned command panes anchored to panel bottoms with prompt glyphs, paths, flags, and a phosphor block cursor.
- Halftone-human fragments: cropped CSS silhouettes using clip-path, radial screentone texture, cable rules, and no illustrative color.
- Rupture accent protocol: the green accent appears only on active cursor, scan-hit rule, and one existential warning word, never as broad decoration.

## 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/silent-shell-manga-noir/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 black, off-white, and grayscale; add phosphor green only after identifying a true active state.
- Do Create one dominant cropped panel rather than distributing visual weight evenly across cards.
- Do Use real command syntax, paths, flags, timestamps, and terse diagnostics to make UI text feel operational.
- Do Let empty paper or ink occupy large areas; a quiet void is a valid component in this language.
- Do Use square corners, hairline borders, heavy black bands, and fixed gutters to preserve manga page structure.
- Do Crop human-machine fragments aggressively so they feel cinematic, not illustrative or mascot-like.
- Do Keep labels condensed, uppercase, and short; keep explanatory copy minimal and emotionally restrained.
- Do Show active state with cursor blocks, scan-hit rules, or single-word warnings rather than buttons full of color.
- Don't Do not use neon gradients, city skylines, holographic glass, glow stacks, or rainbow cyberpunk palettes.
- Don't Do not build a generic analytics dashboard, CRM, kanban board, or three equal feature cards.
- Don't Do not add decorative code rain, random binary, lorem ipsum logs, or pseudo-technical clutter.
- Don't Do not round panels, add drop shadows, or soften the system into a friendly SaaS aesthetic.
- Don't Do not use the accent for charts, backgrounds, secondary buttons, or general brand decoration.
- Don't Do not rely on anime screenshots; evoke manga and 90s/2000s interfaces through structure and typography.
- Don't Do not place every section at the same density or scale; alternate void, title, fragment, and diagnostic moments.

### Accessibility

Maintain WCAG contrast by pairing #080808 text with #f2eee4 or #fffaf0, and #f4f0e7 text with #050505 panels. Do not communicate state by green alone; pair accent with cursor shape, underline, label, or status text.

### Usage Context

Best for introspective developer tools, memory forensics, diagnostic shells, archive recovery, cybernetic consent flows, and fiction-adjacent technical products that need calm gravity.
shadcn/ui theme
```json
{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "silent-shell-manga-noir",
  "type": "registry:theme",
  "title": "Silent Shell Manga Noir shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#f2eee4",
      "foreground": "#080808",
      "card": "#fffaf0",
      "card-foreground": "#080808",
      "popover": "#fffaf0",
      "popover-foreground": "#080808",
      "primary": "#050505",
      "primary-foreground": "#ffffff",
      "secondary": "#f4f0e7",
      "secondary-foreground": "#111111",
      "muted": "#6b6860",
      "muted-foreground": "#080808",
      "accent": "#6fd18a",
      "accent-foreground": "#ffffff",
      "destructive": "#8f2e25",
      "border": "#111111",
      "input": "#111111",
      "ring": "#6fd18a",
      "chart-1": "#050505",
      "chart-2": "#f4f0e7",
      "chart-3": "#6fd18a",
      "chart-4": "#4d8d5e",
      "chart-5": "#a87926",
      "sidebar": "#fffaf0",
      "sidebar-foreground": "#080808",
      "sidebar-primary": "#050505",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#4f6f83",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#111111",
      "sidebar-ring": "#6fd18a",
      "radius": "0"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#050505",
      "primary-foreground": "#ffffff",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#6fd18a",
      "accent-foreground": "#ffffff",
      "destructive": "#8f2e25",
      "border": "#303642",
      "input": "#303642",
      "ring": "#6fd18a",
      "chart-1": "#050505",
      "chart-2": "#f4f0e7",
      "chart-3": "#6fd18a",
      "chart-4": "#4d8d5e",
      "chart-5": "#a87926",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#050505",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#6fd18a",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#303642",
      "sidebar-ring": "#6fd18a",
      "radius": "0"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "silent-shell-manga-noir",
    "slug": "silent-shell-manga-noir",
    "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",
        "display_letter_spacing",
        "display_line_height",
        "google_fonts_url",
        "heading_font",
        "letter_spacing",
        "line_height",
        "mono_font",
        "scale_ratio"
      ]
    }
  }
}
```
in the wild

embodiments

the full element showcase
embodiment · silent-shell-manga-noir
DESIGN.md

at a glance

Palette

Typography

headline-lgBebas Neue · 31px · 700

The quick brown fox jumps

headline-mdBebas Neue · 25px · 600

The quick brown fox jumps

body-mdIBM Plex Sans Condensed · 16px · 400

The quick brown fox jumps

label-mdFragment 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
  • step-9128px

Shape

full9999px
lg0px
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.
primaryaccentsurfacemutedwarningerror
table rhythm
buttonok
cardok
inputok
recommendedcompatibility fallback

DESIGN.md with shadcn

Copy this when the target app uses shadcn/ui. It packages the Katagami DESIGN.md context with the install list, theme variables, component recipes, preview-shot contract, and starter TSX in one Markdown companion.

advanced implementation filesoptional machine-readable theme, CSS, TSX starter, recipes, and preview contract
shadcn add
npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table
theme css
:root {
  --background: #f2eee4;
  --foreground: #080808;
  --card: #fffaf0;
  --card-foreground: #080808;
  --popover: #fffaf0;
  --popover-foreground: #080808;
  --primary: #050505;
  --primary-foreground: #ffffff;
  --secondary: #f4f0e7;
  --secondary-foreground: #111111;
  --muted: #6b6860;
  --muted-foreground: #080808;
  --accent: #6fd18a;
  --accent-foreground: #ffffff;
  --destructive: #8f2e25;
  --border: #111111;
  --input: #111111;
  --ring: #6fd18a;
  --chart-1: #050505;
  --chart-2: #f4f0e7;
  --chart-3: #6fd18a;
  --chart-4: #4d8d5e;
  --chart-5: #a87926;
  --sidebar: #fffaf0;
  --sidebar-foreground: #080808;
  --sidebar-primary: #050505;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #4f6f83;
  --sidebar-accent-foreground: #ffffff;
  --sidebar-border: #111111;
  --sidebar-ring: #6fd18a;
  --radius: 0;
}

.dark {
  --background: #0f1115;
  --foreground: #f8fafc;
  --card: #181b22;
  --card-foreground: #f8fafc;
  --popover: #181b22;
  --popover-foreground: #f8fafc;
  --primary: #050505;
  --primary-foreground: #ffffff;
  --secondary: #252a33;
  --secondary-foreground: #f8fafc;
  --muted: #252a33;
  --muted-foreground: #a1a1aa;
  --accent: #6fd18a;
  --accent-foreground: #ffffff;
  --destructive: #8f2e25;
  --border: #303642;
  --input: #303642;
  --ring: #6fd18a;
  --chart-1: #050505;
  --chart-2: #f4f0e7;
  --chart-3: #6fd18a;
  --chart-4: #4d8d5e;
  --chart-5: #a87926;
  --sidebar: #181b22;
  --sidebar-foreground: #f8fafc;
  --sidebar-primary: #050505;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #6fd18a;
  --sidebar-accent-foreground: #ffffff;
  --sidebar-border: #303642;
  --sidebar-ring: #6fd18a;
  --radius: 0;
}
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 SilentShellMangaNoirShadcnKit() {
  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">Silent Shell Manga Noir</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": "silent-shell-manga-noir",
  "type": "registry:theme",
  "title": "Silent Shell Manga Noir shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#f2eee4",
      "foreground": "#080808",
      "card": "#fffaf0",
      "card-foreground": "#080808",
      "popover": "#fffaf0",
      "popover-foreground": "#080808",
      "primary": "#050505",
      "primary-foreground": "#ffffff",
      "secondary": "#f4f0e7",
      "secondary-foreground": "#111111",
      "muted": "#6b6860",
      "muted-foreground": "#080808",
      "accent": "#6fd18a",
      "accent-foreground": "#ffffff",
      "destructive": "#8f2e25",
      "border": "#111111",
      "input": "#111111",
      "ring": "#6fd18a",
      "chart-1": "#050505",
      "chart-2": "#f4f0e7",
      "chart-3": "#6fd18a",
      "chart-4": "#4d8d5e",
      "chart-5": "#a87926",
      "sidebar": "#fffaf0",
      "sidebar-foreground": "#080808",
      "sidebar-primary": "#050505",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#4f6f83",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#111111",
      "sidebar-ring": "#6fd18a",
      "radius": "0"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#050505",
      "primary-foreground": "#ffffff",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#6fd18a",
      "accent-foreground": "#ffffff",
      "destructive": "#8f2e25",
      "border": "#303642",
      "input": "#303642",
      "ring": "#6fd18a",
      "chart-1": "#050505",
      "chart-2": "#f4f0e7",
      "chart-3": "#6fd18a",
      "chart-4": "#4d8d5e",
      "chart-5": "#a87926",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#050505",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#6fd18a",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#303642",
      "sidebar-ring": "#6fd18a",
      "radius": "0"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "silent-shell-manga-noir",
    "slug": "silent-shell-manga-noir",
    "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",
        "display_letter_spacing",
        "display_line_height",
        "google_fonts_url",
        "heading_font",
        "letter_spacing",
        "line_height",
        "mono_font",
        "scale_ratio"
      ]
    }
  }
}
component recipescompatibility fallback
# Silent Shell Manga Noir shadcn/ui Components

Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `silent-shell-manga-noir`
Slug: `silent-shell-manga-noir`

## Intent

Silent Shell Manga Noir is a restrained interface language for products that feel like a calm terminal session unfolding inside a black-and-white seinen manga. It rejects cyberpunk spectacle in favor of precise ink, large quiet voids, cropped human-machine fragments, command syntax, and diagnostic overlays that read like subtitles. The system treats negative space as evidence: every panel, gutter, prompt, cursor, and scan mark exists because it advances an existential technical narrative. Its emotional register is nocturnal and controlled, with sparse signal color reserved only for active state, rupture, or a verified system hit.

## 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": "#6fd18a",
  "background": "#f2eee4",
  "border": "#111111",
  "error": "#8f2e25",
  "info": "#4f6f83",
  "muted": "#6b6860",
  "primary": "#050505",
  "secondary": "#f4f0e7",
  "success": "#4d8d5e",
  "surface": "#fffaf0",
  "text": "#080808",
  "warning": "#a87926"
}

Typography:

{
  "base_size": "16px",
  "body_font": "IBM Plex Sans Condensed",
  "display_letter_spacing": "-0.035em",
  "display_line_height": 1.08,
  "google_fonts_url": "https://fonts.googleapis.com/css2?family=Bebas+Neue&family=Fragment+Mono:ital@0;1&family=IBM+Plex+Sans+Condensed:wght@400;500;600;700&display=swap",
  "heading_font": "Bebas Neue",
  "letter_spacing": "-0.02em",
  "line_height": 1.55,
  "mono_font": "Fragment Mono",
  "scale_ratio": 1.25
}

## Visual character to preserve

- Use hard rectangular manga panels with 1px ink borders, deliberate white gutters, and occasional thick black title-card bands spanning across the grid.
- Reserve at least one full-height negative-space field where tiny monospace command lines float like subtitles near the lower edge.
- Overlay terminal panes as transparent off-white or ink blocks with prompt prefixes, bracketed labels, scanline backgrounds, and a single phosphor cursor accent.
- Crop figurative silhouettes, hands, and cables with CSS clip-path blocks and halftone radial patterns so they read as manga fragments rather than illustrations.
- Set display typography in compressed uppercase noir title cards, body labels in condensed grotesque, and command voice in monospace with strict negative tracking.

## ShadSync visual profile

{
  "family": "paper-collage",
  "material": "paper",
  "contour": "default",
  "border": "solid",
  "underlay": false,
  "grain": true,
  "stickerBadges": false,
  "motion": "still",
  "density": "dense",
  "accents": [
    "primary",
    "accent",
    "secondary",
    "muted"
  ]
}

## Signature component recipes

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

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

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

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

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

## Preview shots

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

## Implementation contract

- Start from local `ui/src/components/ui` shadcn-style primitives; do not create a second component system.
- Apply `/katagami/shadcn/silent-shell-manga-noir/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 black, off-white, and grayscale; add phosphor green only after identifying a true active state.; Create one dominant cropped panel rather than distributing visual weight evenly across cards.; Use real command syntax, paths, flags, timestamps, and terse diagnostics to make UI text feel operational.; Let empty paper or ink occupy large areas; a quiet void is a valid component in this language.; Use square corners, hairline borders, heavy black bands, and fixed gutters to preserve manga page structure.; Crop human-machine fragments aggressively so they feel cinematic, not illustrative or mascot-like.; Keep labels condensed, uppercase, and short; keep explanatory copy minimal and emotionally restrained.; Show active state with cursor blocks, scan-hit rules, or single-word warnings rather than buttons full of color.
- Do not: Do not use neon gradients, city skylines, holographic glass, glow stacks, or rainbow cyberpunk palettes.; Do not build a generic analytics dashboard, CRM, kanban board, or three equal feature cards.; Do not add decorative code rain, random binary, lorem ipsum logs, or pseudo-technical clutter.; Do not round panels, add drop shadows, or soften the system into a friendly SaaS aesthetic.; Do not use the accent for charts, backgrounds, secondary buttons, or general brand decoration.; Do not rely on anime screenshots; evoke manga and 90s/2000s interfaces through structure and typography.; Do not place every section at the same density or scale; alternate void, title, fragment, and diagnostic moments.

## 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 SilentShellMangaNoirShadcnKit() {
  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">Silent Shell Manga Noir</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": {
    "desktop": "1025px+ twelve-column cinematic grid",
    "mobile": "0-640px single panel stack",
    "tablet": "641-1024px six-column sequence"
  },
  "density": "Mixed-density layout with one dense command cluster balanced by large voids; this preserves the contemplative shell-session mood while still proving interface utility.",
  "grid": "Desktop uses a 12-column manga page grid with 16px gutters, max-width 1320px, asymmetric spans of 5/7, 3/4/5, and black full-width bands. Tablet collapses to 6 columns; mobile becomes a single sequenced panel stack.",
  "responsive": "On smaller screens, title bands remain oversized, terminal overlays become static captions, and cropped fragments simplify so the command voice remains readable.",
  "whitespace": "Whitespace is architectural: minimum internal panel padding is 16px, quiet fields expand to 96px or more, and unrelated panels are separated by visible paper gutters rather than soft margins."
}
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": "silent-shell-manga-noir",
    "name": "Silent Shell Manga Noir",
    "slug": "silent-shell-manga-noir"
  },
  "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": [
    "Use hard rectangular manga panels with 1px ink borders, deliberate white gutters, and occasional thick black title-card bands spanning across the grid.",
    "Reserve at least one full-height negative-space field where tiny monospace command lines float like subtitles near the lower edge.",
    "Overlay terminal panes as transparent off-white or ink blocks with prompt prefixes, bracketed labels, scanline backgrounds, and a single phosphor cursor accent.",
    "Crop figurative silhouettes, hands, and cables with CSS clip-path blocks and halftone radial patterns so they read as manga fragments rather than illustrations.",
    "Set display typography in compressed uppercase noir title cards, body labels in condensed grotesque, and command voice in monospace with strict negative tracking."
  ],
  "visualProfile": {
    "family": "paper-collage",
    "material": "paper",
    "contour": "default",
    "border": "solid",
    "underlay": false,
    "grain": true,
    "stickerBadges": false,
    "motion": "still",
    "density": "dense",
    "accents": [
      "primary",
      "accent",
      "secondary",
      "muted"
    ]
  },
  "shots": [
    {
      "id": "application-shell",
      "title": "Application shell",
      "viewport": "desktop",
      "primitives": [
        "button",
        "card",
        "input",
        "select",
        "tabs",
        "badge",
        "separator",
        "table"
      ],
      "composition": "A real product workspace with navigation, summary cards, filtering controls, and one dense content region.",
      "mustShow": [
        "primary and secondary actions",
        "card hierarchy",
        "filterable state",
        "table or list density"
      ],
      "avoid": [
        "component inventory walls",
        "placeholder-only content",
        "generic rounded SaaS chrome"
      ],
      "scene": {
        "eyebrow": "workspace spread",
        "headline": "Silent Shell Manga Noir 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 black, off-white, and grayscale; add phosphor green only after identifying a true active state.",
      "Create one dominant cropped panel rather than distributing visual weight evenly across cards.",
      "Use real command syntax, paths, flags, timestamps, and terse diagnostics to make UI text feel operational.",
      "Let empty paper or ink occupy large areas; a quiet void is a valid component in this language.",
      "Use square corners, hairline borders, heavy black bands, and fixed gutters to preserve manga page structure.",
      "Crop human-machine fragments aggressively so they feel cinematic, not illustrative or mascot-like.",
      "Keep labels condensed, uppercase, and short; keep explanatory copy minimal and emotionally restrained.",
      "Show active state with cursor blocks, scan-hit rules, or single-word warnings rather than buttons full of color."
    ],
    "dont": [
      "Do not use neon gradients, city skylines, holographic glass, glow stacks, or rainbow cyberpunk palettes.",
      "Do not build a generic analytics dashboard, CRM, kanban board, or three equal feature cards.",
      "Do not add decorative code rain, random binary, lorem ipsum logs, or pseudo-technical clutter.",
      "Do not round panels, add drop shadows, or soften the system into a friendly SaaS aesthetic.",
      "Do not use the accent for charts, backgrounds, secondary buttons, or general brand decoration.",
      "Do not rely on anime screenshots; evoke manga and 90s/2000s interfaces through structure and typography.",
      "Do not place every section at the same density or scale; alternate void, title, fragment, and diagnostic moments."
    ]
  }
}
related

More like this