Subpixel Verification Studio
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
- 2px
- character
- consistent blue-gray hairlines; accent borders appear as focus rectangles around active controls, never side rails
- default width
- 1px
- style
- solid
colors12 items
motion3 items
- duration
- 140ms
- easing
- cubic-bezier(0.2, 0.8, 0.2, 1)
- philosophy
- states step between pixel cells and snap focus rectangles into place, avoiding floaty fades or arcade flashes
radii5 items
- full
- 9999px
- lg
- 14px
- md
- 10px
- none
- 0
- sm
- 6px
shadows3 items
- lg
- 0 24px 60px rgba(49, 46, 129, 0.13)
- md
- 0 12px 30px rgba(15, 23, 42, 0.08)
- sm
- 0 1px 2px rgba(15, 23, 42, 0.06)
spacing2 items
- base
- 8px
- scale
- 4, 8, 12, 16, 24, 32, 48, 64
surfaces3 items
- bg pattern
- plain neutral background with occasional isolated subpixel glyphs tied to product state only
- card style
- single-line white panels with internal pixel ledgers, compact headers, and state cells embedded in content
- treatment
- matte calibrated white planes with faint blue-gray inset rules and no repeated dot or square-grid texture
typography8 items
- base size
- 16px
- body font
- IBM Plex Sans
- google fonts url
- https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;500;600;700&family=Pixelify+Sans:wght@500;600;700&family=Space+Grotesk:wght@500;600;700&display=swap
- heading font
- Space Grotesk
- letter spacing
- -0.015em
- line height
- 1.5
- mono font
- Pixelify Sans
- scale ratio
- 1.22
rules
Compose around one dominant proof-tape artifact, then attach detail panes, command controls, and evidence rows as supporting instruments rather than equal dashboard cards.
Medium-high density with generous outer whitespace, compact internal cell spacing, and clear line-height so precision feels professional rather than cramped.
Use a sharp typographic voice split: Space Grotesk for calm product decisions, IBM Plex Sans for dense readable evidence, and Pixelify Sans for counters or machine-like status labels only.
layout
mobile 375px single stack, tablet 768px proof tape above two stacked panes, desktop 1440px two-column workspace with central artifact
Asymmetric product workspace with a dominant center column and narrower evidence rail; never a visible square background grid.
Large calm page margins surround compact proof instruments; internal gaps follow the 8px scale and keep pixel motifs sparse.
guidance
- Use white and neutral surfaces as the premium baseline, reserving indigo/cyan/turquoise/lime for stateful evidence.
- Let pixel motifs change controls, focus, counters, badges, and sequence states rather than becoming wallpaper.
- Use one dominant interaction artifact per screen, such as a proof tape, calibration queue, or release sequencer.
- Keep body text in readable IBM Plex Sans and restrict Pixelify Sans to short scannable fragments.
- Do not use square-grid backgrounds, default dotted textures, side rails, card stripes, or decorative left accents.
- Do not add chipped corners, uneven borders, retro arcade skins, blocky Minecraft styling, or low-resolution body text.
- Do not sprawl into rainbow palettes or warm decorative gradients; warm colors only appear as necessary warning/error semantics.
- Do not present a generic SaaS dashboard inventory of cards when a product-specific workflow artifact can lead.
katagami spec
# Subpixel Verification Studio ## Philosophy A premium product language for teams verifying launches and model changes through precise subpixel evidence: clean white calibration surfaces, a central proof-tape artifact, readable modern typography, and cool-electric indigo, cyan, turquoise, and lime states that behave like instrumentation rather than decoration. ### Values - precision over ornament - cool-electric color with semantic restraint - pixel motifs as state grammar - quiet premium product utility - single dominant interaction artifact ### Anti-Values - square grid backgrounds or default dotted wallpaper - arcade, Minecraft, hacker-terminal, or cyberpunk costume - generic dashboard cards and colored side rails - rainbow status sprawl or garnish accents ### Visual Character - Use matte white and warm-neutral full-bleed surfaces with thin 1px blue-gray hairlines, no square grid wallpaper, and depth created by tight inset lines rather than heavy shadows. - Place the primary workflow inside a horizontal proof-tape sequence made from compact rectangular pixel cells, stepped counters, and connected state blocks instead of ordinary dashboard tiles. - Pair Space Grotesk headings and IBM Plex Sans body copy with Pixelify Sans only for counters, badges, short labels, and coordinate-like microcopy so readability remains premium. - Apply indigo, cyan, turquoise, and neon lime as functional state fills, focus rings, progress cells, and command feedback, never as decorative stripes on card or button edges. - Use squared micro-geometry with a committed 10px radius system, clipped only by inset rectangular pixels and never by chipped or diagonal card corners. ## Tokens ### Borders - **Accent Width**: 2px - **Character**: consistent blue-gray hairlines; accent borders appear as focus rectangles around active controls, never side rails - **Default Width**: 1px - **Style**: solid ### Colors | Name | Value | |------|-------| | accent | `#C6FF2E` | | background | `#F8FAFC` | | border | `#CBD5E1` | | error | `#DC2626` | | info | `#06B6D4` | | muted | `#64748B` | | primary | `#312E81` | | secondary | `#0891B2` | | success | `#16A34A` | | surface | `#FFFFFF` | | text | `#111827` | | warning | `#B45309` | ### Motion - **Duration**: 140ms - **Easing**: cubic-bezier(0.2, 0.8, 0.2, 1) - **Philosophy**: states step between pixel cells and snap focus rectangles into place, avoiding floaty fades or arcade flashes ### Radii - **Full**: 9999px - **Lg**: 14px - **Md**: 10px - **None**: 0 - **Sm**: 6px ### Shadows - **Lg**: 0 24px 60px rgba(49, 46, 129, 0.13) - **Md**: 0 12px 30px rgba(15, 23, 42, 0.08) - **Sm**: 0 1px 2px rgba(15, 23, 42, 0.06) ### Spacing - **Base**: 8px - **Scale**: [4,8,12,16,24,32,48,64] ### Surfaces - **Bg Pattern**: plain neutral background with occasional isolated subpixel glyphs tied to product state only - **Card Style**: single-line white panels with internal pixel ledgers, compact headers, and state cells embedded in content - **Treatment**: matte calibrated white planes with faint blue-gray inset rules and no repeated dot or square-grid texture ### Typography - **Base Size**: 16px - **Body Font**: IBM Plex Sans - **Google Fonts Url**: https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;500;600;700&family=Pixelify+Sans:wght@500;600;700&family=Space+Grotesk:wght@500;600;700&display=swap - **Heading Font**: Space Grotesk - **Letter Spacing**: -0.015em - **Line Height**: 1.5 - **Mono Font**: Pixelify Sans - **Scale Ratio**: 1.22 ## Rules ### Composition Compose around one dominant proof-tape artifact, then attach detail panes, command controls, and evidence rows as supporting instruments rather than equal dashboard cards. ### Density Medium-high density with generous outer whitespace, compact internal cell spacing, and clear line-height so precision feels professional rather than cramped. ### Hierarchy Use a sharp typographic voice split: Space Grotesk for calm product decisions, IBM Plex Sans for dense readable evidence, and Pixelify Sans for counters or machine-like status labels only. ### Signature Patterns - Proof-tape sequence appears at the top of workflow screens, changes cell fill by state, and establishes the primary hierarchy before any supporting pane. - Subpixel focus frames use 2px cyan or lime rectangular outlines plus tiny corner cells on active fields, tabs, switches, and command buttons. - Pixel numerals and coordinate badges appear only for counts, versions, confidence values, and timestamps, creating a precision layer without harming body readability. - Evidence rows use embedded micro-cell meters and inline glyph blocks to communicate state, avoiding colored side strips, generic charts, and rainbow legends. ## Layout ### Breakpoints mobile 375px single stack, tablet 768px proof tape above two stacked panes, desktop 1440px two-column workspace with central artifact ### Grid Asymmetric product workspace with a dominant center column and narrower evidence rail; never a visible square background grid. ### Whitespace Large calm page margins surround compact proof instruments; internal gaps follow the 8px scale and keep pixel motifs sparse. ## Guidance ### Do - Use white and neutral surfaces as the premium baseline, reserving indigo/cyan/turquoise/lime for stateful evidence. - Let pixel motifs change controls, focus, counters, badges, and sequence states rather than becoming wallpaper. - Use one dominant interaction artifact per screen, such as a proof tape, calibration queue, or release sequencer. - Keep body text in readable IBM Plex Sans and restrict Pixelify Sans to short scannable fragments. ### Don't - Do not use square-grid backgrounds, default dotted textures, side rails, card stripes, or decorative left accents. - Do not add chipped corners, uneven borders, retro arcade skins, blocky Minecraft styling, or low-resolution body text. - Do not sprawl into rainbow palettes or warm decorative gradients; warm colors only appear as necessary warning/error semantics. - Do not present a generic SaaS dashboard inventory of cards when a product-specific workflow artifact can lead.
DESIGN.md
---
version: "alpha"
name: "Subpixel Verification Studio"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
accent: "#C6FF2E"
background: "#F8FAFC"
border: "#CBD5E1"
error: "#DC2626"
info: "#06B6D4"
muted: "#64748B"
primary: "#312E81"
secondary: "#0891B2"
success: "#16A34A"
surface: "#FFFFFF"
text: "#111827"
warning: "#B45309"
typography:
headline-lg:
fontFamily: "Space Grotesk"
fontSize: "1.816rem"
fontWeight: 700
lineHeight: 1.1
letterSpacing: "-0.015em"
headline-md:
fontFamily: "Space Grotesk"
fontSize: "1.488rem"
fontWeight: 600
lineHeight: 1.15
letterSpacing: "-0.015em"
body-md:
fontFamily: "IBM Plex Sans"
fontSize: "16px"
fontWeight: 400
lineHeight: 1.5
letterSpacing: "-0.015em"
label-md:
fontFamily: "Pixelify Sans"
fontSize: "0.75rem"
fontWeight: 600
lineHeight: 1
letterSpacing: "0.08em"
rounded:
full: "9999px"
lg: "14px"
md: "10px"
none: "0px"
sm: "6px"
spacing:
base: "8px"
xs: "4px"
sm: "8px"
md: "12px"
lg: "16px"
xl: "24px"
2xl: "32px"
3xl: "48px"
4xl: "64px"
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"
---
# Subpixel Verification Studio
## Overview
A premium product language for teams verifying launches and model changes through precise subpixel evidence: clean white calibration surfaces, a central proof-tape artifact, readable modern typography, and cool-electric indigo, cyan, turquoise, and lime states that behave like instrumentation rather than decoration.
### Values
- precision over ornament
- cool-electric color with semantic restraint
- pixel motifs as state grammar
- quiet premium product utility
- single dominant interaction artifact
### Anti-Values
- square grid backgrounds or default dotted wallpaper
- arcade, Minecraft, hacker-terminal, or cyberpunk costume
- generic dashboard cards and colored side rails
- rainbow status sprawl or garnish accents
### Visual Character
- Use matte white and warm-neutral full-bleed surfaces with thin 1px blue-gray hairlines, no square grid wallpaper, and depth created by tight inset lines rather than heavy shadows.
- Place the primary workflow inside a horizontal proof-tape sequence made from compact rectangular pixel cells, stepped counters, and connected state blocks instead of ordinary dashboard tiles.
- Pair Space Grotesk headings and IBM Plex Sans body copy with Pixelify Sans only for counters, badges, short labels, and coordinate-like microcopy so readability remains premium.
- Apply indigo, cyan, turquoise, and neon lime as functional state fills, focus rings, progress cells, and command feedback, never as decorative stripes on card or button edges.
- Use squared micro-geometry with a committed 10px radius system, clipped only by inset rectangular pixels and never by chipped or diagonal card corners.
## 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 | `#C6FF2E` |
| background | `#F8FAFC` |
| border | `#CBD5E1` |
| error | `#DC2626` |
| info | `#06B6D4` |
| muted | `#64748B` |
| primary | `#312E81` |
| secondary | `#0891B2` |
| success | `#16A34A` |
| surface | `#FFFFFF` |
| text | `#111827` |
| warning | `#B45309` |
## Typography
- **Headline-Lg**: Space Grotesk, 1.816rem, weight 700, line-height 1.1.
- **Headline-Md**: Space Grotesk, 1.488rem, weight 600, line-height 1.15.
- **Body-Md**: IBM Plex Sans, 16px, weight 400, line-height 1.5.
- **Label-Md**: Pixelify Sans, 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`
### Breakpoints
mobile 375px single stack, tablet 768px proof tape above two stacked panes, desktop 1440px two-column workspace with central artifact
### Grid
Asymmetric product workspace with a dominant center column and narrower evidence rail; never a visible square background grid.
### Whitespace
Large calm page margins surround compact proof instruments; internal gaps follow the 8px scale and keep pixel motifs sparse.
## Elevation & Depth
### Shadows
- **Lg**: 0 24px 60px rgba(49, 46, 129, 0.13)
- **Md**: 0 12px 30px rgba(15, 23, 42, 0.08)
- **Sm**: 0 1px 2px rgba(15, 23, 42, 0.06)
## Shapes
### Rounded
- **Full**: `9999px`
- **Lg**: `14px`
- **Md**: `10px`
- **None**: `0px`
- **Sm**: `6px`
### Surfaces
- **Bg Pattern**: plain neutral background with occasional isolated subpixel glyphs tied to product state only
- **Card Style**: single-line white panels with internal pixel ledgers, compact headers, and state cells embedded in content
- **Treatment**: matte calibrated white planes with faint blue-gray inset rules and no repeated dot or square-grid texture
### Borders
- **Accent Width**: 2px
- **Character**: consistent blue-gray hairlines; accent borders appear as focus rectangles around active controls, never side rails
- **Default Width**: 1px
- **Style**: solid
## Components
### Composition
Compose around one dominant proof-tape artifact, then attach detail panes, command controls, and evidence rows as supporting instruments rather than equal dashboard cards.
### Density
Medium-high density with generous outer whitespace, compact internal cell spacing, and clear line-height so precision feels professional rather than cramped.
### Hierarchy
Use a sharp typographic voice split: Space Grotesk for calm product decisions, IBM Plex Sans for dense readable evidence, and Pixelify Sans for counters or machine-like status labels only.
### Signature Patterns
- Proof-tape sequence appears at the top of workflow screens, changes cell fill by state, and establishes the primary hierarchy before any supporting pane.
- Subpixel focus frames use 2px cyan or lime rectangular outlines plus tiny corner cells on active fields, tabs, switches, and command buttons.
- Pixel numerals and coordinate badges appear only for counts, versions, confidence values, and timestamps, creating a precision layer without harming body readability.
- Evidence rows use embedded micro-cell meters and inline glyph blocks to communicate state, avoiding colored side strips, generic charts, and rainbow legends.
## 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/en-019e4bf7-1a78-7972-832d-7262abe9ad2b/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 white and neutral surfaces as the premium baseline, reserving indigo/cyan/turquoise/lime for stateful evidence.
- Do Let pixel motifs change controls, focus, counters, badges, and sequence states rather than becoming wallpaper.
- Do Use one dominant interaction artifact per screen, such as a proof tape, calibration queue, or release sequencer.
- Do Keep body text in readable IBM Plex Sans and restrict Pixelify Sans to short scannable fragments.
- Don't Do not use square-grid backgrounds, default dotted textures, side rails, card stripes, or decorative left accents.
- Don't Do not add chipped corners, uneven borders, retro arcade skins, blocky Minecraft styling, or low-resolution body text.
- Don't Do not sprawl into rainbow palettes or warm decorative gradients; warm colors only appear as necessary warning/error semantics.
- Don't Do not present a generic SaaS dashboard inventory of cards when a product-specific workflow artifact can lead.
shadcn/ui theme
```json
{
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
"name": "subpixel-verification-studio",
"type": "registry:theme",
"title": "Subpixel Verification Studio shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#F8FAFC",
"foreground": "#111827",
"card": "#FFFFFF",
"card-foreground": "#111827",
"popover": "#FFFFFF",
"popover-foreground": "#111827",
"primary": "#312E81",
"primary-foreground": "#ffffff",
"secondary": "#0891B2",
"secondary-foreground": "#ffffff",
"muted": "#64748B",
"muted-foreground": "#111827",
"accent": "#C6FF2E",
"accent-foreground": "#111111",
"destructive": "#DC2626",
"border": "#CBD5E1",
"input": "#CBD5E1",
"ring": "#C6FF2E",
"chart-1": "#312E81",
"chart-2": "#0891B2",
"chart-3": "#C6FF2E",
"chart-4": "#16A34A",
"chart-5": "#B45309",
"sidebar": "#FFFFFF",
"sidebar-foreground": "#111827",
"sidebar-primary": "#312E81",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#06B6D4",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#CBD5E1",
"sidebar-ring": "#C6FF2E",
"radius": "10px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#312E81",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#C6FF2E",
"accent-foreground": "#111111",
"destructive": "#DC2626",
"border": "#303642",
"input": "#303642",
"ring": "#C6FF2E",
"chart-1": "#312E81",
"chart-2": "#0891B2",
"chart-3": "#C6FF2E",
"chart-4": "#16A34A",
"chart-5": "#B45309",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#312E81",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#C6FF2E",
"sidebar-accent-foreground": "#111111",
"sidebar-border": "#303642",
"sidebar-ring": "#C6FF2E",
"radius": "10px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019e4bf7-1a78-7972-832d-7262abe9ad2b",
"slug": "subpixel-verification-studio",
"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
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: #F8FAFC;
--foreground: #111827;
--card: #FFFFFF;
--card-foreground: #111827;
--popover: #FFFFFF;
--popover-foreground: #111827;
--primary: #312E81;
--primary-foreground: #ffffff;
--secondary: #0891B2;
--secondary-foreground: #ffffff;
--muted: #64748B;
--muted-foreground: #111827;
--accent: #C6FF2E;
--accent-foreground: #111111;
--destructive: #DC2626;
--border: #CBD5E1;
--input: #CBD5E1;
--ring: #C6FF2E;
--chart-1: #312E81;
--chart-2: #0891B2;
--chart-3: #C6FF2E;
--chart-4: #16A34A;
--chart-5: #B45309;
--sidebar: #FFFFFF;
--sidebar-foreground: #111827;
--sidebar-primary: #312E81;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #06B6D4;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #CBD5E1;
--sidebar-ring: #C6FF2E;
--radius: 10px;
}
.dark {
--background: #0f1115;
--foreground: #f8fafc;
--card: #181b22;
--card-foreground: #f8fafc;
--popover: #181b22;
--popover-foreground: #f8fafc;
--primary: #312E81;
--primary-foreground: #ffffff;
--secondary: #252a33;
--secondary-foreground: #f8fafc;
--muted: #252a33;
--muted-foreground: #a1a1aa;
--accent: #C6FF2E;
--accent-foreground: #111111;
--destructive: #DC2626;
--border: #303642;
--input: #303642;
--ring: #C6FF2E;
--chart-1: #312E81;
--chart-2: #0891B2;
--chart-3: #C6FF2E;
--chart-4: #16A34A;
--chart-5: #B45309;
--sidebar: #181b22;
--sidebar-foreground: #f8fafc;
--sidebar-primary: #312E81;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #C6FF2E;
--sidebar-accent-foreground: #111111;
--sidebar-border: #303642;
--sidebar-ring: #C6FF2E;
--radius: 10px;
}
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 SubpixelVerificationStudioShadcnKit() {
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">Subpixel Verification Studio</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": "subpixel-verification-studio",
"type": "registry:theme",
"title": "Subpixel Verification Studio shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#F8FAFC",
"foreground": "#111827",
"card": "#FFFFFF",
"card-foreground": "#111827",
"popover": "#FFFFFF",
"popover-foreground": "#111827",
"primary": "#312E81",
"primary-foreground": "#ffffff",
"secondary": "#0891B2",
"secondary-foreground": "#ffffff",
"muted": "#64748B",
"muted-foreground": "#111827",
"accent": "#C6FF2E",
"accent-foreground": "#111111",
"destructive": "#DC2626",
"border": "#CBD5E1",
"input": "#CBD5E1",
"ring": "#C6FF2E",
"chart-1": "#312E81",
"chart-2": "#0891B2",
"chart-3": "#C6FF2E",
"chart-4": "#16A34A",
"chart-5": "#B45309",
"sidebar": "#FFFFFF",
"sidebar-foreground": "#111827",
"sidebar-primary": "#312E81",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#06B6D4",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#CBD5E1",
"sidebar-ring": "#C6FF2E",
"radius": "10px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#312E81",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#C6FF2E",
"accent-foreground": "#111111",
"destructive": "#DC2626",
"border": "#303642",
"input": "#303642",
"ring": "#C6FF2E",
"chart-1": "#312E81",
"chart-2": "#0891B2",
"chart-3": "#C6FF2E",
"chart-4": "#16A34A",
"chart-5": "#B45309",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#312E81",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#C6FF2E",
"sidebar-accent-foreground": "#111111",
"sidebar-border": "#303642",
"sidebar-ring": "#C6FF2E",
"radius": "10px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019e4bf7-1a78-7972-832d-7262abe9ad2b",
"slug": "subpixel-verification-studio",
"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"
]
}
}
}
# Subpixel Verification Studio shadcn/ui Components
Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `en-019e4bf7-1a78-7972-832d-7262abe9ad2b`
Slug: `subpixel-verification-studio`
## Intent
A premium product language for teams verifying launches and model changes through precise subpixel evidence: clean white calibration surfaces, a central proof-tape artifact, readable modern typography, and cool-electric indigo, cyan, turquoise, and lime states that behave like instrumentation rather than decoration.
## 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": "#C6FF2E",
"background": "#F8FAFC",
"border": "#CBD5E1",
"error": "#DC2626",
"info": "#06B6D4",
"muted": "#64748B",
"primary": "#312E81",
"secondary": "#0891B2",
"success": "#16A34A",
"surface": "#FFFFFF",
"text": "#111827",
"warning": "#B45309"
}
Typography:
{
"base_size": "16px",
"body_font": "IBM Plex Sans",
"google_fonts_url": "https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;500;600;700&family=Pixelify+Sans:wght@500;600;700&family=Space+Grotesk:wght@500;600;700&display=swap",
"heading_font": "Space Grotesk",
"letter_spacing": "-0.015em",
"line_height": 1.5,
"mono_font": "Pixelify Sans",
"scale_ratio": 1.22
}
## Visual character to preserve
- Use matte white and warm-neutral full-bleed surfaces with thin 1px blue-gray hairlines, no square grid wallpaper, and depth created by tight inset lines rather than heavy shadows.
- Place the primary workflow inside a horizontal proof-tape sequence made from compact rectangular pixel cells, stepped counters, and connected state blocks instead of ordinary dashboard tiles.
- Pair Space Grotesk headings and IBM Plex Sans body copy with Pixelify Sans only for counters, badges, short labels, and coordinate-like microcopy so readability remains premium.
- Apply indigo, cyan, turquoise, and neon lime as functional state fills, focus rings, progress cells, and command feedback, never as decorative stripes on card or button edges.
- Use squared micro-geometry with a committed 10px radius system, clipped only by inset rectangular pixels and never by chipped or diagonal card corners.
## ShadSync visual profile
{
"family": "paper-collage",
"material": "paper",
"contour": "default",
"border": "solid",
"underlay": false,
"grain": true,
"stickerBadges": true,
"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/subpixel-verification-studio/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 white and neutral surfaces as the premium baseline, reserving indigo/cyan/turquoise/lime for stateful evidence.; Let pixel motifs change controls, focus, counters, badges, and sequence states rather than becoming wallpaper.; Use one dominant interaction artifact per screen, such as a proof tape, calibration queue, or release sequencer.; Keep body text in readable IBM Plex Sans and restrict Pixelify Sans to short scannable fragments.
- Do not: Do not use square-grid backgrounds, default dotted textures, side rails, card stripes, or decorative left accents.; Do not add chipped corners, uneven borders, retro arcade skins, blocky Minecraft styling, or low-resolution body text.; Do not sprawl into rainbow palettes or warm decorative gradients; warm colors only appear as necessary warning/error semantics.; Do not present a generic SaaS dashboard inventory of cards when a product-specific workflow artifact can lead.
## 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 SubpixelVerificationStudioShadcnKit() {
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">Subpixel Verification Studio</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 375px single stack, tablet 768px proof tape above two stacked panes, desktop 1440px two-column workspace with central artifact",
"grid": "Asymmetric product workspace with a dominant center column and narrower evidence rail; never a visible square background grid.",
"whitespace": "Large calm page margins surround compact proof instruments; internal gaps follow the 8px scale and keep pixel motifs sparse."
}
{
"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": "en-019e4bf7-1a78-7972-832d-7262abe9ad2b",
"name": "Subpixel Verification Studio",
"slug": "subpixel-verification-studio"
},
"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 matte white and warm-neutral full-bleed surfaces with thin 1px blue-gray hairlines, no square grid wallpaper, and depth created by tight inset lines rather than heavy shadows.",
"Place the primary workflow inside a horizontal proof-tape sequence made from compact rectangular pixel cells, stepped counters, and connected state blocks instead of ordinary dashboard tiles.",
"Pair Space Grotesk headings and IBM Plex Sans body copy with Pixelify Sans only for counters, badges, short labels, and coordinate-like microcopy so readability remains premium.",
"Apply indigo, cyan, turquoise, and neon lime as functional state fills, focus rings, progress cells, and command feedback, never as decorative stripes on card or button edges.",
"Use squared micro-geometry with a committed 10px radius system, clipped only by inset rectangular pixels and never by chipped or diagonal card corners."
],
"visualProfile": {
"family": "paper-collage",
"material": "paper",
"contour": "default",
"border": "solid",
"underlay": false,
"grain": true,
"stickerBadges": true,
"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": "Subpixel Verification Studio 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 white and neutral surfaces as the premium baseline, reserving indigo/cyan/turquoise/lime for stateful evidence.",
"Let pixel motifs change controls, focus, counters, badges, and sequence states rather than becoming wallpaper.",
"Use one dominant interaction artifact per screen, such as a proof tape, calibration queue, or release sequencer.",
"Keep body text in readable IBM Plex Sans and restrict Pixelify Sans to short scannable fragments."
],
"dont": [
"Do not use square-grid backgrounds, default dotted textures, side rails, card stripes, or decorative left accents.",
"Do not add chipped corners, uneven borders, retro arcade skins, blocky Minecraft styling, or low-resolution body text.",
"Do not sprawl into rainbow palettes or warm decorative gradients; warm colors only appear as necessary warning/error semantics.",
"Do not present a generic SaaS dashboard inventory of cards when a product-specific workflow artifact can lead."
]
}
}