back to gallery
design language·pigment-plate-fielddesk

Pigment Plate Fielddesk

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
Pigment Plate Fielddesk turns product work into a careful illustrated field notebook: luminous watercolor washes are treated as information fields, disciplined ink rules provide the product skeleton, and paper-white space is allowed to breathe between decisions. The language borrows the authority of botanical plates, the tactility of Japanese washi stationery, and the color logic of watercolor-to-risograph separation without becoming decorative craft. It is bright and story-rich, but every pigment mark must support grouping, state, or wayfinding.
values
Color is evidence: saturated pigment appears only where it labels status, priority, category, or the next action.Paper-white restraint: empty areas are preserved as a functional reading surface rather than filled with grids or ornaments.Ink discipline: thin black-brown linework, brackets, and caption rules give the watercolor atmosphere a reliable product frame.Scientific warmth: specimen-plate hierarchy makes illustrated content feel precise, not childish or scrapbook-like.Accessible luminosity: transparent washes sit behind dark text at low opacity, never as the sole carrier of meaning.Handmade texture with system behavior: grain, offsets, and plate marks repeat from tokens so the interface remains product-usable.Small saturated accents: the palette is bright through contrast and placement, not through a rainbow of equal-weight colors.
anti-values
×No SaaS gradient gloss, neon mesh backgrounds, blurred pastel blob wallpaper, or decorative grid filler.×No childish doodle overload, sticker chaos, uneven fake handwriting, or illustration that competes with task completion.×No low-contrast candy palette; watercolor softness must be paired with ink text and clear hit targets.×No generic card dashboard with arbitrary rounded shadows; the field-plate structure must be visible in every screen.
tokens
borders4 items
accent width
3px
character
ink-brown hairlines with occasional offset cobalt/coral registration stripes
default width
1px
style
solid
colors12 items
accent
#E6543F
background
#FFFDF6
border
#6B5A45
error
#B8322A
info
#2557A7
muted
#766E63
primary
#2557A7
secondary
#2F8A4E
success
#217A45
surface
#FFFFFF
text
#261F17
warning
#B86E00
motion3 items
duration
180ms
easing
cubic-bezier(.2,.8,.2,1)
philosophy
short paper-handling motion: lift by two pixels, reveal a color registration stripe, never bounce or float
radii5 items
full
9999px
lg
24px
md
16px
none
0
sm
0
shadows3 items
lg
0 24px 60px rgba(61,45,28,0.11)
md
0 10px 24px rgba(61,45,28,0.08)
sm
0 1px 0 rgba(38,31,23,0.18)
spacing2 items
base
8px
scale
4, 8, 12, 16, 24, 32, 48, 64, 96
surfaces3 items
bg pattern
paper grain made from tiny radial noise dots plus sparse hairline registration marks
card style
white specimen sheets with 1px ink border, square upper corners, 16px lower radius, small caption rail
treatment
warm paper base with subtle fiber noise, white cards, low-opacity pigment wash fields clipped to content groups
typography8 items
base size
16px
body font
Source Sans 3
google fonts url
https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,600;9..144,700&family=IBM+Plex+Mono:wght@500;600&family=Source+Sans+3:wght@400;600;700&display=swap
heading font
Fraunces
letter spacing
-0.02em
line height
1.55
mono font
IBM Plex Mono
scale ratio
1.22
rules
composition
Build screens like an annotated field plate: one dominant work specimen, a left or top index rail, small observation cards, and labeled callouts. Keep at least one large unpainted paper zone. Use pigment fields to group related controls, not to decorate empty space. Avoid equal-weight cards; the main specimen should occupy at least forty percent of desktop width. Let illustration-like marks appear as structural washes, stamps, and connectors instead of literal mascots.
density
Medium-low density with purposeful clusters: product controls remain compact inside specimen cards, while gutters stay broad enough to show paper. Mobile collapses into a single plate stack with captions above content and no horizontal overflow.
hierarchy
Headings use Fraunces with tight tracking and generous line-height; body copy uses Source Sans 3 for clarity; metadata uses IBM Plex Mono in uppercase. Primary actions are dark ink text with a small saturated chip or underline, not full-color slabs. Status hierarchy comes from shape plus label plus color so it remains readable in monochrome. Captions sit close to their specimens and use hairline rules to connect labels to content.
signature patterns
Riso-registration active panels: a 3px cobalt or coral stripe is drawn slightly offset from the ink border to suggest separated pigment plates.Wash-backed grouping: low-opacity radial pigment fields are clipped inside cards to mark content families while preserving AA text contrast on white.Specimen caption rails: each major module includes a mono numbered label and a hairline connector rule that visually pins explanation to interface state.Pressed-pigment chips: small circular or pill chips use saturated coral, cobalt, or green with dark labels and are the only high-chroma filled elements.
layout
breakpoints

