Context Weave Washi
A portable design language for agents: download the markdown first, then inspect the preview, tokens, and rules as needed.
Download DESIGN.md
Portable DESIGN.md source of truth for most agents and apps.
specification
philosophy
tokens
borders4 items
- accent width
- 2px
- character
- warm paper edges, indigo active cutlines, and persimmon alert ticks
- default width
- 1px
- style
- solid hairline with segmented or dashed stitch variants
colors12 items
motion3 items
- duration
- 160ms
- easing
- cubic-bezier(0.2, 0.0, 0.1, 1)
- philosophy
- settle by one pixel with opacity changes, like a sheet of paper being placed rather than animated
radii5 items
- full
- 9999px
- lg
- 8px
- md
- 4px
- none
- 0
- sm
- 2px
shadows3 items
- lg
- 0 22px 54px rgba(47,73,110,0.12)
- md
- 0 10px 28px rgba(47,73,110,0.08)
- sm
- 0 1px 0 rgba(30,36,40,0.05)
spacing2 items
- base
- 8px
- scale
- 4, 8, 12, 16, 24, 32, 48, 64
surfaces3 items
- bg pattern
- barely visible paper grain and segmented context rules, never literal ornament
- card style
- flat bordered document cards with square-to-small radii, clipped corners, and occasional cutline tabs
- treatment
- matte washi-like off-white layers with tonal inset wells and subtle grain
typography8 items
- base size
- 16px
- body font
- IBM Plex Sans JP
- google fonts url
- https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=IBM+Plex+Sans+JP:wght@400;500;600;700&family=Literata:opsz,wght@7..72,400;7..72,500;7..72,600;7..72,700&display=swap
- heading font
- Literata
- letter spacing
- -0.01em
- line height
- 1.55
- mono font
- IBM Plex Mono
- scale ratio
- 1.2
rules
Compose AYA screens as a reading document braided with a context map: the main text column owns attention, while slim rails and marginal cards expose source confidence, owners, decisions, and alert states.
Use medium-high density for work context, but divide it into calm bands with 8px rhythm, readable line height, and larger ma gaps at section boundaries.
Establish hierarchy through typography, spacing, cutlines, and row position before color; headings are literary and compact, controls are sans, and metrics are mono micro-annotations.
layout
mobile 375px, tablet 768px, desktop 1200px, wide 1440px
Desktop uses a 12-column system with a slim context rail, central document stream, and optional marginal signal rail; tablet reduces to two columns and mobile stacks rails above text.
Whitespace acts as ma between woven context bands: compact 8px row rhythm inside groups, 24px to 32px section gaps, and generous line height for prose.
guidance
- Use text, source labels, and inline metrics as the core interface material.
- Use indigo for selected context, focus, links, and informative state while pairing it with rules or labels.
- Reserve persimmon for sparse alerts, overdue stamps, and small edge indicators.
- Keep surfaces warm, flat, and paper-like with visible hairline structure.
- Do not add literal Japanese textile, sakura, wave, fan, or stencil motifs.
- Do not turn the product into a generic colorful dashboard or component inventory wall.
- Do not use heavy glassmorphism, neon gradients, or large soft shadows.
- Do not communicate state with color alone or hide context in unrelated modals.
katagami spec
# Context Weave Washi ## Philosophy Context Weave Washi is a light, text-first product language for AYA workspaces that weave many sources of context into one calm reading surface, using katagami stencil logic as structure, washi restraint as material tone, and muted indigo/persimmon as sparse operational signals. ### Values - Text is the primary interface material and must remain easy to scan and read. - Context appears through adjacency, rails, inline metrics, and marginal signals rather than disruptive modal dashboards. - Japanese craft references are expressed as restraint, cutlines, rhythm, negative space, and paper layering rather than literal motifs. - Accessible state design pairs color with rules, position, labels, and repeatable component behavior. ### Anti-Values - Literal textile, floral, wave, kimono, or stencil patterns used as decoration. - Glossy SaaS dashboards with saturated chart walls and heavy chrome. - Generic white-card interfaces that could be rebranded by changing only the primary color. ### Visual Character - A responsive document-plus-context CSS grid places a narrow stitched navigation rail beside a main reading stream and collapses into stacked context bands on mobile. - Warm off-white surfaces use subtle tonal layering, 1px hairline borders, inset separators, and paper-like grain instead of strong shadows or glass effects. - Muted indigo focus states are drawn as top or left cutline tabs, underlines, and bracket-like strokes rather than filled blue controls. - Sparse persimmon alerts appear as tiny stamps, edge ticks, and mono counters while the main surface remains ink, washi, and quiet indigo. - Katagami influence is represented through clipped rectangular corners, segmented separators, and repeated stencil gaps without literal textile patterning. ## Tokens ### Borders - **Accent Width**: 2px - **Character**: warm paper edges, indigo active cutlines, and persimmon alert ticks - **Default Width**: 1px - **Style**: solid hairline with segmented or dashed stitch variants ### Colors | Name | Value | |------|-------| | accent | `#C45E36` | | background | `#F7F3EA` | | border | `#D8D0C0` | | error | `#B44D38` | | info | `#42688D` | | muted | `#6F716C` | | primary | `#2F496E` | | secondary | `#7B817A` | | success | `#5E7658` | | surface | `#FCFAF4` | | text | `#1E2428` | | warning | `#B8792C` | ### Motion - **Duration**: 160ms - **Easing**: cubic-bezier(0.2, 0.0, 0.1, 1) - **Philosophy**: settle by one pixel with opacity changes, like a sheet of paper being placed rather than animated ### Radii - **Full**: 9999px - **Lg**: 8px - **Md**: 4px - **None**: 0 - **Sm**: 2px ### Shadows - **Lg**: 0 22px 54px rgba(47,73,110,0.12) - **Md**: 0 10px 28px rgba(47,73,110,0.08) - **Sm**: 0 1px 0 rgba(30,36,40,0.05) ### Spacing - **Base**: 8px - **Scale**: [4,8,12,16,24,32,48,64] ### Surfaces - **Bg Pattern**: barely visible paper grain and segmented context rules, never literal ornament - **Card Style**: flat bordered document cards with square-to-small radii, clipped corners, and occasional cutline tabs - **Treatment**: matte washi-like off-white layers with tonal inset wells and subtle grain ### Typography - **Base Size**: 16px - **Body Font**: IBM Plex Sans JP - **Google Fonts Url**: https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=IBM+Plex+Sans+JP:wght@400;500;600;700&family=Literata:opsz,wght@7..72,400;7..72,500;7..72,600;7..72,700&display=swap - **Heading Font**: Literata - **Letter Spacing**: -0.01em - **Line Height**: 1.55 - **Mono Font**: IBM Plex Mono - **Scale Ratio**: 1.2 ## Rules ### Composition Compose AYA screens as a reading document braided with a context map: the main text column owns attention, while slim rails and marginal cards expose source confidence, owners, decisions, and alert states. ### Density Use medium-high density for work context, but divide it into calm bands with 8px rhythm, readable line height, and larger ma gaps at section boundaries. ### Hierarchy Establish hierarchy through typography, spacing, cutlines, and row position before color; headings are literary and compact, controls are sans, and metrics are mono micro-annotations. ### Signature Patterns - Context-map navigation uses segmented vertical stitch rules with small rectangular nodes aligned to document sections. - Selected panels receive indigo cutline tabs or bracket strokes plus a pale wash, not a filled active background. - Inline metrics sit in mono micro-pills beside claims and table rows so analytics remains document-adjacent. - Cards and sheets use clipped corners, inset wells, and hairline separators to evoke stencil cuts without literal katagami pattern. - Persimmon alerting is constrained to stamps, chips, and edge ticks that never flood whole containers. ## Layout ### Breakpoints mobile 375px, tablet 768px, desktop 1200px, wide 1440px ### Grid Desktop uses a 12-column system with a slim context rail, central document stream, and optional marginal signal rail; tablet reduces to two columns and mobile stacks rails above text. ### Whitespace Whitespace acts as ma between woven context bands: compact 8px row rhythm inside groups, 24px to 32px section gaps, and generous line height for prose. ## Guidance ### Do - Use text, source labels, and inline metrics as the core interface material. - Use indigo for selected context, focus, links, and informative state while pairing it with rules or labels. - Reserve persimmon for sparse alerts, overdue stamps, and small edge indicators. - Keep surfaces warm, flat, and paper-like with visible hairline structure. ### Don't - Do not add literal Japanese textile, sakura, wave, fan, or stencil motifs. - Do not turn the product into a generic colorful dashboard or component inventory wall. - Do not use heavy glassmorphism, neon gradients, or large soft shadows. - Do not communicate state with color alone or hide context in unrelated modals.
DESIGN.md
---
version: "alpha"
name: "Context Weave Washi"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
accent: "#C45E36"
background: "#F7F3EA"
border: "#D8D0C0"
error: "#B44D38"
info: "#42688D"
muted: "#6F716C"
primary: "#2F496E"
secondary: "#7B817A"
success: "#5E7658"
surface: "#FCFAF4"
text: "#1E2428"
warning: "#B8792C"
typography:
headline-lg:
fontFamily: "Literata"
fontSize: "1.728rem"
fontWeight: 700
lineHeight: 1.1
letterSpacing: "-0.01em"
headline-md:
fontFamily: "Literata"
fontSize: "1.44rem"
fontWeight: 600
lineHeight: 1.15
letterSpacing: "-0.01em"
body-md:
fontFamily: "IBM Plex Sans JP"
fontSize: "16px"
fontWeight: 400
lineHeight: 1.55
letterSpacing: "-0.01em"
label-md:
fontFamily: "IBM Plex Mono"
fontSize: "0.75rem"
fontWeight: 600
lineHeight: 1
letterSpacing: "0.08em"
rounded:
full: "9999px"
lg: "8px"
md: "4px"
none: "0px"
sm: "2px"
spacing:
base: "8px"
xs: "4px"
sm: "8px"
md: "12px"
lg: "16px"
xl: "24px"
2xl: "32px"
3xl: "48px"
4xl: "64px"
components:
color-reference-accent:
backgroundColor: "{colors.accent}"
color-reference-background:
backgroundColor: "{colors.background}"
color-reference-border:
backgroundColor: "{colors.border}"
color-reference-error:
backgroundColor: "{colors.error}"
color-reference-info:
backgroundColor: "{colors.info}"
color-reference-muted:
backgroundColor: "{colors.muted}"
color-reference-primary:
backgroundColor: "{colors.primary}"
color-reference-secondary:
backgroundColor: "{colors.secondary}"
color-reference-success:
backgroundColor: "{colors.success}"
color-reference-surface:
backgroundColor: "{colors.surface}"
color-reference-text:
backgroundColor: "{colors.text}"
color-reference-warning:
backgroundColor: "{colors.warning}"
button-primary:
backgroundColor: "{colors.primary}"
textColor: "#ffffff"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
card-surface:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
input-default:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.md}"
height: "44px"
---
# Context Weave Washi
## Overview
Context Weave Washi is a light, text-first product language for AYA workspaces that weave many sources of context into one calm reading surface, using katagami stencil logic as structure, washi restraint as material tone, and muted indigo/persimmon as sparse operational signals.
### Values
- Text is the primary interface material and must remain easy to scan and read.
- Context appears through adjacency, rails, inline metrics, and marginal signals rather than disruptive modal dashboards.
- Japanese craft references are expressed as restraint, cutlines, rhythm, negative space, and paper layering rather than literal motifs.
- Accessible state design pairs color with rules, position, labels, and repeatable component behavior.
### Anti-Values
- Literal textile, floral, wave, kimono, or stencil patterns used as decoration.
- Glossy SaaS dashboards with saturated chart walls and heavy chrome.
- Generic white-card interfaces that could be rebranded by changing only the primary color.
### Visual Character
- A responsive document-plus-context CSS grid places a narrow stitched navigation rail beside a main reading stream and collapses into stacked context bands on mobile.
- Warm off-white surfaces use subtle tonal layering, 1px hairline borders, inset separators, and paper-like grain instead of strong shadows or glass effects.
- Muted indigo focus states are drawn as top or left cutline tabs, underlines, and bracket-like strokes rather than filled blue controls.
- Sparse persimmon alerts appear as tiny stamps, edge ticks, and mono counters while the main surface remains ink, washi, and quiet indigo.
- Katagami influence is represented through clipped rectangular corners, segmented separators, and repeated stencil gaps without literal textile patterning.
## 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 | `#C45E36` |
| background | `#F7F3EA` |
| border | `#D8D0C0` |
| error | `#B44D38` |
| info | `#42688D` |
| muted | `#6F716C` |
| primary | `#2F496E` |
| secondary | `#7B817A` |
| success | `#5E7658` |
| surface | `#FCFAF4` |
| text | `#1E2428` |
| warning | `#B8792C` |
## Typography
- **Headline-Lg**: Literata, 1.728rem, weight 700, line-height 1.1.
- **Headline-Md**: Literata, 1.44rem, weight 600, line-height 1.15.
- **Body-Md**: IBM Plex Sans JP, 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`
### Breakpoints
mobile 375px, tablet 768px, desktop 1200px, wide 1440px
### Grid
Desktop uses a 12-column system with a slim context rail, central document stream, and optional marginal signal rail; tablet reduces to two columns and mobile stacks rails above text.
### Whitespace
Whitespace acts as ma between woven context bands: compact 8px row rhythm inside groups, 24px to 32px section gaps, and generous line height for prose.
## Elevation & Depth
### Shadows
- **Lg**: 0 22px 54px rgba(47,73,110,0.12)
- **Md**: 0 10px 28px rgba(47,73,110,0.08)
- **Sm**: 0 1px 0 rgba(30,36,40,0.05)
## Shapes
### Rounded
- **Full**: `9999px`
- **Lg**: `8px`
- **Md**: `4px`
- **None**: `0px`
- **Sm**: `2px`
### Surfaces
- **Bg Pattern**: barely visible paper grain and segmented context rules, never literal ornament
- **Card Style**: flat bordered document cards with square-to-small radii, clipped corners, and occasional cutline tabs
- **Treatment**: matte washi-like off-white layers with tonal inset wells and subtle grain
### Borders
- **Accent Width**: 2px
- **Character**: warm paper edges, indigo active cutlines, and persimmon alert ticks
- **Default Width**: 1px
- **Style**: solid hairline with segmented or dashed stitch variants
## Components
### Composition
Compose AYA screens as a reading document braided with a context map: the main text column owns attention, while slim rails and marginal cards expose source confidence, owners, decisions, and alert states.
### Density
Use medium-high density for work context, but divide it into calm bands with 8px rhythm, readable line height, and larger ma gaps at section boundaries.
### Hierarchy
Establish hierarchy through typography, spacing, cutlines, and row position before color; headings are literary and compact, controls are sans, and metrics are mono micro-annotations.
### Signature Patterns
- Context-map navigation uses segmented vertical stitch rules with small rectangular nodes aligned to document sections.
- Selected panels receive indigo cutline tabs or bracket strokes plus a pale wash, not a filled active background.
- Inline metrics sit in mono micro-pills beside claims and table rows so analytics remains document-adjacent.
- Cards and sheets use clipped corners, inset wells, and hairline separators to evoke stencil cuts without literal katagami pattern.
- Persimmon alerting is constrained to stamps, chips, and edge ticks that never flood whole containers.
## 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-019ee040-a529-7f20-9e6f-e4d1e7930330/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 text, source labels, and inline metrics as the core interface material.
- Do Use indigo for selected context, focus, links, and informative state while pairing it with rules or labels.
- Do Reserve persimmon for sparse alerts, overdue stamps, and small edge indicators.
- Do Keep surfaces warm, flat, and paper-like with visible hairline structure.
- Don't Do not add literal Japanese textile, sakura, wave, fan, or stencil motifs.
- Don't Do not turn the product into a generic colorful dashboard or component inventory wall.
- Don't Do not use heavy glassmorphism, neon gradients, or large soft shadows.
- Don't Do not communicate state with color alone or hide context in unrelated modals.
shadcn/ui theme
```json
{
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
"name": "context-weave-washi",
"type": "registry:theme",
"title": "Context Weave Washi shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#F7F3EA",
"foreground": "#1E2428",
"card": "#FCFAF4",
"card-foreground": "#1E2428",
"popover": "#FCFAF4",
"popover-foreground": "#1E2428",
"primary": "#2F496E",
"primary-foreground": "#ffffff",
"secondary": "#7B817A",
"secondary-foreground": "#ffffff",
"muted": "#6F716C",
"muted-foreground": "#1E2428",
"accent": "#C45E36",
"accent-foreground": "#ffffff",
"destructive": "#B44D38",
"border": "#D8D0C0",
"input": "#D8D0C0",
"ring": "#C45E36",
"chart-1": "#2F496E",
"chart-2": "#7B817A",
"chart-3": "#C45E36",
"chart-4": "#5E7658",
"chart-5": "#B8792C",
"sidebar": "#FCFAF4",
"sidebar-foreground": "#1E2428",
"sidebar-primary": "#2F496E",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#42688D",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#D8D0C0",
"sidebar-ring": "#C45E36",
"radius": "4px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#2F496E",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#C45E36",
"accent-foreground": "#ffffff",
"destructive": "#B44D38",
"border": "#303642",
"input": "#303642",
"ring": "#C45E36",
"chart-1": "#2F496E",
"chart-2": "#7B817A",
"chart-3": "#C45E36",
"chart-4": "#5E7658",
"chart-5": "#B8792C",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#2F496E",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#C45E36",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#303642",
"sidebar-ring": "#C45E36",
"radius": "4px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019ee040-a529-7f20-9e6f-e4d1e7930330",
"slug": "context-weave-washi",
"componentManifest": [
"button",
"card",
"input",
"textarea",
"select",
"dialog",
"sheet",
"tabs",
"badge",
"separator",
"checkbox",
"switch",
"slider",
"tooltip",
"dropdown-menu",
"table"
],
"installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
"nativeTokenNames": {
"borders": [
"accent_width",
"character",
"default_width",
"style"
],
"colors": [
"accent",
"background",
"border",
"error",
"info",
"muted",
"primary",
"secondary",
"success",
"surface",
"text",
"warning"
],
"motion": [
"duration",
"easing",
"philosophy"
],
"radii": [
"full",
"lg",
"md",
"none",
"sm"
],
"shadows": [
"lg",
"md",
"sm"
],
"spacing": [
"base",
"scale"
],
"surfaces": [
"bg_pattern",
"card_style",
"treatment"
],
"typography": [
"base_size",
"body_font",
"google_fonts_url",
"heading_font",
"letter_spacing",
"line_height",
"mono_font",
"scale_ratio"
]
}
}
}
```embodiments
at a glance
Typography
The quick brown fox jumps
The quick brown fox jumps
The quick brown fox jumps
The quick brown fox jumps
Components
Components rendered with this language’s tokens — colors, type, and rounded corners as specified.
Spacing
- base8px
- xs4px
- sm8px
- md12px
- lg16px
- xl24px
- 2xl32px
- 3xl48px
- 4xl64px
Shape
implementation kit
DESIGN.md with shadcn
Copy this when the target app uses shadcn/ui. It packages the Katagami DESIGN.md context with the install list, theme variables, component recipes, preview-shot contract, and starter TSX in one Markdown companion.
advanced implementation filesoptional machine-readable theme, CSS, TSX starter, recipes, and preview contract
npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table:root {
--background: #F7F3EA;
--foreground: #1E2428;
--card: #FCFAF4;
--card-foreground: #1E2428;
--popover: #FCFAF4;
--popover-foreground: #1E2428;
--primary: #2F496E;
--primary-foreground: #ffffff;
--secondary: #7B817A;
--secondary-foreground: #ffffff;
--muted: #6F716C;
--muted-foreground: #1E2428;
--accent: #C45E36;
--accent-foreground: #ffffff;
--destructive: #B44D38;
--border: #D8D0C0;
--input: #D8D0C0;
--ring: #C45E36;
--chart-1: #2F496E;
--chart-2: #7B817A;
--chart-3: #C45E36;
--chart-4: #5E7658;
--chart-5: #B8792C;
--sidebar: #FCFAF4;
--sidebar-foreground: #1E2428;
--sidebar-primary: #2F496E;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #42688D;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #D8D0C0;
--sidebar-ring: #C45E36;
--radius: 4px;
}
.dark {
--background: #0f1115;
--foreground: #f8fafc;
--card: #181b22;
--card-foreground: #f8fafc;
--popover: #181b22;
--popover-foreground: #f8fafc;
--primary: #2F496E;
--primary-foreground: #ffffff;
--secondary: #252a33;
--secondary-foreground: #f8fafc;
--muted: #252a33;
--muted-foreground: #a1a1aa;
--accent: #C45E36;
--accent-foreground: #ffffff;
--destructive: #B44D38;
--border: #303642;
--input: #303642;
--ring: #C45E36;
--chart-1: #2F496E;
--chart-2: #7B817A;
--chart-3: #C45E36;
--chart-4: #5E7658;
--chart-5: #B8792C;
--sidebar: #181b22;
--sidebar-foreground: #f8fafc;
--sidebar-primary: #2F496E;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #C45E36;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #303642;
--sidebar-ring: #C45E36;
--radius: 4px;
}
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 ContextWeaveWashiShadcnKit() {
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">Context Weave Washi</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": "context-weave-washi",
"type": "registry:theme",
"title": "Context Weave Washi shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#F7F3EA",
"foreground": "#1E2428",
"card": "#FCFAF4",
"card-foreground": "#1E2428",
"popover": "#FCFAF4",
"popover-foreground": "#1E2428",
"primary": "#2F496E",
"primary-foreground": "#ffffff",
"secondary": "#7B817A",
"secondary-foreground": "#ffffff",
"muted": "#6F716C",
"muted-foreground": "#1E2428",
"accent": "#C45E36",
"accent-foreground": "#ffffff",
"destructive": "#B44D38",
"border": "#D8D0C0",
"input": "#D8D0C0",
"ring": "#C45E36",
"chart-1": "#2F496E",
"chart-2": "#7B817A",
"chart-3": "#C45E36",
"chart-4": "#5E7658",
"chart-5": "#B8792C",
"sidebar": "#FCFAF4",
"sidebar-foreground": "#1E2428",
"sidebar-primary": "#2F496E",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#42688D",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#D8D0C0",
"sidebar-ring": "#C45E36",
"radius": "4px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#2F496E",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#C45E36",
"accent-foreground": "#ffffff",
"destructive": "#B44D38",
"border": "#303642",
"input": "#303642",
"ring": "#C45E36",
"chart-1": "#2F496E",
"chart-2": "#7B817A",
"chart-3": "#C45E36",
"chart-4": "#5E7658",
"chart-5": "#B8792C",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#2F496E",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#C45E36",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#303642",
"sidebar-ring": "#C45E36",
"radius": "4px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019ee040-a529-7f20-9e6f-e4d1e7930330",
"slug": "context-weave-washi",
"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"
]
}
}
}
# Context Weave Washi shadcn/ui Components
Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `en-019ee040-a529-7f20-9e6f-e4d1e7930330`
Slug: `context-weave-washi`
## Intent
Context Weave Washi is a light, text-first product language for AYA workspaces that weave many sources of context into one calm reading surface, using katagami stencil logic as structure, washi restraint as material tone, and muted indigo/persimmon as sparse operational signals.
## 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": "#C45E36",
"background": "#F7F3EA",
"border": "#D8D0C0",
"error": "#B44D38",
"info": "#42688D",
"muted": "#6F716C",
"primary": "#2F496E",
"secondary": "#7B817A",
"success": "#5E7658",
"surface": "#FCFAF4",
"text": "#1E2428",
"warning": "#B8792C"
}
Typography:
{
"base_size": "16px",
"body_font": "IBM Plex Sans JP",
"google_fonts_url": "https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=IBM+Plex+Sans+JP:wght@400;500;600;700&family=Literata:opsz,wght@7..72,400;7..72,500;7..72,600;7..72,700&display=swap",
"heading_font": "Literata",
"letter_spacing": "-0.01em",
"line_height": 1.55,
"mono_font": "IBM Plex Mono",
"scale_ratio": 1.2
}
## Visual character to preserve
- A responsive document-plus-context CSS grid places a narrow stitched navigation rail beside a main reading stream and collapses into stacked context bands on mobile.
- Warm off-white surfaces use subtle tonal layering, 1px hairline borders, inset separators, and paper-like grain instead of strong shadows or glass effects.
- Muted indigo focus states are drawn as top or left cutline tabs, underlines, and bracket-like strokes rather than filled blue controls.
- Sparse persimmon alerts appear as tiny stamps, edge ticks, and mono counters while the main surface remains ink, washi, and quiet indigo.
- Katagami influence is represented through clipped rectangular corners, segmented separators, and repeated stencil gaps without literal textile patterning.
## ShadSync visual profile
{
"family": "paper-collage",
"material": "paper",
"contour": "pebble",
"border": "dashed",
"underlay": false,
"grain": true,
"stickerBadges": true,
"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/context-weave-washi/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 text, source labels, and inline metrics as the core interface material.; Use indigo for selected context, focus, links, and informative state while pairing it with rules or labels.; Reserve persimmon for sparse alerts, overdue stamps, and small edge indicators.; Keep surfaces warm, flat, and paper-like with visible hairline structure.
- Do not: Do not add literal Japanese textile, sakura, wave, fan, or stencil motifs.; Do not turn the product into a generic colorful dashboard or component inventory wall.; Do not use heavy glassmorphism, neon gradients, or large soft shadows.; Do not communicate state with color alone or hide context in unrelated modals.
## 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 ContextWeaveWashiShadcnKit() {
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">Context Weave Washi</h2>
<p className="mt-1 max-w-xl text-sm text-muted-foreground">
Use the Katagami registry theme, then compose these shadcn primitives
with the language-specific component recipes.
</p>
</div>
<Button>Apply theme</Button>
</div>
<Tabs defaultValue="components">
<TabsList>
<TabsTrigger value="components">Components</TabsTrigger>
<TabsTrigger value="states">States</TabsTrigger>
<TabsTrigger value="export">Export</TabsTrigger>
</TabsList>
</Tabs>
<Card>
<CardHeader>
<CardTitle>Component recipe</CardTitle>
<CardDescription>
Replace this starter content with the agent-authored product scene
from components.md and preview-shots.json.
</CardDescription>
</CardHeader>
<CardContent className="grid gap-3 sm:grid-cols-[1fr_auto]">
<Input defaultValue="Tokenized shadcn surface" aria-label="Recipe name" />
<Button variant="secondary">Preview state</Button>
</CardContent>
<CardFooter className="justify-between">
<Badge>Ready</Badge>
<Button variant="outline">Copy recipe</Button>
</CardFooter>
</Card>
</section>
);
}
```
## Layout notes
{
"breakpoints": "mobile 375px, tablet 768px, desktop 1200px, wide 1440px",
"grid": "Desktop uses a 12-column system with a slim context rail, central document stream, and optional marginal signal rail; tablet reduces to two columns and mobile stacks rails above text.",
"whitespace": "Whitespace acts as ma between woven context bands: compact 8px row rhythm inside groups, 24px to 32px section gaps, and generous line height for prose."
}
{
"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-019ee040-a529-7f20-9e6f-e4d1e7930330",
"name": "Context Weave Washi",
"slug": "context-weave-washi"
},
"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": [
"A responsive document-plus-context CSS grid places a narrow stitched navigation rail beside a main reading stream and collapses into stacked context bands on mobile.",
"Warm off-white surfaces use subtle tonal layering, 1px hairline borders, inset separators, and paper-like grain instead of strong shadows or glass effects.",
"Muted indigo focus states are drawn as top or left cutline tabs, underlines, and bracket-like strokes rather than filled blue controls.",
"Sparse persimmon alerts appear as tiny stamps, edge ticks, and mono counters while the main surface remains ink, washi, and quiet indigo.",
"Katagami influence is represented through clipped rectangular corners, segmented separators, and repeated stencil gaps without literal textile patterning."
],
"visualProfile": {
"family": "paper-collage",
"material": "paper",
"contour": "pebble",
"border": "dashed",
"underlay": false,
"grain": true,
"stickerBadges": true,
"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": "Context Weave Washi 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 text, source labels, and inline metrics as the core interface material.",
"Use indigo for selected context, focus, links, and informative state while pairing it with rules or labels.",
"Reserve persimmon for sparse alerts, overdue stamps, and small edge indicators.",
"Keep surfaces warm, flat, and paper-like with visible hairline structure."
],
"dont": [
"Do not add literal Japanese textile, sakura, wave, fan, or stencil motifs.",
"Do not turn the product into a generic colorful dashboard or component inventory wall.",
"Do not use heavy glassmorphism, neon gradients, or large soft shadows.",
"Do not communicate state with color alone or hide context in unrelated modals."
]
}
}