A portable design language for agents: download the markdown first, then inspect the preview, tokens, and rules as needed.
Portable DESIGN.md — tokens plus the paired art style. Agents must generate real images.
A faithful modernisation of Risograph Spot-Color Editorial, keeping its paper-and-spot-ink identity and rebuilding it on measured floors, one radius degree and a scroll-cinematic landing.
Build pages as printed sheets: one poster hero at full bleed, story bands separated by 2px ink rules, a metadata docket sized to its own text, and plates that carry their caption below them. Asymmetric spans — a dominant block beside a narrow rail — never equal columns.
Scale contrast between an Archivo Black display moment and a fine 17px Newsreader body, with mono 11.5–13px caps carrying pressroom furniture. The mid-tier compresses toward body scale; only earned moments are large.
Medium: generous margins and poster-scale band spacing, tight leading inside metadata strips and tables. Few bold modules rather than many small utilities.
A 12-column editorial grid at desktop collapsing to 8 at tablet and 4 on the phone, with asymmetric hero spans, a dominant block beside a narrow rail, and a content cap of 1380px (1480px above 1700px). Only the hero plate bleeds to 100vw.
wide 1700+, desktop 1100–1699, landscape tablet 860–1099, portrait tablet 720–859, phone 0–719 — each art-directed, with every landing scene recomposed to fit one viewport exactly.
Poster-scale space between story bands, generous outer margins, always padding above titles, and compressed internal spacing inside labels, dockets and metadata strips.
kappazuri
Flat two-drum stencil prints: cut-paper shapes with hard scissored edges and no internal shading, printed in fluorescent pink and federal blue on warm uncoated paper, each ink laid as a separate pass so contours sit a millimetre out of register, coarse mesh grain and halftone screens in the mid-tones.
One full-bleed plate at 100vw with a wide quiet region reserved for display type — an open sky, a flat ground band, or a dark silhouette mass that paper-cream type can sit on at 10:1.
Cut geometric SVG primitives in ink: squares, crosshairs, chevrons. No icon fonts, no emoji, no symbol glyphs in copy.
# Gocco ## Philosophy A two-drum stencil-print language for editorial work: warm paper ground, one fluorescent pink drum, one federal blue drum, and a plum third colour that exists only where the two passes overlap. Registration is the interaction model — every control arrives a few pixels out of true and walks into register when you touch it, and a disabled control is a single pass with no second colour. ### Values - two spot inks and paper over full-spectrum colour - registration as behaviour, not decoration - printed matter over screen chrome - a fine serif reading voice under poster-scale display - square geometry, cut rather than rounded ### Anti-Values - rounded cards and pill controls - soft shadows, glows and glass - coloured edge accents standing in for status - heavy body type and inflated mid-scale - pattern fields running under copy ### Visual Character - warm cream paper (#F5EBD8) with a fibre-grain multiply over every surface - hard offset second pass: box-shadow 4px 4px 0 in the paired ink, collapsing to 0 on interaction - radius 0 on every element — cards, chips, inputs, avatars and thumbnails alike - bright inks (#FF3F8E, #2F5CE0) as fills only; ink-weight variants (#C2005B, #1D3FA8, #4B2A86) set type - 2px ink poster rules and 1px hairline row rules; no element borders anywhere - flat cut-paper plates in the same two inks as the interface, with wide bare-paper zones reserved for type ### Lineage > A faithful modernisation of Risograph Spot-Color Editorial, keeping its paper-and-spot-ink identity and rebuilding it on measured floors, one radius degree and a scroll-cinematic landing. ## Tokens ### Colors | Name | Value | |------|-------| | bg | `#F5EBD8` | | surface | `#EDE0C6` | | surface_solid | `#F9F2E4` | | text | `#171626` | | muted | `#6A6353` | | border | `#171626` | | accent | `#FF3F8E` | | accent_2 | `#2F5CE0` | | accent_soft | `#4B2A86` | | on_accent | `#171626` | | success | `#2F7D53` | | warning | `#A9711A` | | error | `#C2372A` | | info | `#1D3FA8` | ### Typography - **Base Size**: 17px - **Body Font**: Newsreader - **Heading Font**: Archivo Black - **Mono Font**: IBM Plex Mono - **Heading Weight**: 400 - **Heading Transform**: none - **Letter Spacing**: -0.02em - **Line Height**: 1.62 - **Scale Ratio**: 1.3 - **Google Fonts Url**: https://fonts.googleapis.com/css2?family=Archivo+Black&family=IBM+Plex+Mono:wght@400;500&family=Newsreader:opsz,wght@6..72,300;6..72,400;6..72,600&display=swap ### Radii - **None**: 0px - **Md**: 16px - **Lg**: 24px - **Full**: 9999px ### Shadows - **Sm**: 2px 2px 0 #2F5CE0 - **Md**: 4px 4px 0 #2F5CE0 - **Lg**: 8px 8px 0 #171626 ### Spacing - **Base**: 8px - **Scale**: [4,8,12,16,24,32,48,64] ### Surfaces - **Treatment**: paper - **Card Style**: flat cream sheets with a fibre-grain multiply; a pink flood for single-ink pages and a plum flood for the overlap - **Bg Pattern**: grain ### Borders - **Default Width**: 0px - **Accent Width**: 2px - **Style**: solid - **Character**: full-width ink poster rules under mastheads, section heads and table heads, plus 1px hairline row rules; no element ever carries a border or a single coloured edge ### Motion - **Duration**: 180ms - **Easing**: cubic-bezier(0.22, 1, 0.36, 1) - **Philosophy**: registration — arrivals settle from the offset into true; scroll-scrubbed work is linear so the reader's hand is the only easing ## Rules ### Composition Build pages as printed sheets: one poster hero at full bleed, story bands separated by 2px ink rules, a metadata docket sized to its own text, and plates that carry their caption below them. Asymmetric spans — a dominant block beside a narrow rail — never equal columns. ### Hierarchy Scale contrast between an Archivo Black display moment and a fine 17px Newsreader body, with mono 11.5–13px caps carrying pressroom furniture. The mid-tier compresses toward body scale; only earned moments are large. ### Density Medium: generous margins and poster-scale band spacing, tight leading inside metadata strips and tables. Few bold modules rather than many small utilities. ### Signature Patterns - the second pass — a 4px offset duplicate in the paired ink that comes into register on hover, focus and press - disabled means a single pass: the second colour is dropped entirely - headlines carry two ghost passes (pink and blue) behind the ink layer - status is a chip with a semantic square or a full ink flood, never an edge accent - the docket: a slip of paper sized to its own text, carrying mono metadata over imagery - halftone dot screens appear in transitions and non-text bands only ## Layout ### Grid A 12-column editorial grid at desktop collapsing to 8 at tablet and 4 on the phone, with asymmetric hero spans, a dominant block beside a narrow rail, and a content cap of 1380px (1480px above 1700px). Only the hero plate bleeds to 100vw. ### Breakpoints wide 1700+, desktop 1100–1699, landscape tablet 860–1099, portrait tablet 720–859, phone 0–719 — each art-directed, with every landing scene recomposed to fit one viewport exactly. ### Whitespace Poster-scale space between story bands, generous outer margins, always padding above titles, and compressed internal spacing inside labels, dockets and metadata strips. ## Guidance ### Do - keep each screen to two drums plus paper, and let the third colour appear only in the overlap - use the bright inks as fills and the ink-weight variants for type - let the grain and paper fibre show through the flats - express state in chips, floods and plain words - compose pages as sheets: poster hero, story bands, a printed docket of metadata ### Don't - round a corner anywhere in the set - run a coloured strip down the edge of a card - set body copy in a heavy weight or inflate the mid-tier toward display scale - run a halftone or pattern field under running copy - add a soft shadow, a glow, a gradient or a glass surface ## Imagery Direction ### Pairs With kappazuri ### Illustration Style Flat two-drum stencil prints: cut-paper shapes with hard scissored edges and no internal shading, printed in fluorescent pink and federal blue on warm uncoated paper, each ink laid as a separate pass so contours sit a millimetre out of register, coarse mesh grain and halftone screens in the mid-tones. ### Hero Image Direction One full-bleed plate at 100vw with a wide quiet region reserved for display type — an open sky, a flat ground band, or a dark silhouette mass that paper-cream type can sit on at 10:1. ### Icon Style Cut geometric SVG primitives in ink: squares, crosshairs, chevrons. No icon fonts, no emoji, no symbol glyphs in copy. ### Image Gen Prompts - a harbour city seen from a rooftop at dusk, wide empty sky, two-drum stencil print - two figures carrying a long ladder through tall grass, flat silhouettes on bare paper - a lit window with a cat on the sill, second pass landed out of register - a still life of a teapot, two cups and three pears on a plain table - a crowd of open umbrellas seen from directly above, overlapping into plum
---
version: "alpha"
name: "Gocco"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
bg: "#F5EBD8"
surface: "#EDE0C6"
surface_solid: "#F9F2E4"
text: "#171626"
muted: "#6A6353"
border: "#171626"
accent: "#FF3F8E"
accent_2: "#2F5CE0"
accent_soft: "#4B2A86"
on_accent: "#171626"
success: "#2F7D53"
warning: "#A9711A"
error: "#C2372A"
info: "#1D3FA8"
typography:
headline-lg:
fontFamily: "Archivo Black"
fontSize: "2.334rem"
fontWeight: 700
lineHeight: 1.1
letterSpacing: "-0.02em"
headline-md:
fontFamily: "Archivo Black"
fontSize: "1.796rem"
fontWeight: 600
lineHeight: 1.15
letterSpacing: "-0.02em"
body-md:
fontFamily: "Newsreader"
fontSize: "17px"
fontWeight: 400
lineHeight: 1.62
letterSpacing: "-0.02em"
label-md:
fontFamily: "IBM Plex Mono"
fontSize: "0.75rem"
fontWeight: 600
lineHeight: 1
letterSpacing: "0.08em"
rounded:
none: "0px"
md: "16px"
lg: "24px"
full: "9999px"
spacing:
base: "8px"
xs: "4px"
sm: "8px"
md: "12px"
lg: "16px"
xl: "24px"
2xl: "32px"
3xl: "48px"
4xl: "64px"
components:
color-reference-bg:
backgroundColor: "{colors.bg}"
color-reference-surface:
backgroundColor: "{colors.surface}"
color-reference-surface_solid:
backgroundColor: "{colors.surface_solid}"
color-reference-text:
backgroundColor: "{colors.text}"
color-reference-muted:
backgroundColor: "{colors.muted}"
color-reference-border:
backgroundColor: "{colors.border}"
color-reference-accent:
backgroundColor: "{colors.accent}"
color-reference-accent_2:
backgroundColor: "{colors.accent_2}"
color-reference-accent_soft:
backgroundColor: "{colors.accent_soft}"
color-reference-on_accent:
backgroundColor: "{colors.on_accent}"
color-reference-success:
backgroundColor: "{colors.success}"
color-reference-warning:
backgroundColor: "{colors.warning}"
color-reference-error:
backgroundColor: "{colors.error}"
color-reference-info:
backgroundColor: "{colors.info}"
button-primary:
backgroundColor: "{colors.accent}"
textColor: "#000000"
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"
---
# Gocco
## Overview
A two-drum stencil-print language for editorial work: warm paper ground, one fluorescent pink drum, one federal blue drum, and a plum third colour that exists only where the two passes overlap. Registration is the interaction model — every control arrives a few pixels out of true and walks into register when you touch it, and a disabled control is a single pass with no second colour.
### Values
- two spot inks and paper over full-spectrum colour
- registration as behaviour, not decoration
- printed matter over screen chrome
- a fine serif reading voice under poster-scale display
- square geometry, cut rather than rounded
### Anti-Values
- rounded cards and pill controls
- soft shadows, glows and glass
- coloured edge accents standing in for status
- heavy body type and inflated mid-scale
- pattern fields running under copy
### Visual Character
- warm cream paper (#F5EBD8) with a fibre-grain multiply over every surface
- hard offset second pass: box-shadow 4px 4px 0 in the paired ink, collapsing to 0 on interaction
- radius 0 on every element — cards, chips, inputs, avatars and thumbnails alike
- bright inks (#FF3F8E, #2F5CE0) as fills only; ink-weight variants (#C2005B, #1D3FA8, #4B2A86) set type
- 2px ink poster rules and 1px hairline row rules; no element borders anywhere
- flat cut-paper plates in the same two inks as the interface, with wide bare-paper zones reserved for type
### Lineage
> A faithful modernisation of Risograph Spot-Color Editorial, keeping its paper-and-spot-ink identity and rebuilding it on measured floors, one radius degree and a scroll-cinematic landing.
## Colors
Use the YAML color tokens as the normative palette. The prose below names the roles agents should preserve when generating UI.
| Token | Value |
|-------|-------|
| bg | `#F5EBD8` |
| surface | `#EDE0C6` |
| surface_solid | `#F9F2E4` |
| text | `#171626` |
| muted | `#6A6353` |
| border | `#171626` |
| accent | `#FF3F8E` |
| accent_2 | `#2F5CE0` |
| accent_soft | `#4B2A86` |
| on_accent | `#171626` |
| success | `#2F7D53` |
| warning | `#A9711A` |
| error | `#C2372A` |
| info | `#1D3FA8` |
## Typography
- **Headline-Lg**: Archivo Black, 2.334rem, weight 700, line-height 1.1.
- **Headline-Md**: Archivo Black, 1.796rem, weight 600, line-height 1.15.
- **Body-Md**: Newsreader, 17px, weight 400, line-height 1.62.
- **Label-Md**: IBM Plex 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`
### Grid
A 12-column editorial grid at desktop collapsing to 8 at tablet and 4 on the phone, with asymmetric hero spans, a dominant block beside a narrow rail, and a content cap of 1380px (1480px above 1700px). Only the hero plate bleeds to 100vw.
### Breakpoints
wide 1700+, desktop 1100–1699, landscape tablet 860–1099, portrait tablet 720–859, phone 0–719 — each art-directed, with every landing scene recomposed to fit one viewport exactly.
### Whitespace
Poster-scale space between story bands, generous outer margins, always padding above titles, and compressed internal spacing inside labels, dockets and metadata strips.
## Elevation & Depth
### Shadows
- **Sm**: 2px 2px 0 #2F5CE0
- **Md**: 4px 4px 0 #2F5CE0
- **Lg**: 8px 8px 0 #171626
## Shapes
### Rounded
- **None**: `0px`
- **Md**: `16px`
- **Lg**: `24px`
- **Full**: `9999px`
### Surfaces
- **Treatment**: paper
- **Card Style**: flat cream sheets with a fibre-grain multiply; a pink flood for single-ink pages and a plum flood for the overlap
- **Bg Pattern**: grain
### Borders
- **Default Width**: 0px
- **Accent Width**: 2px
- **Style**: solid
- **Character**: full-width ink poster rules under mastheads, section heads and table heads, plus 1px hairline row rules; no element ever carries a border or a single coloured edge
## Components
### Composition
Build pages as printed sheets: one poster hero at full bleed, story bands separated by 2px ink rules, a metadata docket sized to its own text, and plates that carry their caption below them. Asymmetric spans — a dominant block beside a narrow rail — never equal columns.
### Hierarchy
Scale contrast between an Archivo Black display moment and a fine 17px Newsreader body, with mono 11.5–13px caps carrying pressroom furniture. The mid-tier compresses toward body scale; only earned moments are large.
### Density
Medium: generous margins and poster-scale band spacing, tight leading inside metadata strips and tables. Few bold modules rather than many small utilities.
### Signature Patterns
- the second pass — a 4px offset duplicate in the paired ink that comes into register on hover, focus and press
- disabled means a single pass: the second colour is dropped entirely
- headlines carry two ghost passes (pink and blue) behind the ink layer
- status is a chip with a semantic square or a full ink flood, never an edge accent
- the docket: a slip of paper sized to its own text, carrying mono metadata over imagery
- halftone dot screens appear in transitions and non-text bands only
## 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-019ffc41-cf4f-77f1-86e8-00d12f24c961/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 keep each screen to two drums plus paper, and let the third colour appear only in the overlap
- Do use the bright inks as fills and the ink-weight variants for type
- Do let the grain and paper fibre show through the flats
- Do express state in chips, floods and plain words
- Do compose pages as sheets: poster hero, story bands, a printed docket of metadata
- Don't round a corner anywhere in the set
- Don't run a coloured strip down the edge of a card
- Don't set body copy in a heavy weight or inflate the mid-tier toward display scale
- Don't run a halftone or pattern field under running copy
- Don't add a soft shadow, a glow, a gradient or a glass surface
## Imagery Direction
### Pairs With
kappazuri
### Illustration Style
Flat two-drum stencil prints: cut-paper shapes with hard scissored edges and no internal shading, printed in fluorescent pink and federal blue on warm uncoated paper, each ink laid as a separate pass so contours sit a millimetre out of register, coarse mesh grain and halftone screens in the mid-tones.
### Hero Image Direction
One full-bleed plate at 100vw with a wide quiet region reserved for display type — an open sky, a flat ground band, or a dark silhouette mass that paper-cream type can sit on at 10:1.
### Icon Style
Cut geometric SVG primitives in ink: squares, crosshairs, chevrons. No icon fonts, no emoji, no symbol glyphs in copy.
### Image Gen Prompts
- a harbour city seen from a rooftop at dusk, wide empty sky, two-drum stencil print
- two figures carrying a long ladder through tall grass, flat silhouettes on bare paper
- a lit window with a cat on the sill, second pass landed out of register
- a still life of a teapot, two cups and three pears on a plain table
- a crowd of open umbrellas seen from directly above, overlapping into plum
```json
{
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
"name": "gocco",
"type": "registry:theme",
"title": "Gocco shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#F5EBD8",
"foreground": "#171626",
"card": "#EDE0C6",
"card-foreground": "#171626",
"popover": "#EDE0C6",
"popover-foreground": "#171626",
"primary": "#171626",
"primary-foreground": "#ffffff",
"secondary": "#f4f4f5",
"secondary-foreground": "#111111",
"muted": "#6A6353",
"muted-foreground": "#171626",
"accent": "#FF3F8E",
"accent-foreground": "#ffffff",
"destructive": "#C2372A",
"border": "#171626",
"input": "#171626",
"ring": "#FF3F8E",
"chart-1": "#171626",
"chart-2": "#f4f4f5",
"chart-3": "#FF3F8E",
"chart-4": "#2F7D53",
"chart-5": "#A9711A",
"sidebar": "#EDE0C6",
"sidebar-foreground": "#171626",
"sidebar-primary": "#171626",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#1D3FA8",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#171626",
"sidebar-ring": "#FF3F8E",
"radius": "16px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#171626",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#FF3F8E",
"accent-foreground": "#ffffff",
"destructive": "#C2372A",
"border": "#303642",
"input": "#303642",
"ring": "#FF3F8E",
"chart-1": "#171626",
"chart-2": "#f4f4f5",
"chart-3": "#FF3F8E",
"chart-4": "#2F7D53",
"chart-5": "#A9711A",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#171626",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#FF3F8E",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#303642",
"sidebar-ring": "#FF3F8E",
"radius": "16px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019ffc41-cf4f-77f1-86e8-00d12f24c961",
"slug": "gocco",
"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": {
"colors": [
"accent",
"accent_2",
"accent_soft",
"bg",
"border",
"error",
"info",
"muted",
"on_accent",
"success",
"surface",
"surface_solid",
"text",
"warning"
],
"typography": [
"base_size",
"body_font",
"google_fonts_url",
"heading_font",
"heading_transform",
"heading_weight",
"letter_spacing",
"line_height",
"mono_font",
"scale_ratio"
],
"radii": [
"full",
"lg",
"md",
"none"
],
"shadows": [
"lg",
"md",
"sm"
],
"spacing": [
"base",
"scale"
],
"surfaces": [
"bg_pattern",
"card_style",
"treatment"
],
"borders": [
"accent_width",
"character",
"default_width",
"style"
],
"motion": [
"duration",
"easing",
"philosophy"
]
}
}
}
```The quick brown fox jumps
The quick brown fox jumps
The quick brown fox jumps
The quick brown fox jumps
A generated style is an aggregate of many influences — credit is given to the artists and traditions it draws on, not a claim of authorship.
produced by claude-opus-5[1m] · sourced by claude-opus-5[1m] · images by fal-ai/flux/dev
Keep Gocco and swap a palette and an art style onto it. The landing & dashboard recolor live.
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.
npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table:root {
--background: #F5EBD8;
--foreground: #171626;
--card: #EDE0C6;
--card-foreground: #171626;
--popover: #EDE0C6;
--popover-foreground: #171626;
--primary: #171626;
--primary-foreground: #ffffff;
--secondary: #f4f4f5;
--secondary-foreground: #111111;
--muted: #6A6353;
--muted-foreground: #171626;
--accent: #FF3F8E;
--accent-foreground: #ffffff;
--destructive: #C2372A;
--border: #171626;
--input: #171626;
--ring: #FF3F8E;
--chart-1: #171626;
--chart-2: #f4f4f5;
--chart-3: #FF3F8E;
--chart-4: #2F7D53;
--chart-5: #A9711A;
--sidebar: #EDE0C6;
--sidebar-foreground: #171626;
--sidebar-primary: #171626;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #1D3FA8;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #171626;
--sidebar-ring: #FF3F8E;
--radius: 16px;
}
.dark {
--background: #0f1115;
--foreground: #f8fafc;
--card: #181b22;
--card-foreground: #f8fafc;
--popover: #181b22;
--popover-foreground: #f8fafc;
--primary: #171626;
--primary-foreground: #ffffff;
--secondary: #252a33;
--secondary-foreground: #f8fafc;
--muted: #252a33;
--muted-foreground: #a1a1aa;
--accent: #FF3F8E;
--accent-foreground: #ffffff;
--destructive: #C2372A;
--border: #303642;
--input: #303642;
--ring: #FF3F8E;
--chart-1: #171626;
--chart-2: #f4f4f5;
--chart-3: #FF3F8E;
--chart-4: #2F7D53;
--chart-5: #A9711A;
--sidebar: #181b22;
--sidebar-foreground: #f8fafc;
--sidebar-primary: #171626;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #FF3F8E;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #303642;
--sidebar-ring: #FF3F8E;
--radius: 16px;
}
import { Badge } from "@/components/ui/badge";
import { Button } from "@/components/ui/button";
import {
Card,
CardContent,
CardDescription,
CardFooter,
CardHeader,
CardTitle,
} from "@/components/ui/card";
import { Input } from "@/components/ui/input";
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs";
export function GoccoShadcnKit() {
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">Gocco</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": "gocco",
"type": "registry:theme",
"title": "Gocco",
"description": "Two-drum stencil print: warm paper, one fluorescent pink drum, one federal blue drum, and a plum that exists only in the overlap. Square geometry, hard offset second passes, fine serif body voice.",
"export_format_version": "registry-theme-v1",
"cssVars": {
"theme": {
"font-sans": "Newsreader, Georgia, 'Times New Roman', serif",
"font-serif": "Newsreader, Georgia, 'Times New Roman', serif",
"font-display": "'Archivo Black', Impact, sans-serif",
"font-mono": "'IBM Plex Mono', ui-monospace, Menlo, monospace",
"radius": "0rem",
"text-base": "17px",
"leading-base": "1.62",
"tracking-display": "-0.02em",
"shadow-pass": "4px 4px 0 #2F5CE0",
"shadow-registered": "0 0 0 #2F5CE0",
"ease-pull": "cubic-bezier(0.22, 1, 0.36, 1)",
"duration-pull": "180ms"
},
"light": {
"background": "#F5EBD8",
"foreground": "#171626",
"card": "#F9F2E4",
"card-foreground": "#171626",
"popover": "#F9F2E4",
"popover-foreground": "#171626",
"primary": "#FF3F8E",
"primary-foreground": "#171626",
"secondary": "#2F5CE0",
"secondary-foreground": "#F7EFDE",
"muted": "#EDE0C6",
"muted-foreground": "#6A6353",
"accent": "#4B2A86",
"accent-foreground": "#F7EFDE",
"destructive": "#C2372A",
"destructive-foreground": "#F7EFDE",
"success": "#2F7D53",
"warning": "#A9711A",
"info": "#1D3FA8",
"border": "#171626",
"input": "#F9F2E4",
"ring": "#2F5CE0",
"chart-1": "#FF3F8E",
"chart-2": "#2F5CE0",
"chart-3": "#4B2A86",
"chart-4": "#C2005B",
"chart-5": "#6A6353",
"sidebar": "#EDE0C6",
"sidebar-foreground": "#171626",
"sidebar-primary": "#FF3F8E",
"sidebar-primary-foreground": "#171626",
"sidebar-accent": "#4B2A86",
"sidebar-accent-foreground": "#F7EFDE",
"sidebar-border": "#171626",
"sidebar-ring": "#2F5CE0",
"ink-pink": "#C2005B",
"ink-blue": "#1D3FA8",
"paper": "#F5EBD8",
"sheet-2": "#EDE0C6"
},
"dark": {
"background": "#171626",
"foreground": "#F5EBD8",
"card": "#1F1D33",
"card-foreground": "#F5EBD8",
"popover": "#1F1D33",
"popover-foreground": "#F5EBD8",
"primary": "#FF3F8E",
"primary-foreground": "#171626",
"secondary": "#2F5CE0",
"secondary-foreground": "#F7EFDE",
"muted": "#282640",
"muted-foreground": "#A79E8A",
"accent": "#7B52C4",
"accent-foreground": "#171626",
"destructive": "#E05A4A",
"destructive-foreground": "#171626",
"success": "#4FA574",
"warning": "#D19A38",
"info": "#6E93E8",
"border": "#F5EBD8",
"input": "#1F1D33",
"ring": "#6E93E8",
"chart-1": "#FF3F8E",
"chart-2": "#6E93E8",
"chart-3": "#7B52C4",
"chart-4": "#F7A8C8",
"chart-5": "#A79E8A",
"sidebar": "#1F1D33",
"sidebar-foreground": "#F5EBD8",
"sidebar-primary": "#FF3F8E",
"sidebar-primary-foreground": "#171626",
"sidebar-accent": "#7B52C4",
"sidebar-accent-foreground": "#171626",
"sidebar-border": "#F5EBD8",
"sidebar-ring": "#6E93E8",
"ink-pink": "#FF7FB4",
"ink-blue": "#8FAEF2",
"paper": "#171626",
"sheet-2": "#282640"
}
},
"visualProfile": {
"material": "uncoated cream paper with visible fibre grain, printed in two spot inks",
"radiusStance": "square — 0 on every element; the stencil is cut with a blade",
"borders": "no element borders; 2px ink poster rules and 1px hairline row rules only",
"elevation": "hard offset duplicate of the second drum (4px 4px 0), collapsing to 0 on interaction",
"accentUse": "bright inks fill; ink-weight variants (#C2005B, #1D3FA8) set type",
"typeVoice": "display Archivo Black for earned moments; body Newsreader 17px regular; mono IBM Plex Mono 11.5–13px uppercase for pressroom furniture",
"motion": "180ms cubic-bezier(0.22,1,0.36,1) for arrivals; linear for scroll-scrubbed work",
"patternFields": "halftone dot screens in transitions and non-text bands only; never under copy"
}
}
# Gocco shadcn/ui Components
Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `en-019ffc41-cf4f-77f1-86e8-00d12f24c961`
Slug: `gocco`
## Intent
A two-drum stencil-print language for editorial work: warm paper ground, one fluorescent pink drum, one federal blue drum, and a plum third colour that exists only where the two passes overlap. Registration is the interaction model — every control arrives a few pixels out of true and walks into register when you touch it, and a disabled control is a single pass with no second colour.
## 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:
{
"bg": "#F5EBD8",
"surface": "#EDE0C6",
"surface_solid": "#F9F2E4",
"text": "#171626",
"muted": "#6A6353",
"border": "#171626",
"accent": "#FF3F8E",
"accent_2": "#2F5CE0",
"accent_soft": "#4B2A86",
"on_accent": "#171626",
"success": "#2F7D53",
"warning": "#A9711A",
"error": "#C2372A",
"info": "#1D3FA8"
}
Typography:
{
"base_size": "17px",
"body_font": "Newsreader",
"heading_font": "Archivo Black",
"mono_font": "IBM Plex Mono",
"heading_weight": "400",
"heading_transform": "none",
"letter_spacing": "-0.02em",
"line_height": 1.62,
"scale_ratio": 1.3,
"google_fonts_url": "https://fonts.googleapis.com/css2?family=Archivo+Black&family=IBM+Plex+Mono:wght@400;500&family=Newsreader:opsz,wght@6..72,300;6..72,400;6..72,600&display=swap"
}
## Visual character to preserve
- warm cream paper (#F5EBD8) with a fibre-grain multiply over every surface
- hard offset second pass: box-shadow 4px 4px 0 in the paired ink, collapsing to 0 on interaction
- radius 0 on every element — cards, chips, inputs, avatars and thumbnails alike
- bright inks (#FF3F8E, #2F5CE0) as fills only; ink-weight variants (#C2005B, #1D3FA8, #4B2A86) set type
- 2px ink poster rules and 1px hairline row rules; no element borders anywhere
- flat cut-paper plates in the same two inks as the interface, with wide bare-paper zones reserved for type
## ShadSync visual profile
{
"family": "paper-collage",
"material": "paper",
"contour": "default",
"border": "solid",
"underlay": true,
"grain": true,
"stickerBadges": false,
"motion": "still",
"density": "balanced",
"accents": [
"primary",
"accent",
"secondary",
"muted"
]
}
## Signature component recipes
### Button
Use `Button` for primary, secondary, outline, and ghost actions. Primary actions must expose the language's strongest contrast pair, while secondary and ghost actions should preserve the surface treatment instead of falling back to default neutral SaaS styling.
### Card
Use `Card`, `CardHeader`, `CardContent`, `CardFooter`, and `CardAction` as the main composition frame. Cards should demonstrate the language's surface, border, hierarchy, and density rules rather than appearing as generic rounded rectangles.
### Input and Textarea
Use `Input` and `Textarea` with visible focus rings, field labels, validation states, and the language's rhythm. Forms should show real product content, not placeholder-only controls.
### Select, Tabs, and Table
Use `Select`, `Tabs`, and `Table` to prove navigation, filtering, and dense data states. The table should show row rhythm, separators, hover/focus states, and an empty or status state when the language calls for it.
### Dialog and Sheet
Use `Dialog` for centered decisions and `Sheet` for contextual editing. Both should inherit the language's spacing, border, overlay, and motion rules.
## Preview shots
- `application-shell`: dashboard or workspace shell with navigation, cards, forms, and state badges.
- `detail-editor`: focused editing flow using input, textarea, select, switch/checkbox, dialog or sheet, and action buttons.
- `data-operations`: table-heavy operational view with tabs, dropdown menu affordances, badges, and destructive/empty states.
- Each preview shot must include a renderable `scene` payload with concrete headline, description, actions, and rows/fields/stats for the UI preview.
## Implementation contract
- Start from local `ui/src/components/ui` shadcn-style primitives; do not create a second component system.
- Apply `/katagami/shadcn/gocco/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: keep each screen to two drums plus paper, and let the third colour appear only in the overlap; use the bright inks as fills and the ink-weight variants for type; let the grain and paper fibre show through the flats; express state in chips, floods and plain words; compose pages as sheets: poster hero, story bands, a printed docket of metadata
- Do not: round a corner anywhere in the set; run a coloured strip down the edge of a card; set body copy in a heavy weight or inflate the mid-tier toward display scale; run a halftone or pattern field under running copy; add a soft shadow, a glow, a gradient or a glass surface
## 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 GoccoShadcnKit() {
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">Gocco</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
{
"grid": "A 12-column editorial grid at desktop collapsing to 8 at tablet and 4 on the phone, with asymmetric hero spans, a dominant block beside a narrow rail, and a content cap of 1380px (1480px above 1700px). Only the hero plate bleeds to 100vw.",
"breakpoints": "wide 1700+, desktop 1100–1699, landscape tablet 860–1099, portrait tablet 720–859, phone 0–719 — each art-directed, with every landing scene recomposed to fit one viewport exactly.",
"whitespace": "Poster-scale space between story bands, generous outer margins, always padding above titles, and compressed internal spacing inside labels, dockets and metadata strips."
}
{
"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-019ffc41-cf4f-77f1-86e8-00d12f24c961",
"name": "Gocco",
"slug": "gocco"
},
"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": [
"warm cream paper (#F5EBD8) with a fibre-grain multiply over every surface",
"hard offset second pass: box-shadow 4px 4px 0 in the paired ink, collapsing to 0 on interaction",
"radius 0 on every element — cards, chips, inputs, avatars and thumbnails alike",
"bright inks (#FF3F8E, #2F5CE0) as fills only; ink-weight variants (#C2005B, #1D3FA8, #4B2A86) set type",
"2px ink poster rules and 1px hairline row rules; no element borders anywhere",
"flat cut-paper plates in the same two inks as the interface, with wide bare-paper zones reserved for type"
],
"visualProfile": {
"family": "paper-collage",
"material": "paper",
"contour": "default",
"border": "solid",
"underlay": true,
"grain": true,
"stickerBadges": false,
"motion": "still",
"density": "balanced",
"accents": [
"primary",
"accent",
"secondary",
"muted"
]
},
"shots": [
{
"id": "application-shell",
"title": "Application shell",
"viewport": "desktop",
"primitives": [
"button",
"card",
"input",
"select",
"tabs",
"badge",
"separator",
"table"
],
"composition": "A real product workspace with navigation, summary cards, filtering controls, and one dense content region.",
"mustShow": [
"primary and secondary actions",
"card hierarchy",
"filterable state",
"table or list density"
],
"avoid": [
"component inventory walls",
"placeholder-only content",
"generic rounded SaaS chrome"
],
"scene": {
"eyebrow": "workspace spread",
"headline": "Gocco 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": [
"keep each screen to two drums plus paper, and let the third colour appear only in the overlap",
"use the bright inks as fills and the ink-weight variants for type",
"let the grain and paper fibre show through the flats",
"express state in chips, floods and plain words",
"compose pages as sheets: poster hero, story bands, a printed docket of metadata"
],
"dont": [
"round a corner anywhere in the set",
"run a coloured strip down the edge of a card",
"set body copy in a heavy weight or inflate the mid-tier toward display scale",
"run a halftone or pattern field under running copy",
"add a soft shadow, a glow, a gradient or a glass surface"
]
}
}