mobile <= 640px, tablet 641-960px, desktop >= 961px; reduce caption rails to inline labels on mobile and stack observation cards below the main specimen.

density
Medium-low density chosen to make bright watercolor usable: clusters of controls are efficient, but broad paper gutters prevent color fatigue and preserve editorial calm.
grid
Desktop uses a 12-column max 1240px field plate grid with 24px gutters: 2 columns index rail, 7 columns main specimen, 3 columns observations. Tablet becomes 6 columns; mobile is one column.
whitespace
Maintain 24-48px paper-white breathing room between major plates; do not place pigment washes in every gutter. Paragraph measure should stay under 68 characters.
guidance
do
  • Use no more than three brand accents at once: cobalt, leaf green, and coral; semantic colors may appear only with text labels.
  • Keep every watercolor wash pale enough for dark ink text to pass contrast or move text onto a white inset.
  • Use ink hairlines, numbered captions, and connector rules to make the illustration sensibility structural.
  • Let paper texture be subtle and system-wide; it should be felt at rest, not noticed as a pattern.
  • Create product scenes such as planning, research, publishing, or inventory rather than generic marketing hero art.
  • Pair color with icon, position, label, or stroke treatment so meaning survives color blindness.
  • Prefer small saturated accents and large quiet surfaces; one bright chip can carry more identity than a full-color card.
avoid
  • Do not use glossy gradients, mesh backgrounds, glassmorphism, blurred pastel blobs, or stock SaaS purple-blue ramps.
  • Do not fill margins with decorative grids, random stars, botanical stickers, or unrelated sketch marks.
  • Do not set long text directly over saturated pigment washes or allow low-contrast coral on white body text.
  • Do not make every card rounded, shadowed, and equally weighted; preserve the field-plate hierarchy.
  • Do not imitate children book illustration with bouncy type, cartoon icons, or fake crayon strokes.
  • Do not exceed three high-chroma accents in a view, even when creating a bright or playful screen.
  • Do not use color alone for status, validation, selection, or priority.
katagami spec
# Pigment Plate Fielddesk

## Philosophy

Pigment Plate Fielddesk turns product work into a careful illustrated field notebook: luminous watercolor washes are treated as information fields, disciplined ink rules provide the product skeleton, and paper-white space is allowed to breathe between decisions. The language borrows the authority of botanical plates, the tactility of Japanese washi stationery, and the color logic of watercolor-to-risograph separation without becoming decorative craft. It is bright and story-rich, but every pigment mark must support grouping, state, or wayfinding.

### Values

- Color is evidence: saturated pigment appears only where it labels status, priority, category, or the next action.
- Paper-white restraint: empty areas are preserved as a functional reading surface rather than filled with grids or ornaments.
- Ink discipline: thin black-brown linework, brackets, and caption rules give the watercolor atmosphere a reliable product frame.
- Scientific warmth: specimen-plate hierarchy makes illustrated content feel precise, not childish or scrapbook-like.
- Accessible luminosity: transparent washes sit behind dark text at low opacity, never as the sole carrier of meaning.
- Handmade texture with system behavior: grain, offsets, and plate marks repeat from tokens so the interface remains product-usable.
- Small saturated accents: the palette is bright through contrast and placement, not through a rainbow of equal-weight colors.

### Anti-Values

- No SaaS gradient gloss, neon mesh backgrounds, blurred pastel blob wallpaper, or decorative grid filler.
- No childish doodle overload, sticker chaos, uneven fake handwriting, or illustration that competes with task completion.
- No low-contrast candy palette; watercolor softness must be paired with ink text and clear hit targets.
- No generic card dashboard with arbitrary rounded shadows; the field-plate structure must be visible in every screen.

### Visual Character

- Use wide paper-white gutters with asymmetric specimen-plate columns: a narrow caption rail, a main work surface, and small pinned observation cards.
- Place transparent pigment washes as clipped background fields with multiply blending and 10-18 percent opacity behind grouped content, never behind dense paragraphs.
- Draw component edges with 1px ink-brown rules plus a deliberate 3px offset color registration stripe on selected active panels.
- Use botanical-plate captions: small uppercase labels, rule-led callouts, numbered tabs, and hairline connector marks anchored to content.
- Reserve saturated coral, cobalt, and leaf green for tiny chips, focus rings, active strokes, and riso-style separations rather than broad fills.

## Tokens

### Borders

- **Accent Width**: 3px
- **Character**: ink-brown hairlines with occasional offset cobalt/coral registration stripes
- **Default Width**: 1px
- **Style**: solid

### Colors

