back to gallery
design language·optical-shellcode-terminal

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.

the spec

specification

philosophy
summary
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.
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
accent
#8FD7E8
background
#FBFCFC
border
#0B0D0F
error
#9B2F3B
info
#6FAFC4
muted
#667176
primary
#0B0D0F
secondary
#F7FAFB
success
#3F7A72
surface
#FFFFFF
text
#111417
warning
#A2793A
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
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.
avoid
  • 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"
      ]
    }
  }
}
```
in the wild

embodiments

the full element showcase
embodiment · optical-shellcode-terminal
DESIGN.md

at a glance

Palette

Typography

headline-lgMichroma · 29px · 700

The quick brown fox jumps

headline-mdMichroma · 24px · 600

The quick brown fox jumps

body-mdArchivo · 16px · 400

The quick brown fox jumps

label-mdAzeret 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
lg24px
md16px
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: #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;
}
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 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>
  );
}
theme JSONcompatibility fallback
{
  "$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"
      ]
    }
  }
}
component recipescompatibility fallback
# 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."
}
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": "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."
    ]
  }
}
related

More like this