Optical Shellcode Terminal
A portable design language for agents: download the markdown first, then inspect the preview, tokens, and rules as needed.
Download DESIGN.md
Portable DESIGN.md source of truth for most agents and apps.
specification
philosophy
tokens
borders4 items
- accent width
- 1px
- character
- Near-invisible black borders at 6-10% opacity, interrupted by cyan one-pixel ticks and terminal bracket corners.
- default width
- 1px
- style
- solid
colors12 items
motion3 items
- duration
- 420ms
- easing
- cubic-bezier(0.16, 1, 0.3, 1)
- philosophy
- Motion should feel like a diagnostic layer resolving into focus: subtle opacity shifts, scanline drift under 4px, and no bouncing or playful easing.
radii5 items
- full
- 9999px
- lg
- 24px
- md
- 16px
- none
- 0
- sm
- 0
shadows3 items
- lg
- 0 40px 120px rgba(111,175,196,0.12)
- md
- 0 18px 44px rgba(11,13,15,0.055)
- sm
- 0 1px 0 rgba(11,13,15,0.06)
spacing2 items
- base
- 8px
- scale
- 4, 8, 12, 16, 24, 32, 48, 64, 96, 128
surfaces3 items
- bg pattern
- Hairline graphite coordinate grid built from linear-gradients every 48px with additional scanline bands at diagnostic seams.
- card style
- Terminal cards are rectangular, square-cornered or 16px clipped only at major overlays, with 1px rgba(11,13,15,0.08) borders and corner tick pseudo-elements.
- treatment
- Optical-camouflage white base with acrylic panels using rgba(255,255,255,0.62), backdrop-filter blur(18px), and sparse chrome linear highlights.
typography8 items
- base size
- 16px
- body font
- Archivo
- google fonts url
- https://fonts.googleapis.com/css2?family=Archivo:wdth,wght@85,300;85,400;90,500&family=Azeret+Mono:wght@300;400;500&family=Michroma&display=swap
- heading font
- Michroma
- letter spacing
- -0.02em
- line height
- 1.55
- mono font
- Azeret Mono
- scale ratio
- 1.22
rules
Compose screens as an inhabited shell, not a dashboard: one large quiet white field, one dense terminal cluster, one off-axis floating overlay, and one structural black contour. Use asymmetry, reserve at least 35% of desktop canvas as negative space, and let coordinates make emptiness feel intentional.
Overall density is low, but the language needs one local pocket of high informational compression: a terminal strip, packet list, or memory trace balanced against a large sterile void.
Hierarchy begins with a wide microtype system header, then a narrow grotesk analytical title, then monospace telemetry. Headlines stay light and tracked; code blocks stay small and high contrast; cyan appears only as a signal marker, status pixel, or selected coordinate.
layout
mobile <= 640px stacks overlays into a single column; tablet 641-1024px keeps a 6-column grid; desktop >= 1025px uses full 12-column asymmetry.
Low global density with one high-compression code pocket; the large blank zones are active optical camouflage, not unused space.
Desktop uses a 12-column grid, 24px gutters, max-width 1320px, with columns 1-2 often left empty for coordinates and folio marks.
On mobile, preserve the shell feeling by retaining coordinate labels and contour arcs while reducing code density and moving overlays below the main title.
Use dramatic 8:1 spacing rhythm: 4-8px inside telemetry rows, 48-96px between functional clusters, and 128px quiet fields on desktop.
guidance
- Use optical whites, soft blacks, pale cyan, and transparent acrylic as the only major visual vocabulary.
- Keep terminal code blocks small and quiet, with expanded tracking and clinical labels rather than theatrical hacker glow.
- Place at least one empty grid region with coordinates or crosshair dots so whitespace feels designed.
- Use manga ink lines as SVG contour scaffolds, border arcs, or cropped silhouettes that support layout structure.
- Make one panel visually dominant and vary section weights; avoid equal cards or repeated modular sameness.
- Use body tracking at -0.02em, display tracking around -0.035em, display leading near 1.12, and body leading around 1.55.
- Keep borders near-invisible and rely on tiny cyan ticks for system state changes.
- Name scenes as specific speculative tools: memory-shell calibration, prosthetic identity audit, or autonomous consciousness interface.
- Do not use saturated neon cyan, magenta, green matrix rain, RGB gradients, or nightclub cyberpunk lighting.
- Do not create generic dashboards, analytics cards, CRM tables, or component-library showcases.
- Do not fill all empty space with widgets; the sterile void is part of the philosophical tone.
- Do not use cartoon anime characters, fan-art panels, speech bubbles, or illustrative manga decoration.
- Do not round every corner; use square terminal frames with only occasional 16px acrylic overlays.
- Do not thicken borders beyond 1px except for sparse black contour silhouettes.
- Do not use heavy shadows, plastic gloss, or skeuomorphic chrome; highlights must be cold and minimal.
- Do not let cyan carry large surfaces; it belongs in pixels, hairlines, and terse status text only.
katagami spec
# Optical Shellcode Terminal ## Philosophy Optical Shellcode Terminal is a polished cybernetic minimalism system for interfaces that feel like a white shell around consciousness: quiet, clinical, translucent, and intellectually charged. It borrows the philosophical calm of late-90s anime cybernetics without cosplay, translating manga ink contours, shellcode terminals, optical camouflage, Y2K acrylic, and diagnostic grids into a restrained product language for speculative neural tools. ### Values - Consciousness is framed rather than illustrated: the interface should surround the subject with measured coordinates, pale signals, and negative space. - The system prefers optical quiet over hacker noise, using black-white contrast and scarce cyan pixels instead of saturated neon spectacle. - Every panel must feel technically precise, with hairline rules, clipped terminal frames, indexed coordinates, and rational grid placement. - Manga reference appears as structural black contour silhouettes and cropped ink arcs, never as character art or decorative fan service. - Y2K futurism is expressed through translucent acrylic planes, chrome glints, microtype, and glass layering rather than glossy skeuomorphism. - Code is treated like atmospheric evidence: small, legible, fragmented, and subordinate to empty space. ### Anti-Values - No noisy cyberpunk dashboards, rainbow terminal glow, matrix rain, or dense green-on-black hacker clichés. - No friendly SaaS cards, rounded pastel widgets, generic analytics charts, or equal three-card sections. - No anime illustration collage; black ink linework must function as composition, frame, or silhouette only. - No heavy blur walls that reduce legibility or turn the language into frosted-glass template styling. ### Visual Character - Use a 12-column precision grid with two or more intentionally empty columns, plus absolute-positioned ghost coordinate labels in 10px monospace. - Build panels as translucent white acrylic rectangles at 8-24% opacity with 1px rgba graphite borders and clipped terminal corner ticks. - Insert sparse manga-like black ink contour lines as oversized SVG arcs or border silhouettes that structure the page without becoming illustration. - Separate dense code/status areas with 1px repeating-linear-gradient scanline dividers and single-pixel pale cyan alert marks. - Layer small floating terminal overlays above a sterile white field using minimal chrome highlights and almost no shadow depth. ## Tokens ### Borders - **Accent Width**: 1px - **Character**: Near-invisible black borders at 6-10% opacity, interrupted by cyan one-pixel ticks and terminal bracket corners. - **Default Width**: 1px - **Style**: solid ### Colors | Name | Value | |------|-------| | accent | `#8FD7E8` | | background | `#FBFCFC` | | border | `#0B0D0F` | | error | `#9B2F3B` | | info | `#6FAFC4` | | muted | `#667176` | | primary | `#0B0D0F` | | secondary | `#F7FAFB` | | success | `#3F7A72` | | surface | `#FFFFFF` | | text | `#111417` | | warning | `#A2793A` | ### Motion - **Duration**: 420ms - **Easing**: cubic-bezier(0.16, 1, 0.3, 1) - **Philosophy**: Motion should feel like a diagnostic layer resolving into focus: subtle opacity shifts, scanline drift under 4px, and no bouncing or playful easing. ### Radii - **Full**: 9999px - **Lg**: 24px - **Md**: 16px - **None**: 0 - **Sm**: 0 ### Shadows - **Lg**: 0 40px 120px rgba(111,175,196,0.12) - **Md**: 0 18px 44px rgba(11,13,15,0.055) - **Sm**: 0 1px 0 rgba(11,13,15,0.06) ### Spacing - **Base**: 8px - **Scale**: [4,8,12,16,24,32,48,64,96,128] ### Surfaces - **Bg Pattern**: Hairline graphite coordinate grid built from linear-gradients every 48px with additional scanline bands at diagnostic seams. - **Card Style**: Terminal cards are rectangular, square-cornered or 16px clipped only at major overlays, with 1px rgba(11,13,15,0.08) borders and corner tick pseudo-elements. - **Treatment**: Optical-camouflage white base with acrylic panels using rgba(255,255,255,0.62), backdrop-filter blur(18px), and sparse chrome linear highlights. ### Typography - **Base Size**: 16px - **Body Font**: Archivo - **Google Fonts Url**: https://fonts.googleapis.com/css2?family=Archivo:wdth,wght@85,300;85,400;90,500&family=Azeret+Mono:wght@300;400;500&family=Michroma&display=swap - **Heading Font**: Michroma - **Letter Spacing**: -0.02em - **Line Height**: 1.55 - **Mono Font**: Azeret Mono - **Scale Ratio**: 1.22 ## Rules ### Composition Compose screens as an inhabited shell, not a dashboard: one large quiet white field, one dense terminal cluster, one off-axis floating overlay, and one structural black contour. Use asymmetry, reserve at least 35% of desktop canvas as negative space, and let coordinates make emptiness feel intentional. ### Density Overall density is low, but the language needs one local pocket of high informational compression: a terminal strip, packet list, or memory trace balanced against a large sterile void. ### Hierarchy Hierarchy begins with a wide microtype system header, then a narrow grotesk analytical title, then monospace telemetry. Headlines stay light and tracked; code blocks stay small and high contrast; cyan appears only as a signal marker, status pixel, or selected coordinate. ### Signature Patterns - Optical acrylic terminals: panels use backdrop-filter blur, rgba white fills below 24% visual weight, square graphite borders, and four tiny corner ticks. - Ghost coordinate field: absolute 10px monospace labels and crosshair dots sit in empty columns to make negative space read as measured surveillance. - Manga contour scaffold: oversized black SVG arcs or borders cut through the layout as sparse structural silhouettes, never filled illustrations. - Scanline diagnostic seams: repeating-linear-gradient stripes create 1px dividers behind code fragments and status rows with cold cyan single-pixel accents. - Y2K chrome micro-glints: restrained silver linear highlights appear on only one or two panel edges to imply polished machine hardware. ## Layout ### Breakpoints mobile <= 640px stacks overlays into a single column; tablet 641-1024px keeps a 6-column grid; desktop >= 1025px uses full 12-column asymmetry. ### Density Low global density with one high-compression code pocket; the large blank zones are active optical camouflage, not unused space. ### Grid Desktop uses a 12-column grid, 24px gutters, max-width 1320px, with columns 1-2 often left empty for coordinates and folio marks. ### Responsive On mobile, preserve the shell feeling by retaining coordinate labels and contour arcs while reducing code density and moving overlays below the main title. ### Whitespace Use dramatic 8:1 spacing rhythm: 4-8px inside telemetry rows, 48-96px between functional clusters, and 128px quiet fields on desktop. ## Guidance ### Do - Use optical whites, soft blacks, pale cyan, and transparent acrylic as the only major visual vocabulary. - Keep terminal code blocks small and quiet, with expanded tracking and clinical labels rather than theatrical hacker glow. - Place at least one empty grid region with coordinates or crosshair dots so whitespace feels designed. - Use manga ink lines as SVG contour scaffolds, border arcs, or cropped silhouettes that support layout structure. - Make one panel visually dominant and vary section weights; avoid equal cards or repeated modular sameness. - Use body tracking at -0.02em, display tracking around -0.035em, display leading near 1.12, and body leading around 1.55. - Keep borders near-invisible and rely on tiny cyan ticks for system state changes. - Name scenes as specific speculative tools: memory-shell calibration, prosthetic identity audit, or autonomous consciousness interface. ### Don't - Do not use saturated neon cyan, magenta, green matrix rain, RGB gradients, or nightclub cyberpunk lighting. - Do not create generic dashboards, analytics cards, CRM tables, or component-library showcases. - Do not fill all empty space with widgets; the sterile void is part of the philosophical tone. - Do not use cartoon anime characters, fan-art panels, speech bubbles, or illustrative manga decoration. - Do not round every corner; use square terminal frames with only occasional 16px acrylic overlays. - Do not thicken borders beyond 1px except for sparse black contour silhouettes. - Do not use heavy shadows, plastic gloss, or skeuomorphic chrome; highlights must be cold and minimal. - Do not let cyan carry large surfaces; it belongs in pixels, hairlines, and terse status text only. ### Accessibility Maintain AA contrast for body text on white and acrylic surfaces; do not place low-opacity code over active grid lines; keep cyan accents supplemental rather than the only state indicator. ### Usage Context Best for speculative AI shells, neuroprosthetic calibration tools, identity audit software, memory-index products, cinematic title systems, and premium technical documentation for cybernetic systems.
DESIGN.md
---
version: "alpha"
name: "Optical Shellcode Terminal"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
accent: "#8FD7E8"
background: "#FBFCFC"
border: "#0B0D0F"
error: "#9B2F3B"
info: "#6FAFC4"
muted: "#667176"
primary: "#0B0D0F"
secondary: "#F7FAFB"
success: "#3F7A72"
surface: "#FFFFFF"
text: "#111417"
warning: "#A2793A"
typography:
headline-lg:
fontFamily: "Michroma"
fontSize: "1.816rem"
fontWeight: 700
lineHeight: 1.1
letterSpacing: "-0.02em"
headline-md:
fontFamily: "Michroma"
fontSize: "1.488rem"
fontWeight: 600
lineHeight: 1.15
letterSpacing: "-0.02em"
body-md:
fontFamily: "Archivo"
fontSize: "16px"
fontWeight: 400
lineHeight: 1.55
letterSpacing: "-0.02em"
label-md:
fontFamily: "Azeret Mono"
fontSize: "0.75rem"
fontWeight: 600
lineHeight: 1
letterSpacing: "0.08em"
rounded:
full: "9999px"
lg: "24px"
md: "16px"
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"
---
# Optical Shellcode Terminal
## Overview
Optical Shellcode Terminal is a polished cybernetic minimalism system for interfaces that feel like a white shell around consciousness: quiet, clinical, translucent, and intellectually charged. It borrows the philosophical calm of late-90s anime cybernetics without cosplay, translating manga ink contours, shellcode terminals, optical camouflage, Y2K acrylic, and diagnostic grids into a restrained product language for speculative neural tools.
### Values
- Consciousness is framed rather than illustrated: the interface should surround the subject with measured coordinates, pale signals, and negative space.
- The system prefers optical quiet over hacker noise, using black-white contrast and scarce cyan pixels instead of saturated neon spectacle.
- Every panel must feel technically precise, with hairline rules, clipped terminal frames, indexed coordinates, and rational grid placement.
- Manga reference appears as structural black contour silhouettes and cropped ink arcs, never as character art or decorative fan service.
- Y2K futurism is expressed through translucent acrylic planes, chrome glints, microtype, and glass layering rather than glossy skeuomorphism.
- Code is treated like atmospheric evidence: small, legible, fragmented, and subordinate to empty space.
### Anti-Values
- No noisy cyberpunk dashboards, rainbow terminal glow, matrix rain, or dense green-on-black hacker clichés.
- No friendly SaaS cards, rounded pastel widgets, generic analytics charts, or equal three-card sections.
- No anime illustration collage; black ink linework must function as composition, frame, or silhouette only.
- No heavy blur walls that reduce legibility or turn the language into frosted-glass template styling.
### Visual Character
- Use a 12-column precision grid with two or more intentionally empty columns, plus absolute-positioned ghost coordinate labels in 10px monospace.
- Build panels as translucent white acrylic rectangles at 8-24% opacity with 1px rgba graphite borders and clipped terminal corner ticks.
- Insert sparse manga-like black ink contour lines as oversized SVG arcs or border silhouettes that structure the page without becoming illustration.
- Separate dense code/status areas with 1px repeating-linear-gradient scanline dividers and single-pixel pale cyan alert marks.
- Layer small floating terminal overlays above a sterile white field using minimal chrome highlights and almost no shadow depth.
## 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 | `#8FD7E8` |
| background | `#FBFCFC` |
| border | `#0B0D0F` |
| error | `#9B2F3B` |
| info | `#6FAFC4` |
| muted | `#667176` |
| primary | `#0B0D0F` |
| secondary | `#F7FAFB` |
| success | `#3F7A72` |
| surface | `#FFFFFF` |
| text | `#111417` |
| warning | `#A2793A` |
## Typography
- **Headline-Lg**: Michroma, 1.816rem, weight 700, line-height 1.1.
- **Headline-Md**: Michroma, 1.488rem, weight 600, line-height 1.15.
- **Body-Md**: Archivo, 16px, weight 400, line-height 1.55.
- **Label-Md**: Azeret 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
mobile <= 640px stacks overlays into a single column; tablet 641-1024px keeps a 6-column grid; desktop >= 1025px uses full 12-column asymmetry.
### Density
Low global density with one high-compression code pocket; the large blank zones are active optical camouflage, not unused space.
### Grid
Desktop uses a 12-column grid, 24px gutters, max-width 1320px, with columns 1-2 often left empty for coordinates and folio marks.
### Responsive
On mobile, preserve the shell feeling by retaining coordinate labels and contour arcs while reducing code density and moving overlays below the main title.
### Whitespace
Use dramatic 8:1 spacing rhythm: 4-8px inside telemetry rows, 48-96px between functional clusters, and 128px quiet fields on desktop.
## Elevation & Depth
### Shadows
- **Lg**: 0 40px 120px rgba(111,175,196,0.12)
- **Md**: 0 18px 44px rgba(11,13,15,0.055)
- **Sm**: 0 1px 0 rgba(11,13,15,0.06)
## Shapes
### Rounded
- **Full**: `9999px`
- **Lg**: `24px`
- **Md**: `16px`
- **None**: `0px`
- **Sm**: `0px`
### Surfaces
- **Bg Pattern**: Hairline graphite coordinate grid built from linear-gradients every 48px with additional scanline bands at diagnostic seams.
- **Card Style**: Terminal cards are rectangular, square-cornered or 16px clipped only at major overlays, with 1px rgba(11,13,15,0.08) borders and corner tick pseudo-elements.
- **Treatment**: Optical-camouflage white base with acrylic panels using rgba(255,255,255,0.62), backdrop-filter blur(18px), and sparse chrome linear highlights.
### Borders
- **Accent Width**: 1px
- **Character**: Near-invisible black borders at 6-10% opacity, interrupted by cyan one-pixel ticks and terminal bracket corners.
- **Default Width**: 1px
- **Style**: solid
## Components
### Composition
Compose screens as an inhabited shell, not a dashboard: one large quiet white field, one dense terminal cluster, one off-axis floating overlay, and one structural black contour. Use asymmetry, reserve at least 35% of desktop canvas as negative space, and let coordinates make emptiness feel intentional.
### Density
Overall density is low, but the language needs one local pocket of high informational compression: a terminal strip, packet list, or memory trace balanced against a large sterile void.
### Hierarchy
Hierarchy begins with a wide microtype system header, then a narrow grotesk analytical title, then monospace telemetry. Headlines stay light and tracked; code blocks stay small and high contrast; cyan appears only as a signal marker, status pixel, or selected coordinate.
### Signature Patterns
- Optical acrylic terminals: panels use backdrop-filter blur, rgba white fills below 24% visual weight, square graphite borders, and four tiny corner ticks.
- Ghost coordinate field: absolute 10px monospace labels and crosshair dots sit in empty columns to make negative space read as measured surveillance.
- Manga contour scaffold: oversized black SVG arcs or borders cut through the layout as sparse structural silhouettes, never filled illustrations.
- Scanline diagnostic seams: repeating-linear-gradient stripes create 1px dividers behind code fragments and status rows with cold cyan single-pixel accents.
- Y2K chrome micro-glints: restrained silver linear highlights appear on only one or two panel edges to imply polished machine hardware.
## 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/optical-shellcode-terminal/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 Use optical whites, soft blacks, pale cyan, and transparent acrylic as the only major visual vocabulary.
- Do Keep terminal code blocks small and quiet, with expanded tracking and clinical labels rather than theatrical hacker glow.
- Do Place at least one empty grid region with coordinates or crosshair dots so whitespace feels designed.
- Do Use manga ink lines as SVG contour scaffolds, border arcs, or cropped silhouettes that support layout structure.
- Do Make one panel visually dominant and vary section weights; avoid equal cards or repeated modular sameness.
- Do Use body tracking at -0.02em, display tracking around -0.035em, display leading near 1.12, and body leading around 1.55.
- Do Keep borders near-invisible and rely on tiny cyan ticks for system state changes.
- Do Name scenes as specific speculative tools: memory-shell calibration, prosthetic identity audit, or autonomous consciousness interface.
- Don't Do not use saturated neon cyan, magenta, green matrix rain, RGB gradients, or nightclub cyberpunk lighting.
- Don't Do not create generic dashboards, analytics cards, CRM tables, or component-library showcases.
- Don't Do not fill all empty space with widgets; the sterile void is part of the philosophical tone.
- Don't Do not use cartoon anime characters, fan-art panels, speech bubbles, or illustrative manga decoration.
- Don't Do not round every corner; use square terminal frames with only occasional 16px acrylic overlays.
- Don't Do not thicken borders beyond 1px except for sparse black contour silhouettes.
- Don't Do not use heavy shadows, plastic gloss, or skeuomorphic chrome; highlights must be cold and minimal.
- Don't Do not let cyan carry large surfaces; it belongs in pixels, hairlines, and terse status text only.
### Accessibility
Maintain AA contrast for body text on white and acrylic surfaces; do not place low-opacity code over active grid lines; keep cyan accents supplemental rather than the only state indicator.
### Usage Context
Best for speculative AI shells, neuroprosthetic calibration tools, identity audit software, memory-index products, cinematic title systems, and premium technical documentation for cybernetic systems.
shadcn/ui theme
```json
{
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
"name": "optical-shellcode-terminal",
"type": "registry:theme",
"title": "Optical Shellcode Terminal shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#FBFCFC",
"foreground": "#111417",
"card": "#FFFFFF",
"card-foreground": "#111417",
"popover": "#FFFFFF",
"popover-foreground": "#111417",
"primary": "#0B0D0F",
"primary-foreground": "#ffffff",
"secondary": "#F7FAFB",
"secondary-foreground": "#111111",
"muted": "#667176",
"muted-foreground": "#111417",
"accent": "#8FD7E8",
"accent-foreground": "#111111",
"destructive": "#9B2F3B",
"border": "#0B0D0F",
"input": "#0B0D0F",
"ring": "#8FD7E8",
"chart-1": "#0B0D0F",
"chart-2": "#F7FAFB",
"chart-3": "#8FD7E8",
"chart-4": "#3F7A72",
"chart-5": "#A2793A",
"sidebar": "#FFFFFF",
"sidebar-foreground": "#111417",
"sidebar-primary": "#0B0D0F",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#6FAFC4",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#0B0D0F",
"sidebar-ring": "#8FD7E8",
"radius": "16px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#0B0D0F",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#8FD7E8",
"accent-foreground": "#111111",
"destructive": "#9B2F3B",
"border": "#303642",
"input": "#303642",
"ring": "#8FD7E8",
"chart-1": "#0B0D0F",
"chart-2": "#F7FAFB",
"chart-3": "#8FD7E8",
"chart-4": "#3F7A72",
"chart-5": "#A2793A",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#0B0D0F",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#8FD7E8",
"sidebar-accent-foreground": "#111111",
"sidebar-border": "#303642",
"sidebar-ring": "#8FD7E8",
"radius": "16px"
}
},
"meta": {
"source": "katagami",
"languageId": "optical-shellcode-terminal",
"slug": "optical-shellcode-terminal",
"componentManifest": [
"button",
"card",
"input",
"textarea",
"select",
"dialog",
"sheet",
"tabs",
"badge",
"separator",
"checkbox",
"switch",
"slider",
"tooltip",
"dropdown-menu",
"table"
],
"installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
"nativeTokenNames": {
"borders": [
"accent_width",
"character",
"default_width",
"style"
],
"colors": [
"accent",
"background",
"border",
"error",
"info",
"muted",
"primary",
"secondary",
"success",
"surface",
"text",
"warning"
],
"motion": [
"duration",
"easing",
"philosophy"
],
"radii": [
"full",
"lg",
"md",
"none",
"sm"
],
"shadows": [
"lg",
"md",
"sm"
],
"spacing": [
"base",
"scale"
],
"surfaces": [
"bg_pattern",
"card_style",
"treatment"
],
"typography": [
"base_size",
"body_font",
"google_fonts_url",
"heading_font",
"letter_spacing",
"line_height",
"mono_font",
"scale_ratio"
]
}
}
}
```embodiments
at a glance
Typography
The quick brown fox jumps
The quick brown fox jumps
The quick brown fox jumps
The quick brown fox jumps
Components
Components rendered with this language’s tokens — colors, type, and rounded corners as specified.
Spacing
- base8px
- xs4px
- sm8px
- md12px
- lg16px
- xl24px
- 2xl32px
- 3xl48px
- 4xl64px
- step-896px
- step-9128px
Shape
implementation kit
DESIGN.md with shadcn
Copy this when the target app uses shadcn/ui. It packages the Katagami DESIGN.md context with the install list, theme variables, component recipes, preview-shot contract, and starter TSX in one Markdown companion.
advanced implementation filesoptional machine-readable theme, CSS, TSX starter, recipes, and preview contract
npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table:root {
--background: #FBFCFC;
--foreground: #111417;
--card: #FFFFFF;
--card-foreground: #111417;
--popover: #FFFFFF;
--popover-foreground: #111417;
--primary: #0B0D0F;
--primary-foreground: #ffffff;
--secondary: #F7FAFB;
--secondary-foreground: #111111;
--muted: #667176;
--muted-foreground: #111417;
--accent: #8FD7E8;
--accent-foreground: #111111;
--destructive: #9B2F3B;
--border: #0B0D0F;
--input: #0B0D0F;
--ring: #8FD7E8;
--chart-1: #0B0D0F;
--chart-2: #F7FAFB;
--chart-3: #8FD7E8;
--chart-4: #3F7A72;
--chart-5: #A2793A;
--sidebar: #FFFFFF;
--sidebar-foreground: #111417;
--sidebar-primary: #0B0D0F;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #6FAFC4;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #0B0D0F;
--sidebar-ring: #8FD7E8;
--radius: 16px;
}
.dark {
--background: #0f1115;
--foreground: #f8fafc;
--card: #181b22;
--card-foreground: #f8fafc;
--popover: #181b22;
--popover-foreground: #f8fafc;
--primary: #0B0D0F;
--primary-foreground: #ffffff;
--secondary: #252a33;
--secondary-foreground: #f8fafc;
--muted: #252a33;
--muted-foreground: #a1a1aa;
--accent: #8FD7E8;
--accent-foreground: #111111;
--destructive: #9B2F3B;
--border: #303642;
--input: #303642;
--ring: #8FD7E8;
--chart-1: #0B0D0F;
--chart-2: #F7FAFB;
--chart-3: #8FD7E8;
--chart-4: #3F7A72;
--chart-5: #A2793A;
--sidebar: #181b22;
--sidebar-foreground: #f8fafc;
--sidebar-primary: #0B0D0F;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #8FD7E8;
--sidebar-accent-foreground: #111111;
--sidebar-border: #303642;
--sidebar-ring: #8FD7E8;
--radius: 16px;
}
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 OpticalShellcodeTerminalShadcnKit() {
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">Optical Shellcode Terminal</h2>
<p className="mt-1 max-w-xl text-sm text-muted-foreground">
Use the Katagami registry theme, then compose these shadcn primitives
with the language-specific component recipes.
</p>
</div>
<Button>Apply theme</Button>
</div>
<Tabs defaultValue="components">
<TabsList>
<TabsTrigger value="components">Components</TabsTrigger>
<TabsTrigger value="states">States</TabsTrigger>
<TabsTrigger value="export">Export</TabsTrigger>
</TabsList>
</Tabs>
<Card>
<CardHeader>
<CardTitle>Component recipe</CardTitle>
<CardDescription>
Replace this starter content with the agent-authored product scene
from components.md and preview-shots.json.
</CardDescription>
</CardHeader>
<CardContent className="grid gap-3 sm:grid-cols-[1fr_auto]">
<Input defaultValue="Tokenized shadcn surface" aria-label="Recipe name" />
<Button variant="secondary">Preview state</Button>
</CardContent>
<CardFooter className="justify-between">
<Badge>Ready</Badge>
<Button variant="outline">Copy recipe</Button>
</CardFooter>
</Card>
</section>
);
}
{
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
"name": "optical-shellcode-terminal",
"type": "registry:theme",
"title": "Optical Shellcode Terminal shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#FBFCFC",
"foreground": "#111417",
"card": "#FFFFFF",
"card-foreground": "#111417",
"popover": "#FFFFFF",
"popover-foreground": "#111417",
"primary": "#0B0D0F",
"primary-foreground": "#ffffff",
"secondary": "#F7FAFB",
"secondary-foreground": "#111111",
"muted": "#667176",
"muted-foreground": "#111417",
"accent": "#8FD7E8",
"accent-foreground": "#111111",
"destructive": "#9B2F3B",
"border": "#0B0D0F",
"input": "#0B0D0F",
"ring": "#8FD7E8",
"chart-1": "#0B0D0F",
"chart-2": "#F7FAFB",
"chart-3": "#8FD7E8",
"chart-4": "#3F7A72",
"chart-5": "#A2793A",
"sidebar": "#FFFFFF",
"sidebar-foreground": "#111417",
"sidebar-primary": "#0B0D0F",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#6FAFC4",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#0B0D0F",
"sidebar-ring": "#8FD7E8",
"radius": "16px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#0B0D0F",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#8FD7E8",
"accent-foreground": "#111111",
"destructive": "#9B2F3B",
"border": "#303642",
"input": "#303642",
"ring": "#8FD7E8",
"chart-1": "#0B0D0F",
"chart-2": "#F7FAFB",
"chart-3": "#8FD7E8",
"chart-4": "#3F7A72",
"chart-5": "#A2793A",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#0B0D0F",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#8FD7E8",
"sidebar-accent-foreground": "#111111",
"sidebar-border": "#303642",
"sidebar-ring": "#8FD7E8",
"radius": "16px"
}
},
"meta": {
"source": "katagami",
"languageId": "optical-shellcode-terminal",
"slug": "optical-shellcode-terminal",
"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"
]
}
}
}
# Optical Shellcode Terminal shadcn/ui Components
Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `optical-shellcode-terminal`
Slug: `optical-shellcode-terminal`
## Intent
Optical Shellcode Terminal is a polished cybernetic minimalism system for interfaces that feel like a white shell around consciousness: quiet, clinical, translucent, and intellectually charged. It borrows the philosophical calm of late-90s anime cybernetics without cosplay, translating manga ink contours, shellcode terminals, optical camouflage, Y2K acrylic, and diagnostic grids into a restrained product language for speculative neural tools.
## 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": "#8FD7E8",
"background": "#FBFCFC",
"border": "#0B0D0F",
"error": "#9B2F3B",
"info": "#6FAFC4",
"muted": "#667176",
"primary": "#0B0D0F",
"secondary": "#F7FAFB",
"success": "#3F7A72",
"surface": "#FFFFFF",
"text": "#111417",
"warning": "#A2793A"
}
Typography:
{
"base_size": "16px",
"body_font": "Archivo",
"google_fonts_url": "https://fonts.googleapis.com/css2?family=Archivo:wdth,wght@85,300;85,400;90,500&family=Azeret+Mono:wght@300;400;500&family=Michroma&display=swap",
"heading_font": "Michroma",
"letter_spacing": "-0.02em",
"line_height": 1.55,
"mono_font": "Azeret Mono",
"scale_ratio": 1.22
}
## Visual character to preserve
- Use a 12-column precision grid with two or more intentionally empty columns, plus absolute-positioned ghost coordinate labels in 10px monospace.
- Build panels as translucent white acrylic rectangles at 8-24% opacity with 1px rgba graphite borders and clipped terminal corner ticks.
- Insert sparse manga-like black ink contour lines as oversized SVG arcs or border silhouettes that structure the page without becoming illustration.
- Separate dense code/status areas with 1px repeating-linear-gradient scanline dividers and single-pixel pale cyan alert marks.
- Layer small floating terminal overlays above a sterile white field using minimal chrome highlights and almost no shadow depth.
## ShadSync visual profile
{
"family": "brutalist",
"material": "ink",
"contour": "default",
"border": "solid",
"underlay": false,
"grain": false,
"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/optical-shellcode-terminal/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: Use optical whites, soft blacks, pale cyan, and transparent acrylic as the only major visual vocabulary.; Keep terminal code blocks small and quiet, with expanded tracking and clinical labels rather than theatrical hacker glow.; Place at least one empty grid region with coordinates or crosshair dots so whitespace feels designed.; Use manga ink lines as SVG contour scaffolds, border arcs, or cropped silhouettes that support layout structure.; Make one panel visually dominant and vary section weights; avoid equal cards or repeated modular sameness.; Use body tracking at -0.02em, display tracking around -0.035em, display leading near 1.12, and body leading around 1.55.; Keep borders near-invisible and rely on tiny cyan ticks for system state changes.; Name scenes as specific speculative tools: memory-shell calibration, prosthetic identity audit, or autonomous consciousness interface.
- Do not: Do not use saturated neon cyan, magenta, green matrix rain, RGB gradients, or nightclub cyberpunk lighting.; Do not create generic dashboards, analytics cards, CRM tables, or component-library showcases.; Do not fill all empty space with widgets; the sterile void is part of the philosophical tone.; Do not use cartoon anime characters, fan-art panels, speech bubbles, or illustrative manga decoration.; Do not round every corner; use square terminal frames with only occasional 16px acrylic overlays.; Do not thicken borders beyond 1px except for sparse black contour silhouettes.; Do not use heavy shadows, plastic gloss, or skeuomorphic chrome; highlights must be cold and minimal.; Do not let cyan carry large surfaces; it belongs in pixels, hairlines, and terse status text only.
## 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 OpticalShellcodeTerminalShadcnKit() {
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">Optical Shellcode Terminal</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 <= 640px stacks overlays into a single column; tablet 641-1024px keeps a 6-column grid; desktop >= 1025px uses full 12-column asymmetry.",
"density": "Low global density with one high-compression code pocket; the large blank zones are active optical camouflage, not unused space.",
"grid": "Desktop uses a 12-column grid, 24px gutters, max-width 1320px, with columns 1-2 often left empty for coordinates and folio marks.",
"responsive": "On mobile, preserve the shell feeling by retaining coordinate labels and contour arcs while reducing code density and moving overlays below the main title.",
"whitespace": "Use dramatic 8:1 spacing rhythm: 4-8px inside telemetry rows, 48-96px between functional clusters, and 128px quiet fields on desktop."
}
{
"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": "optical-shellcode-terminal",
"name": "Optical Shellcode Terminal",
"slug": "optical-shellcode-terminal"
},
"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 a 12-column precision grid with two or more intentionally empty columns, plus absolute-positioned ghost coordinate labels in 10px monospace.",
"Build panels as translucent white acrylic rectangles at 8-24% opacity with 1px rgba graphite borders and clipped terminal corner ticks.",
"Insert sparse manga-like black ink contour lines as oversized SVG arcs or border silhouettes that structure the page without becoming illustration.",
"Separate dense code/status areas with 1px repeating-linear-gradient scanline dividers and single-pixel pale cyan alert marks.",
"Layer small floating terminal overlays above a sterile white field using minimal chrome highlights and almost no shadow depth."
],
"visualProfile": {
"family": "brutalist",
"material": "ink",
"contour": "default",
"border": "solid",
"underlay": false,
"grain": false,
"stickerBadges": false,
"motion": "still",
"density": "dense",
"accents": [
"primary",
"accent",
"secondary",
"muted"
]
},
"shots": [
{
"id": "application-shell",
"title": "Application shell",
"viewport": "desktop",
"primitives": [
"button",
"card",
"input",
"select",
"tabs",
"badge",
"separator",
"table"
],
"composition": "A real product workspace with navigation, summary cards, filtering controls, and one dense content region.",
"mustShow": [
"primary and secondary actions",
"card hierarchy",
"filterable state",
"table or list density"
],
"avoid": [
"component inventory walls",
"placeholder-only content",
"generic rounded SaaS chrome"
],
"scene": {
"eyebrow": "workspace spread",
"headline": "Optical Shellcode Terminal 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": [
"Use optical whites, soft blacks, pale cyan, and transparent acrylic as the only major visual vocabulary.",
"Keep terminal code blocks small and quiet, with expanded tracking and clinical labels rather than theatrical hacker glow.",
"Place at least one empty grid region with coordinates or crosshair dots so whitespace feels designed.",
"Use manga ink lines as SVG contour scaffolds, border arcs, or cropped silhouettes that support layout structure.",
"Make one panel visually dominant and vary section weights; avoid equal cards or repeated modular sameness.",
"Use body tracking at -0.02em, display tracking around -0.035em, display leading near 1.12, and body leading around 1.55.",
"Keep borders near-invisible and rely on tiny cyan ticks for system state changes.",
"Name scenes as specific speculative tools: memory-shell calibration, prosthetic identity audit, or autonomous consciousness interface."
],
"dont": [
"Do not use saturated neon cyan, magenta, green matrix rain, RGB gradients, or nightclub cyberpunk lighting.",
"Do not create generic dashboards, analytics cards, CRM tables, or component-library showcases.",
"Do not fill all empty space with widgets; the sterile void is part of the philosophical tone.",
"Do not use cartoon anime characters, fan-art panels, speech bubbles, or illustrative manga decoration.",
"Do not round every corner; use square terminal frames with only occasional 16px acrylic overlays.",
"Do not thicken borders beyond 1px except for sparse black contour silhouettes.",
"Do not use heavy shadows, plastic gloss, or skeuomorphic chrome; highlights must be cold and minimal.",
"Do not let cyan carry large surfaces; it belongs in pixels, hairlines, and terse status text only."
]
}
}