| Name | Value |
|------|-------|
| accent | `#E6543F` |
| background | `#FFFDF6` |
| border | `#6B5A45` |
| error | `#B8322A` |
| info | `#2557A7` |
| muted | `#766E63` |
| primary | `#2557A7` |
| secondary | `#2F8A4E` |
| success | `#217A45` |
| surface | `#FFFFFF` |
| text | `#261F17` |
| warning | `#B86E00` |

### Motion

- **Duration**: 180ms
- **Easing**: cubic-bezier(.2,.8,.2,1)
- **Philosophy**: short paper-handling motion: lift by two pixels, reveal a color registration stripe, never bounce or float

### Radii

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

### Shadows

- **Lg**: 0 24px 60px rgba(61,45,28,0.11)
- **Md**: 0 10px 24px rgba(61,45,28,0.08)
- **Sm**: 0 1px 0 rgba(38,31,23,0.18)

### Spacing

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

### Surfaces

- **Bg Pattern**: paper grain made from tiny radial noise dots plus sparse hairline registration marks
- **Card Style**: white specimen sheets with 1px ink border, square upper corners, 16px lower radius, small caption rail
- **Treatment**: warm paper base with subtle fiber noise, white cards, low-opacity pigment wash fields clipped to content groups

### Typography

- **Base Size**: 16px
- **Body Font**: Source Sans 3
- **Google Fonts Url**: https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,600;9..144,700&family=IBM+Plex+Mono:wght@500;600&family=Source+Sans+3:wght@400;600;700&display=swap
- **Heading Font**: Fraunces
- **Letter Spacing**: -0.02em
- **Line Height**: 1.55
- **Mono Font**: IBM Plex Mono
- **Scale Ratio**: 1.22

## Rules

### Composition

Build screens like an annotated field plate: one dominant work specimen, a left or top index rail, small observation cards, and labeled callouts. Keep at least one large unpainted paper zone. Use pigment fields to group related controls, not to decorate empty space. Avoid equal-weight cards; the main specimen should occupy at least forty percent of desktop width. Let illustration-like marks appear as structural washes, stamps, and connectors instead of literal mascots.

### Density

Medium-low density with purposeful clusters: product controls remain compact inside specimen cards, while gutters stay broad enough to show paper. Mobile collapses into a single plate stack with captions above content and no horizontal overflow.

### Hierarchy

Headings use Fraunces with tight tracking and generous line-height; body copy uses Source Sans 3 for clarity; metadata uses IBM Plex Mono in uppercase. Primary actions are dark ink text with a small saturated chip or underline, not full-color slabs. Status hierarchy comes from shape plus label plus color so it remains readable in monochrome. Captions sit close to their specimens and use hairline rules to connect labels to content.

### Signature Patterns

- Riso-registration active panels: a 3px cobalt or coral stripe is drawn slightly offset from the ink border to suggest separated pigment plates.
- Wash-backed grouping: low-opacity radial pigment fields are clipped inside cards to mark content families while preserving AA text contrast on white.
- Specimen caption rails: each major module includes a mono numbered label and a hairline connector rule that visually pins explanation to interface state.
- Pressed-pigment chips: small circular or pill chips use saturated coral, cobalt, or green with dark labels and are the only high-chroma filled elements.

## Layout

### Breakpoints

mobile <= 640px, tablet 641-960px, desktop >= 961px; reduce caption rails to inline labels on mobile and stack observation cards below the main specimen.

### Density

Medium-low density chosen to make bright watercolor usable: clusters of controls are efficient, but broad paper gutters prevent color fatigue and preserve editorial calm.

### Grid

Desktop uses a 12-column max 1240px field plate grid with 24px gutters: 2 columns index rail, 7 columns main specimen, 3 columns observations. Tablet becomes 6 columns; mobile is one column.

### Whitespace

Maintain 24-48px paper-white breathing room between major plates; do not place pigment washes in every gutter. Paragraph measure should stay under 68 characters.

## Guidance

### Do

- Use no more than three brand accents at once: cobalt, leaf green, and coral; semantic colors may appear only with text labels.
- Keep every watercolor wash pale enough for dark ink text to pass contrast or move text onto a white inset.
- Use ink hairlines, numbered captions, and connector rules to make the illustration sensibility structural.
- Let paper texture be subtle and system-wide; it should be felt at rest, not noticed as a pattern.
- Create product scenes such as planning, research, publishing, or inventory rather than generic marketing hero art.
- Pair color with icon, position, label, or stroke treatment so meaning survives color blindness.
- Prefer small saturated accents and large quiet surfaces; one bright chip can carry more identity than a full-color card.

### Don't

- Do not use glossy gradients, mesh backgrounds, glassmorphism, blurred pastel blobs, or stock SaaS purple-blue ramps.
- Do not fill margins with decorative grids, random stars, botanical stickers, or unrelated sketch marks.
- Do not set long text directly over saturated pigment washes or allow low-contrast coral on white body text.
- Do not make every card rounded, shadowed, and equally weighted; preserve the field-plate hierarchy.
- Do not imitate children book illustration with bouncy type, cartoon icons, or fake crayon strokes.
- Do not exceed three high-chroma accents in a view, even when creating a bright or playful screen.
- Do not use color alone for status, validation, selection, or priority.

### Accessibility

Default text color #261F17 on #FFFDF6 or #FFFFFF exceeds WCAG AA; any text over wash must be on a white inset or use opacity below 18 percent. Focus states use 3px cobalt outline plus label. Hit targets are at least 44px and color-coded chips always include text.

### Usage Context

Best for editorial tools, knowledge workspaces, planning surfaces, research notebooks, boutique commerce admin, creative inventory, and products that benefit from warmth without losing operational clarity.
DESIGN.md
---
version: "alpha"
name: "Pigment Plate Fielddesk"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
  accent: "#E6543F"
  background: "#FFFDF6"
  border: "#6B5A45"
  error: "#B8322A"
  info: "#2557A7"
  muted: "#766E63"
  primary: "#2557A7"
  secondary: "#2F8A4E"
  success: "#217A45"
  surface: "#FFFFFF"
  text: "#261F17"
  warning: "#B86E00"
typography:
  headline-lg:
    fontFamily: "Fraunces"
    fontSize: "1.816rem"
    fontWeight: 700
    lineHeight: 1.1
    letterSpacing: "-0.02em"
  headline-md:
    fontFamily: "Fraunces"
    fontSize: "1.488rem"
    fontWeight: 600
    lineHeight: 1.15
    letterSpacing: "-0.02em"
  body-md:
    fontFamily: "Source Sans 3"
    fontSize: "16px"
    fontWeight: 400
    lineHeight: 1.55
    letterSpacing: "-0.02em"
  label-md:
    fontFamily: "IBM Plex 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"
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"
---

# Pigment Plate Fielddesk

## Overview

Pigment Plate Fielddesk turns product work into a careful illustrated field notebook: luminous watercolor washes are treated as information fields, disciplined ink rules provide the product skeleton, and paper-white space is allowed to breathe between decisions. The language borrows the authority of botanical plates, the tactility of Japanese washi stationery, and the color logic of watercolor-to-risograph separation without becoming decorative craft. It is bright and story-rich, but every pigment mark must support grouping, state, or wayfinding.

### Values

- Color is evidence: saturated pigment appears only where it labels status, priority, category, or the next action.
- Paper-white restraint: empty areas are preserved as a functional reading surface rather than filled with grids or ornaments.
- Ink discipline: thin black-brown linework, brackets, and caption rules give the watercolor atmosphere a reliable product frame.
- Scientific warmth: specimen-plate hierarchy makes illustrated content feel precise, not childish or scrapbook-like.
- Accessible luminosity: transparent washes sit behind dark text at low opacity, never as the sole carrier of meaning.
- Handmade texture with system behavior: grain, offsets, and plate marks repeat from tokens so the interface remains product-usable.
- Small saturated accents: the palette is bright through contrast and placement, not through a rainbow of equal-weight colors.

### Anti-Values

- No SaaS gradient gloss, neon mesh backgrounds, blurred pastel blob wallpaper, or decorative grid filler.
- No childish doodle overload, sticker chaos, uneven fake handwriting, or illustration that competes with task completion.
- No low-contrast candy palette; watercolor softness must be paired with ink text and clear hit targets.
- No generic card dashboard with arbitrary rounded shadows; the field-plate structure must be visible in every screen.

### Visual Character

- Use wide paper-white gutters with asymmetric specimen-plate columns: a narrow caption rail, a main work surface, and small pinned observation cards.
- Place transparent pigment washes as clipped background fields with multiply blending and 10-18 percent opacity behind grouped content, never behind dense paragraphs.
- Draw component edges with 1px ink-brown rules plus a deliberate 3px offset color registration stripe on selected active panels.
- Use botanical-plate captions: small uppercase labels, rule-led callouts, numbered tabs, and hairline connector marks anchored to content.
- Reserve saturated coral, cobalt, and leaf green for tiny chips, focus rings, active strokes, and riso-style separations rather than broad fills.

## 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 | `#E6543F` |
| background | `#FFFDF6` |
| border | `#6B5A45` |
| error | `#B8322A` |
| info | `#2557A7` |
| muted | `#766E63` |
| primary | `#2557A7` |
| secondary | `#2F8A4E` |
| success | `#217A45` |
| surface | `#FFFFFF` |
| text | `#261F17` |
| warning | `#B86E00` |

## Typography

- **Headline-Lg**: Fraunces, 1.816rem, weight 700, line-height 1.1.
- **Headline-Md**: Fraunces, 1.488rem, weight 600, line-height 1.15.
- **Body-Md**: Source Sans 3, 16px, weight 400, line-height 1.55.
- **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`
- **Step-8**: `96px`

### Breakpoints

mobile <= 640px, tablet 641-960px, desktop >= 961px; reduce caption rails to inline labels on mobile and stack observation cards below the main specimen.

### Density

Medium-low density chosen to make bright watercolor usable: clusters of controls are efficient, but broad paper gutters prevent color fatigue and preserve editorial calm.

### Grid

Desktop uses a 12-column max 1240px field plate grid with 24px gutters: 2 columns index rail, 7 columns main specimen, 3 columns observations. Tablet becomes 6 columns; mobile is one column.

### Whitespace

Maintain 24-48px paper-white breathing room between major plates; do not place pigment washes in every gutter. Paragraph measure should stay under 68 characters.

## Elevation & Depth

### Shadows

- **Lg**: 0 24px 60px rgba(61,45,28,0.11)
- **Md**: 0 10px 24px rgba(61,45,28,0.08)
- **Sm**: 0 1px 0 rgba(38,31,23,0.18)

## Shapes

### Rounded

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

### Surfaces

- **Bg Pattern**: paper grain made from tiny radial noise dots plus sparse hairline registration marks
- **Card Style**: white specimen sheets with 1px ink border, square upper corners, 16px lower radius, small caption rail
- **Treatment**: warm paper base with subtle fiber noise, white cards, low-opacity pigment wash fields clipped to content groups

### Borders

- **Accent Width**: 3px
- **Character**: ink-brown hairlines with occasional offset cobalt/coral registration stripes
- **Default Width**: 1px
- **Style**: solid

## Components

### Composition

Build screens like an annotated field plate: one dominant work specimen, a left or top index rail, small observation cards, and labeled callouts. Keep at least one large unpainted paper zone. Use pigment fields to group related controls, not to decorate empty space. Avoid equal-weight cards; the main specimen should occupy at least forty percent of desktop width. Let illustration-like marks appear as structural washes, stamps, and connectors instead of literal mascots.

### Density

Medium-low density with purposeful clusters: product controls remain compact inside specimen cards, while gutters stay broad enough to show paper. Mobile collapses into a single plate stack with captions above content and no horizontal overflow.

### Hierarchy

Headings use Fraunces with tight tracking and generous line-height; body copy uses Source Sans 3 for clarity; metadata uses IBM Plex Mono in uppercase. Primary actions are dark ink text with a small saturated chip or underline, not full-color slabs. Status hierarchy comes from shape plus label plus color so it remains readable in monochrome. Captions sit close to their specimens and use hairline rules to connect labels to content.

### Signature Patterns

- Riso-registration active panels: a 3px cobalt or coral stripe is drawn slightly offset from the ink border to suggest separated pigment plates.
- Wash-backed grouping: low-opacity radial pigment fields are clipped inside cards to mark content families while preserving AA text contrast on white.
- Specimen caption rails: each major module includes a mono numbered label and a hairline connector rule that visually pins explanation to interface state.
- Pressed-pigment chips: small circular or pill chips use saturated coral, cobalt, or green with dark labels and are the only high-chroma filled elements.

## 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/pigment-plate-fielddesk/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 no more than three brand accents at once: cobalt, leaf green, and coral; semantic colors may appear only with text labels.
- Do Keep every watercolor wash pale enough for dark ink text to pass contrast or move text onto a white inset.
- Do Use ink hairlines, numbered captions, and connector rules to make the illustration sensibility structural.
- Do Let paper texture be subtle and system-wide; it should be felt at rest, not noticed as a pattern.
- Do Create product scenes such as planning, research, publishing, or inventory rather than generic marketing hero art.
- Do Pair color with icon, position, label, or stroke treatment so meaning survives color blindness.
- Do Prefer small saturated accents and large quiet surfaces; one bright chip can carry more identity than a full-color card.
- Don't Do not use glossy gradients, mesh backgrounds, glassmorphism, blurred pastel blobs, or stock SaaS purple-blue ramps.
- Don't Do not fill margins with decorative grids, random stars, botanical stickers, or unrelated sketch marks.
- Don't Do not set long text directly over saturated pigment washes or allow low-contrast coral on white body text.
- Don't Do not make every card rounded, shadowed, and equally weighted; preserve the field-plate hierarchy.
- Don't Do not imitate children book illustration with bouncy type, cartoon icons, or fake crayon strokes.
- Don't Do not exceed three high-chroma accents in a view, even when creating a bright or playful screen.
- Don't Do not use color alone for status, validation, selection, or priority.

### Accessibility

Default text color #261F17 on #FFFDF6 or #FFFFFF exceeds WCAG AA; any text over wash must be on a white inset or use opacity below 18 percent. Focus states use 3px cobalt outline plus label. Hit targets are at least 44px and color-coded chips always include text.

### Usage Context

Best for editorial tools, knowledge workspaces, planning surfaces, research notebooks, boutique commerce admin, creative inventory, and products that benefit from warmth without losing operational clarity.
shadcn/ui theme
```json
{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "pigment-plate-fielddesk",
  "type": "registry:theme",
  "title": "Pigment Plate Fielddesk shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#FFFDF6",
      "foreground": "#261F17",
      "card": "#FFFFFF",
      "card-foreground": "#261F17",
      "popover": "#FFFFFF",
      "popover-foreground": "#261F17",
      "primary": "#2557A7",
      "primary-foreground": "#ffffff",
      "secondary": "#2F8A4E",
      "secondary-foreground": "#ffffff",
      "muted": "#766E63",
      "muted-foreground": "#261F17",
      "accent": "#E6543F",
      "accent-foreground": "#ffffff",
      "destructive": "#B8322A",
      "border": "#6B5A45",
      "input": "#6B5A45",
      "ring": "#E6543F",
      "chart-1": "#2557A7",
      "chart-2": "#2F8A4E",
      "chart-3": "#E6543F",
      "chart-4": "#217A45",
      "chart-5": "#B86E00",
      "sidebar": "#FFFFFF",
      "sidebar-foreground": "#261F17",
      "sidebar-primary": "#2557A7",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#2557A7",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#6B5A45",
      "sidebar-ring": "#E6543F",
      "radius": "16px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#2557A7",
      "primary-foreground": "#ffffff",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#E6543F",
      "accent-foreground": "#ffffff",
      "destructive": "#B8322A",
      "border": "#303642",
      "input": "#303642",
      "ring": "#E6543F",
      "chart-1": "#2557A7",
      "chart-2": "#2F8A4E",
      "chart-3": "#E6543F",
      "chart-4": "#217A45",
      "chart-5": "#B86E00",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#2557A7",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#E6543F",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#303642",
      "sidebar-ring": "#E6543F",
      "radius": "16px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "pigment-plate-fielddesk",
    "slug": "pigment-plate-fielddesk",
    "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 · pigment-plate-fielddesk
DESIGN.md

at a glance

Palette

Typography

headline-lgFraunces · 29px · 700

The quick brown fox jumps

headline-mdFraunces · 24px · 600

The quick brown fox jumps

body-mdSource Sans 3 · 16px · 400

The quick brown fox jumps

label-mdIBM Plex 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

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: #FFFDF6;
  --foreground: #261F17;
  --card: #FFFFFF;
  --card-foreground: #261F17;
  --popover: #FFFFFF;
  --popover-foreground: #261F17;
  --primary: #2557A7;
  --primary-foreground: #ffffff;
  --secondary: #2F8A4E;
  --secondary-foreground: #ffffff;
  --muted: #766E63;
  --muted-foreground: #261F17;
  --accent: #E6543F;
  --accent-foreground: #ffffff;
  --destructive: #B8322A;
  --border: #6B5A45;
  --input: #6B5A45;
  --ring: #E6543F;
  --chart-1: #2557A7;
  --chart-2: #2F8A4E;
  --chart-3: #E6543F;
  --chart-4: #217A45;
  --chart-5: #B86E00;
  --sidebar: #FFFFFF;
  --sidebar-foreground: #261F17;
  --sidebar-primary: #2557A7;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #2557A7;
  --sidebar-accent-foreground: #ffffff;
  --sidebar-border: #6B5A45;
  --sidebar-ring: #E6543F;
  --radius: 16px;
}

.dark {
  --background: #0f1115;
  --foreground: #f8fafc;
  --card: #181b22;
  --card-foreground: #f8fafc;
  --popover: #181b22;
  --popover-foreground: #f8fafc;
  --primary: #2557A7;
  --primary-foreground: #ffffff;
  --secondary: #252a33;
  --secondary-foreground: #f8fafc;
  --muted: #252a33;
  --muted-foreground: #a1a1aa;
  --accent: #E6543F;
  --accent-foreground: #ffffff;
  --destructive: #B8322A;
  --border: #303642;
  --input: #303642;
  --ring: #E6543F;
  --chart-1: #2557A7;
  --chart-2: #2F8A4E;
  --chart-3: #E6543F;
  --chart-4: #217A45;
  --chart-5: #B86E00;
  --sidebar: #181b22;
  --sidebar-foreground: #f8fafc;
  --sidebar-primary: #2557A7;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #E6543F;
  --sidebar-accent-foreground: #ffffff;
  --sidebar-border: #303642;
  --sidebar-ring: #E6543F;
  --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 PigmentPlateFielddeskShadcnKit() {
  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">Pigment Plate Fielddesk</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": "pigment-plate-fielddesk",
  "type": "registry:theme",
  "title": "Pigment Plate Fielddesk shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#FFFDF6",
      "foreground": "#261F17",
      "card": "#FFFFFF",
      "card-foreground": "#261F17",
      "popover": "#FFFFFF",
      "popover-foreground": "#261F17",
      "primary": "#2557A7",
      "primary-foreground": "#ffffff",
      "secondary": "#2F8A4E",
      "secondary-foreground": "#ffffff",
      "muted": "#766E63",
      "muted-foreground": "#261F17",
      "accent": "#E6543F",
      "accent-foreground": "#ffffff",
      "destructive": "#B8322A",
      "border": "#6B5A45",
      "input": "#6B5A45",
      "ring": "#E6543F",
      "chart-1": "#2557A7",
      "chart-2": "#2F8A4E",
      "chart-3": "#E6543F",
      "chart-4": "#217A45",
      "chart-5": "#B86E00",
      "sidebar": "#FFFFFF",
      "sidebar-foreground": "#261F17",
      "sidebar-primary": "#2557A7",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#2557A7",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#6B5A45",
      "sidebar-ring": "#E6543F",
      "radius": "16px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#2557A7",
      "primary-foreground": "#ffffff",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#E6543F",
      "accent-foreground": "#ffffff",
      "destructive": "#B8322A",
      "border": "#303642",
      "input": "#303642",
      "ring": "#E6543F",
      "chart-1": "#2557A7",
      "chart-2": "#2F8A4E",
      "chart-3": "#E6543F",
      "chart-4": "#217A45",
      "chart-5": "#B86E00",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#2557A7",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#E6543F",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#303642",
      "sidebar-ring": "#E6543F",
      "radius": "16px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "pigment-plate-fielddesk",
    "slug": "pigment-plate-fielddesk",
    "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
# Pigment Plate Fielddesk shadcn/ui Components

Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `pigment-plate-fielddesk`
Slug: `pigment-plate-fielddesk`

## Intent

Pigment Plate Fielddesk turns product work into a careful illustrated field notebook: luminous watercolor washes are treated as information fields, disciplined ink rules provide the product skeleton, and paper-white space is allowed to breathe between decisions. The language borrows the authority of botanical plates, the tactility of Japanese washi stationery, and the color logic of watercolor-to-risograph separation without becoming decorative craft. It is bright and story-rich, but every pigment mark must support grouping, state, or wayfinding.

## 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": "#E6543F",
  "background": "#FFFDF6",
  "border": "#6B5A45",
  "error": "#B8322A",
  "info": "#2557A7",
  "muted": "#766E63",
  "primary": "#2557A7",
  "secondary": "#2F8A4E",
  "success": "#217A45",
  "surface": "#FFFFFF",
  "text": "#261F17",
  "warning": "#B86E00"
}

Typography:

{
  "base_size": "16px",
  "body_font": "Source Sans 3",
  "google_fonts_url": "https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,600;9..144,700&family=IBM+Plex+Mono:wght@500;600&family=Source+Sans+3:wght@400;600;700&display=swap",
  "heading_font": "Fraunces",
  "letter_spacing": "-0.02em",
  "line_height": 1.55,
  "mono_font": "IBM Plex Mono",
  "scale_ratio": 1.22
}

## Visual character to preserve

- Use wide paper-white gutters with asymmetric specimen-plate columns: a narrow caption rail, a main work surface, and small pinned observation cards.
- Place transparent pigment washes as clipped background fields with multiply blending and 10-18 percent opacity behind grouped content, never behind dense paragraphs.
- Draw component edges with 1px ink-brown rules plus a deliberate 3px offset color registration stripe on selected active panels.
- Use botanical-plate captions: small uppercase labels, rule-led callouts, numbered tabs, and hairline connector marks anchored to content.
- Reserve saturated coral, cobalt, and leaf green for tiny chips, focus rings, active strokes, and riso-style separations rather than broad fills.

## ShadSync visual profile

{
  "family": "paper-collage",
  "material": "paper",
  "contour": "pebble",
  "border": "solid",
  "underlay": true,
  "grain": true,
  "stickerBadges": false,
  "motion": "lift",
  "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/pigment-plate-fielddesk/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 no more than three brand accents at once: cobalt, leaf green, and coral; semantic colors may appear only with text labels.; Keep every watercolor wash pale enough for dark ink text to pass contrast or move text onto a white inset.; Use ink hairlines, numbered captions, and connector rules to make the illustration sensibility structural.; Let paper texture be subtle and system-wide; it should be felt at rest, not noticed as a pattern.; Create product scenes such as planning, research, publishing, or inventory rather than generic marketing hero art.; Pair color with icon, position, label, or stroke treatment so meaning survives color blindness.; Prefer small saturated accents and large quiet surfaces; one bright chip can carry more identity than a full-color card.
- Do not: Do not use glossy gradients, mesh backgrounds, glassmorphism, blurred pastel blobs, or stock SaaS purple-blue ramps.; Do not fill margins with decorative grids, random stars, botanical stickers, or unrelated sketch marks.; Do not set long text directly over saturated pigment washes or allow low-contrast coral on white body text.; Do not make every card rounded, shadowed, and equally weighted; preserve the field-plate hierarchy.; Do not imitate children book illustration with bouncy type, cartoon icons, or fake crayon strokes.; Do not exceed three high-chroma accents in a view, even when creating a bright or playful screen.; Do not use color alone for status, validation, selection, or priority.

## 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 PigmentPlateFielddeskShadcnKit() {
  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">Pigment Plate Fielddesk</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, tablet 641-960px, desktop >= 961px; reduce caption rails to inline labels on mobile and stack observation cards below the main specimen.",
  "density": "Medium-low density chosen to make bright watercolor usable: clusters of controls are efficient, but broad paper gutters prevent color fatigue and preserve editorial calm.",
  "grid": "Desktop uses a 12-column max 1240px field plate grid with 24px gutters: 2 columns index rail, 7 columns main specimen, 3 columns observations. Tablet becomes 6 columns; mobile is one column.",
  "whitespace": "Maintain 24-48px paper-white breathing room between major plates; do not place pigment washes in every gutter. Paragraph measure should stay under 68 characters."
}
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": "pigment-plate-fielddesk",
    "name": "Pigment Plate Fielddesk",
    "slug": "pigment-plate-fielddesk"
  },
  "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 wide paper-white gutters with asymmetric specimen-plate columns: a narrow caption rail, a main work surface, and small pinned observation cards.",
    "Place transparent pigment washes as clipped background fields with multiply blending and 10-18 percent opacity behind grouped content, never behind dense paragraphs.",
    "Draw component edges with 1px ink-brown rules plus a deliberate 3px offset color registration stripe on selected active panels.",
    "Use botanical-plate captions: small uppercase labels, rule-led callouts, numbered tabs, and hairline connector marks anchored to content.",
    "Reserve saturated coral, cobalt, and leaf green for tiny chips, focus rings, active strokes, and riso-style separations rather than broad fills."
  ],
  "visualProfile": {
    "family": "paper-collage",
    "material": "paper",
    "contour": "pebble",
    "border": "solid",
    "underlay": true,
    "grain": true,
    "stickerBadges": false,
    "motion": "still",
    "density": "dense",
    "accents": [
      "primary",
      "accent",
      "secondary",
      "muted"
    ]
  },
  "shots": [
    {
      "id": "application-shell",
      "title": "Application shell",
      "viewport": "desktop",
      "primitives": [
        "button",
        "card",
        "input",
        "select",
        "tabs",
        "badge",
        "separator",
        "table"
      ],
      "composition": "A real product workspace with navigation, summary cards, filtering controls, and one dense content region.",
      "mustShow": [
        "primary and secondary actions",
        "card hierarchy",
        "filterable state",
        "table or list density"
      ],
      "avoid": [
        "component inventory walls",
        "placeholder-only content",
        "generic rounded SaaS chrome"
      ],
      "scene": {
        "eyebrow": "workspace spread",
        "headline": "Pigment Plate Fielddesk 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 no more than three brand accents at once: cobalt, leaf green, and coral; semantic colors may appear only with text labels.",
      "Keep every watercolor wash pale enough for dark ink text to pass contrast or move text onto a white inset.",
      "Use ink hairlines, numbered captions, and connector rules to make the illustration sensibility structural.",
      "Let paper texture be subtle and system-wide; it should be felt at rest, not noticed as a pattern.",
      "Create product scenes such as planning, research, publishing, or inventory rather than generic marketing hero art.",
      "Pair color with icon, position, label, or stroke treatment so meaning survives color blindness.",
      "Prefer small saturated accents and large quiet surfaces; one bright chip can carry more identity than a full-color card."
    ],
    "dont": [
      "Do not use glossy gradients, mesh backgrounds, glassmorphism, blurred pastel blobs, or stock SaaS purple-blue ramps.",
      "Do not fill margins with decorative grids, random stars, botanical stickers, or unrelated sketch marks.",
      "Do not set long text directly over saturated pigment washes or allow low-contrast coral on white body text.",
      "Do not make every card rounded, shadowed, and equally weighted; preserve the field-plate hierarchy.",
      "Do not imitate children book illustration with bouncy type, cartoon icons, or fake crayon strokes.",
      "Do not exceed three high-chroma accents in a view, even when creating a bright or playful screen.",
      "Do not use color alone for status, validation, selection, or priority."
    ]
  }
}
related

More like this