Warm Archival Maximalism
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
- 3px
- character
- Warm brown hairlines with occasional oxblood left rules and mustard annotation underlines.
- default width
- 1px
- style
- solid
colors12 items
motion3 items
- duration
- 180ms
- easing
- cubic-bezier(.2,.8,.2,1)
- philosophy
- Quiet archival handling: controls darken, rule lines extend, and panels lift one pixel; no bouncy nostalgia or spinning ornaments.
radii5 items
- full
- 9999px
- lg
- 18px
- md
- 8px
- none
- 0
- sm
- 3px
shadows3 items
- lg
- 0 28px 80px rgba(46,31,22,0.22)
- md
- 0 14px 32px rgba(46,31,22,0.14)
- sm
- 0 1px 0 rgba(33,25,21,0.18)
spacing2 items
- base
- 8px
- scale
- 4, 8, 12, 16, 24, 32, 48, 64
surfaces3 items
- bg pattern
- Subtle repeating radial grain plus sparse registration ticks; opacity must stay below 0.08 so content remains primary.
- card style
- Flat ledger panels with 1px warm-brown borders, small radius, internal rule lines, and a soft lower-right paper shadow.
- treatment
- Aged paper and cultured-earth grounds with restrained archival grain, ruled edges, and occasional oxblood or grape contrast panels.
typography8 items
- base size
- 16px
- body font
- IBM Plex Sans
- google fonts url
- https://fonts.googleapis.com/css2?family=Cormorant+Garamond:wght@600;700&family=IBM+Plex+Mono:wght@500;600&family=IBM+Plex+Sans:wght@400;500;600;700&display=swap
- heading font
- Cormorant Garamond
- letter spacing
- -0.015em
- line height
- 1.5
- mono font
- IBM Plex Mono
- scale ratio
- 1.25
rules
Build screens like edited archive spreads: a strong oxblood or grape navigation field, large paper content wells, narrow annotation rails, and measured asymmetry rather than equal white cards.
Moderately dense but breathable: ledger rows may be compact, while major editorial surfaces keep 24-48px gutters and clear group boundaries.
Serif display type names sections and campaigns; IBM Plex Sans carries product decisions; mono numerals and accession IDs anchor tables, charts, counts, and timestamps.
layout
Mobile 375px single column; tablet 768px stacked rail with two-column content; desktop 1200px+ full editorial grid.
Desktop uses a 12-column editorial grid with a fixed 260px bound-volume rail, a flexible content span, and an optional 300px annotation rail.
Whitespace is contemporary and deliberate: 24px minimum inside panels, 32-48px between major zones, compact 12px row rhythm only inside ledgers.
guidance
- Use oxblood, grape, patinated blue, and warm brown as deep grounds for high-contrast headers, navigation, selected rows, and chart fields.
- Reserve mustard for annotation roles, focus indicators, non-critical badges, and chart accents; test any mustard/text pairing against WCAG 2.2.
- Tokenize editorial surfaces separately from core app surfaces: page ground, paper well, bound rail, enamel inset, annotation strip, and interactive accent.
- Provide light and dark adaptations by swapping paper wells for inked grape/oxblood grounds while preserving semantic status colors.
- Do not add fake stains, torn edges, vintage illustrations, or decorative clutter that competes with workflow content.
- Do not allow brown, orange, and mustard to dominate every surface; keep cool patinated blue and grape in the balance.
- Do not use ornamental mustard as the only signal for destructive, success, or primary action states.
- Do not flatten all surfaces into generic beige cards; each editorial surface role must remain distinct.
katagami spec
# Warm Archival Maximalism ## Philosophy A production-ready palette system for contemporary product interfaces that borrow the richness of municipal archives, aged paper, cultured earth pigment, oxblood binding cloth, grape ink, mustard annotation, patinated blue enamel, and warm brown wood without falling into theatrical retro clutter. ### Values - Material color hierarchy: earth colors are used as grounded surfaces, not random decoration, so product meaning remains legible. - Editorial range with semantic discipline: ornamental accents and interactive accents are tokenized separately to support brand moments without confusing states. - Accessible richness: dark oxblood, grape, patinated blue, and warm brown serve as contrast-capable grounds while mustard is reserved for non-text marks or carefully tested emphasis. - Local imperfect credibility: subtle paper grain, ruled labels, and ledger-like divisions create authorship while preserving modern spacing and restraint. ### Anti-Values - Faux-retro clutter, distressed clip art, antique props, or sepia nostalgia that hides product structure. - Ungoverned brown and orange dominance that turns every state into the same warm mush. - Using ornamental accents as buttons or status colors without semantic separation. ### Visual Character - Layer aged-paper panels over a cultured-earth page ground with 1px warm-brown rules and restrained inset shadows instead of floating white SaaS cards. - Use oxblood and grape as large contrast fields for headers, side rails, and selected states while keeping body surfaces light and readable. - Render mustard as thin annotation strips, badges, chart ticks, and focus halos rather than broad text backgrounds unless contrast is verified. - Combine high-contrast serif display headings with compact sans product text and mono ledger numerals for an editorial-but-operational hierarchy. - Add low-opacity archival grain and offset registration-line details through pseudo-elements so the system feels material without adding decorative clutter. ## Tokens ### Borders - **Accent Width**: 3px - **Character**: Warm brown hairlines with occasional oxblood left rules and mustard annotation underlines. - **Default Width**: 1px - **Style**: solid ### Colors | Name | Value | |------|-------| | accent | `#B88A22` | | background | `#E8DDC7` | | border | `#8A6F52` | | error | `#8E2F25` | | info | `#2F6573` | | muted | `#756856` | | primary | `#5B1724` | | secondary | `#3F2A56` | | success | `#426A45` | | surface | `#F4ECD9` | | text | `#211915` | | warning | `#B88A22` | ### Motion - **Duration**: 180ms - **Easing**: cubic-bezier(.2,.8,.2,1) - **Philosophy**: Quiet archival handling: controls darken, rule lines extend, and panels lift one pixel; no bouncy nostalgia or spinning ornaments. ### Radii - **Full**: 9999px - **Lg**: 18px - **Md**: 8px - **None**: 0 - **Sm**: 3px ### Shadows - **Lg**: 0 28px 80px rgba(46,31,22,0.22) - **Md**: 0 14px 32px rgba(46,31,22,0.14) - **Sm**: 0 1px 0 rgba(33,25,21,0.18) ### Spacing - **Base**: 8px - **Scale**: [4,8,12,16,24,32,48,64] ### Surfaces - **Bg Pattern**: Subtle repeating radial grain plus sparse registration ticks; opacity must stay below 0.08 so content remains primary. - **Card Style**: Flat ledger panels with 1px warm-brown borders, small radius, internal rule lines, and a soft lower-right paper shadow. - **Treatment**: Aged paper and cultured-earth grounds with restrained archival grain, ruled edges, and occasional oxblood or grape contrast panels. ### Typography - **Base Size**: 16px - **Body Font**: IBM Plex Sans - **Google Fonts Url**: https://fonts.googleapis.com/css2?family=Cormorant+Garamond:wght@600;700&family=IBM+Plex+Mono:wght@500;600&family=IBM+Plex+Sans:wght@400;500;600;700&display=swap - **Heading Font**: Cormorant Garamond - **Letter Spacing**: -0.015em - **Line Height**: 1.5 - **Mono Font**: IBM Plex Mono - **Scale Ratio**: 1.25 ## Rules ### Composition Build screens like edited archive spreads: a strong oxblood or grape navigation field, large paper content wells, narrow annotation rails, and measured asymmetry rather than equal white cards. ### Density Moderately dense but breathable: ledger rows may be compact, while major editorial surfaces keep 24-48px gutters and clear group boundaries. ### Hierarchy Serif display type names sections and campaigns; IBM Plex Sans carries product decisions; mono numerals and accession IDs anchor tables, charts, counts, and timestamps. ### Signature Patterns - Archive label headers: small mono accession codes sit above serif titles inside panels with a 3px oxblood or grape top rule. - Mustard annotation marks: use thin strips, pill badges, chart ticks, and focus outlines as ornamental accents separate from primary actions. - Patinated data insets: charts and metrics sit on blue-green enamel fields with cream grid lines and warm-brown legends. - Paper registration underlays: low-opacity corner ticks and grain pseudo-elements appear behind major panels but never over interactive text. - Bound-volume navigation: sidebars use deep oxblood cloth color, inset ruled dividers, and cream labels for high-contrast wayfinding. ## Layout ### Breakpoints Mobile 375px single column; tablet 768px stacked rail with two-column content; desktop 1200px+ full editorial grid. ### Grid Desktop uses a 12-column editorial grid with a fixed 260px bound-volume rail, a flexible content span, and an optional 300px annotation rail. ### Whitespace Whitespace is contemporary and deliberate: 24px minimum inside panels, 32-48px between major zones, compact 12px row rhythm only inside ledgers. ## Guidance ### Do - Use oxblood, grape, patinated blue, and warm brown as deep grounds for high-contrast headers, navigation, selected rows, and chart fields. - Reserve mustard for annotation roles, focus indicators, non-critical badges, and chart accents; test any mustard/text pairing against WCAG 2.2. - Tokenize editorial surfaces separately from core app surfaces: page ground, paper well, bound rail, enamel inset, annotation strip, and interactive accent. - Provide light and dark adaptations by swapping paper wells for inked grape/oxblood grounds while preserving semantic status colors. ### Don't - Do not add fake stains, torn edges, vintage illustrations, or decorative clutter that competes with workflow content. - Do not allow brown, orange, and mustard to dominate every surface; keep cool patinated blue and grape in the balance. - Do not use ornamental mustard as the only signal for destructive, success, or primary action states. - Do not flatten all surfaces into generic beige cards; each editorial surface role must remain distinct.
DESIGN.md
---
version: "alpha"
name: "Warm Archival Maximalism"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
accent: "#B88A22"
background: "#E8DDC7"
border: "#8A6F52"
error: "#8E2F25"
info: "#2F6573"
muted: "#756856"
primary: "#5B1724"
secondary: "#3F2A56"
success: "#426A45"
surface: "#F4ECD9"
text: "#211915"
warning: "#B88A22"
typography:
headline-lg:
fontFamily: "Cormorant Garamond"
fontSize: "1.953rem"
fontWeight: 700
lineHeight: 1.1
letterSpacing: "-0.015em"
headline-md:
fontFamily: "Cormorant Garamond"
fontSize: "1.563rem"
fontWeight: 600
lineHeight: 1.15
letterSpacing: "-0.015em"
body-md:
fontFamily: "IBM Plex Sans"
fontSize: "16px"
fontWeight: 400
lineHeight: 1.5
letterSpacing: "-0.015em"
label-md:
fontFamily: "IBM Plex Mono"
fontSize: "0.75rem"
fontWeight: 600
lineHeight: 1
letterSpacing: "0.08em"
rounded:
full: "9999px"
lg: "18px"
md: "8px"
none: "0px"
sm: "3px"
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"
---
# Warm Archival Maximalism
## Overview
A production-ready palette system for contemporary product interfaces that borrow the richness of municipal archives, aged paper, cultured earth pigment, oxblood binding cloth, grape ink, mustard annotation, patinated blue enamel, and warm brown wood without falling into theatrical retro clutter.
### Values
- Material color hierarchy: earth colors are used as grounded surfaces, not random decoration, so product meaning remains legible.
- Editorial range with semantic discipline: ornamental accents and interactive accents are tokenized separately to support brand moments without confusing states.
- Accessible richness: dark oxblood, grape, patinated blue, and warm brown serve as contrast-capable grounds while mustard is reserved for non-text marks or carefully tested emphasis.
- Local imperfect credibility: subtle paper grain, ruled labels, and ledger-like divisions create authorship while preserving modern spacing and restraint.
### Anti-Values
- Faux-retro clutter, distressed clip art, antique props, or sepia nostalgia that hides product structure.
- Ungoverned brown and orange dominance that turns every state into the same warm mush.
- Using ornamental accents as buttons or status colors without semantic separation.
### Visual Character
- Layer aged-paper panels over a cultured-earth page ground with 1px warm-brown rules and restrained inset shadows instead of floating white SaaS cards.
- Use oxblood and grape as large contrast fields for headers, side rails, and selected states while keeping body surfaces light and readable.
- Render mustard as thin annotation strips, badges, chart ticks, and focus halos rather than broad text backgrounds unless contrast is verified.
- Combine high-contrast serif display headings with compact sans product text and mono ledger numerals for an editorial-but-operational hierarchy.
- Add low-opacity archival grain and offset registration-line details through pseudo-elements so the system feels material without adding decorative clutter.
## 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 | `#B88A22` |
| background | `#E8DDC7` |
| border | `#8A6F52` |
| error | `#8E2F25` |
| info | `#2F6573` |
| muted | `#756856` |
| primary | `#5B1724` |
| secondary | `#3F2A56` |
| success | `#426A45` |
| surface | `#F4ECD9` |
| text | `#211915` |
| warning | `#B88A22` |
## Typography
- **Headline-Lg**: Cormorant Garamond, 1.953rem, weight 700, line-height 1.1.
- **Headline-Md**: Cormorant Garamond, 1.563rem, weight 600, line-height 1.15.
- **Body-Md**: IBM Plex Sans, 16px, weight 400, line-height 1.5.
- **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 single column; tablet 768px stacked rail with two-column content; desktop 1200px+ full editorial grid.
### Grid
Desktop uses a 12-column editorial grid with a fixed 260px bound-volume rail, a flexible content span, and an optional 300px annotation rail.
### Whitespace
Whitespace is contemporary and deliberate: 24px minimum inside panels, 32-48px between major zones, compact 12px row rhythm only inside ledgers.
## Elevation & Depth
### Shadows
- **Lg**: 0 28px 80px rgba(46,31,22,0.22)
- **Md**: 0 14px 32px rgba(46,31,22,0.14)
- **Sm**: 0 1px 0 rgba(33,25,21,0.18)
## Shapes
### Rounded
- **Full**: `9999px`
- **Lg**: `18px`
- **Md**: `8px`
- **None**: `0px`
- **Sm**: `3px`
### Surfaces
- **Bg Pattern**: Subtle repeating radial grain plus sparse registration ticks; opacity must stay below 0.08 so content remains primary.
- **Card Style**: Flat ledger panels with 1px warm-brown borders, small radius, internal rule lines, and a soft lower-right paper shadow.
- **Treatment**: Aged paper and cultured-earth grounds with restrained archival grain, ruled edges, and occasional oxblood or grape contrast panels.
### Borders
- **Accent Width**: 3px
- **Character**: Warm brown hairlines with occasional oxblood left rules and mustard annotation underlines.
- **Default Width**: 1px
- **Style**: solid
## Components
### Composition
Build screens like edited archive spreads: a strong oxblood or grape navigation field, large paper content wells, narrow annotation rails, and measured asymmetry rather than equal white cards.
### Density
Moderately dense but breathable: ledger rows may be compact, while major editorial surfaces keep 24-48px gutters and clear group boundaries.
### Hierarchy
Serif display type names sections and campaigns; IBM Plex Sans carries product decisions; mono numerals and accession IDs anchor tables, charts, counts, and timestamps.
### Signature Patterns
- Archive label headers: small mono accession codes sit above serif titles inside panels with a 3px oxblood or grape top rule.
- Mustard annotation marks: use thin strips, pill badges, chart ticks, and focus outlines as ornamental accents separate from primary actions.
- Patinated data insets: charts and metrics sit on blue-green enamel fields with cream grid lines and warm-brown legends.
- Paper registration underlays: low-opacity corner ticks and grain pseudo-elements appear behind major panels but never over interactive text.
- Bound-volume navigation: sidebars use deep oxblood cloth color, inset ruled dividers, and cream labels for high-contrast wayfinding.
## 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-019ea9b3-61c8-7173-b4f3-45c771c645eb/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 oxblood, grape, patinated blue, and warm brown as deep grounds for high-contrast headers, navigation, selected rows, and chart fields.
- Do Reserve mustard for annotation roles, focus indicators, non-critical badges, and chart accents; test any mustard/text pairing against WCAG 2.2.
- Do Tokenize editorial surfaces separately from core app surfaces: page ground, paper well, bound rail, enamel inset, annotation strip, and interactive accent.
- Do Provide light and dark adaptations by swapping paper wells for inked grape/oxblood grounds while preserving semantic status colors.
- Don't Do not add fake stains, torn edges, vintage illustrations, or decorative clutter that competes with workflow content.
- Don't Do not allow brown, orange, and mustard to dominate every surface; keep cool patinated blue and grape in the balance.
- Don't Do not use ornamental mustard as the only signal for destructive, success, or primary action states.
- Don't Do not flatten all surfaces into generic beige cards; each editorial surface role must remain distinct.
shadcn/ui theme
```json
{
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
"name": "warm-archival-maximalism",
"type": "registry:theme",
"title": "Warm Archival Maximalism shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#E8DDC7",
"foreground": "#211915",
"card": "#F4ECD9",
"card-foreground": "#211915",
"popover": "#F4ECD9",
"popover-foreground": "#211915",
"primary": "#5B1724",
"primary-foreground": "#ffffff",
"secondary": "#3F2A56",
"secondary-foreground": "#ffffff",
"muted": "#756856",
"muted-foreground": "#211915",
"accent": "#B88A22",
"accent-foreground": "#ffffff",
"destructive": "#8E2F25",
"border": "#8A6F52",
"input": "#8A6F52",
"ring": "#B88A22",
"chart-1": "#5B1724",
"chart-2": "#3F2A56",
"chart-3": "#B88A22",
"chart-4": "#426A45",
"chart-5": "#B88A22",
"sidebar": "#F4ECD9",
"sidebar-foreground": "#211915",
"sidebar-primary": "#5B1724",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#2F6573",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#8A6F52",
"sidebar-ring": "#B88A22",
"radius": "8px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#5B1724",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#B88A22",
"accent-foreground": "#ffffff",
"destructive": "#8E2F25",
"border": "#303642",
"input": "#303642",
"ring": "#B88A22",
"chart-1": "#5B1724",
"chart-2": "#3F2A56",
"chart-3": "#B88A22",
"chart-4": "#426A45",
"chart-5": "#B88A22",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#5B1724",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#B88A22",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#303642",
"sidebar-ring": "#B88A22",
"radius": "8px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019ea9b3-61c8-7173-b4f3-45c771c645eb",
"slug": "warm-archival-maximalism",
"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: #E8DDC7;
--foreground: #211915;
--card: #F4ECD9;
--card-foreground: #211915;
--popover: #F4ECD9;
--popover-foreground: #211915;
--primary: #5B1724;
--primary-foreground: #ffffff;
--secondary: #3F2A56;
--secondary-foreground: #ffffff;
--muted: #756856;
--muted-foreground: #211915;
--accent: #B88A22;
--accent-foreground: #ffffff;
--destructive: #8E2F25;
--border: #8A6F52;
--input: #8A6F52;
--ring: #B88A22;
--chart-1: #5B1724;
--chart-2: #3F2A56;
--chart-3: #B88A22;
--chart-4: #426A45;
--chart-5: #B88A22;
--sidebar: #F4ECD9;
--sidebar-foreground: #211915;
--sidebar-primary: #5B1724;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #2F6573;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #8A6F52;
--sidebar-ring: #B88A22;
--radius: 8px;
}
.dark {
--background: #0f1115;
--foreground: #f8fafc;
--card: #181b22;
--card-foreground: #f8fafc;
--popover: #181b22;
--popover-foreground: #f8fafc;
--primary: #5B1724;
--primary-foreground: #ffffff;
--secondary: #252a33;
--secondary-foreground: #f8fafc;
--muted: #252a33;
--muted-foreground: #a1a1aa;
--accent: #B88A22;
--accent-foreground: #ffffff;
--destructive: #8E2F25;
--border: #303642;
--input: #303642;
--ring: #B88A22;
--chart-1: #5B1724;
--chart-2: #3F2A56;
--chart-3: #B88A22;
--chart-4: #426A45;
--chart-5: #B88A22;
--sidebar: #181b22;
--sidebar-foreground: #f8fafc;
--sidebar-primary: #5B1724;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #B88A22;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #303642;
--sidebar-ring: #B88A22;
--radius: 8px;
}
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 WarmArchivalMaximalismShadcnKit() {
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">Warm Archival Maximalism</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": "warm-archival-maximalism",
"type": "registry:theme",
"title": "Warm Archival Maximalism shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#E8DDC7",
"foreground": "#211915",
"card": "#F4ECD9",
"card-foreground": "#211915",
"popover": "#F4ECD9",
"popover-foreground": "#211915",
"primary": "#5B1724",
"primary-foreground": "#ffffff",
"secondary": "#3F2A56",
"secondary-foreground": "#ffffff",
"muted": "#756856",
"muted-foreground": "#211915",
"accent": "#B88A22",
"accent-foreground": "#ffffff",
"destructive": "#8E2F25",
"border": "#8A6F52",
"input": "#8A6F52",
"ring": "#B88A22",
"chart-1": "#5B1724",
"chart-2": "#3F2A56",
"chart-3": "#B88A22",
"chart-4": "#426A45",
"chart-5": "#B88A22",
"sidebar": "#F4ECD9",
"sidebar-foreground": "#211915",
"sidebar-primary": "#5B1724",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#2F6573",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#8A6F52",
"sidebar-ring": "#B88A22",
"radius": "8px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#5B1724",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#B88A22",
"accent-foreground": "#ffffff",
"destructive": "#8E2F25",
"border": "#303642",
"input": "#303642",
"ring": "#B88A22",
"chart-1": "#5B1724",
"chart-2": "#3F2A56",
"chart-3": "#B88A22",
"chart-4": "#426A45",
"chart-5": "#B88A22",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#5B1724",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#B88A22",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#303642",
"sidebar-ring": "#B88A22",
"radius": "8px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019ea9b3-61c8-7173-b4f3-45c771c645eb",
"slug": "warm-archival-maximalism",
"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"
]
}
}
}
# Warm Archival Maximalism shadcn/ui Components
Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `en-019ea9b3-61c8-7173-b4f3-45c771c645eb`
Slug: `warm-archival-maximalism`
## Intent
A production-ready palette system for contemporary product interfaces that borrow the richness of municipal archives, aged paper, cultured earth pigment, oxblood binding cloth, grape ink, mustard annotation, patinated blue enamel, and warm brown wood without falling into theatrical retro clutter.
## 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": "#B88A22",
"background": "#E8DDC7",
"border": "#8A6F52",
"error": "#8E2F25",
"info": "#2F6573",
"muted": "#756856",
"primary": "#5B1724",
"secondary": "#3F2A56",
"success": "#426A45",
"surface": "#F4ECD9",
"text": "#211915",
"warning": "#B88A22"
}
Typography:
{
"base_size": "16px",
"body_font": "IBM Plex Sans",
"google_fonts_url": "https://fonts.googleapis.com/css2?family=Cormorant+Garamond:wght@600;700&family=IBM+Plex+Mono:wght@500;600&family=IBM+Plex+Sans:wght@400;500;600;700&display=swap",
"heading_font": "Cormorant Garamond",
"letter_spacing": "-0.015em",
"line_height": 1.5,
"mono_font": "IBM Plex Mono",
"scale_ratio": 1.25
}
## Visual character to preserve
- Layer aged-paper panels over a cultured-earth page ground with 1px warm-brown rules and restrained inset shadows instead of floating white SaaS cards.
- Use oxblood and grape as large contrast fields for headers, side rails, and selected states while keeping body surfaces light and readable.
- Render mustard as thin annotation strips, badges, chart ticks, and focus halos rather than broad text backgrounds unless contrast is verified.
- Combine high-contrast serif display headings with compact sans product text and mono ledger numerals for an editorial-but-operational hierarchy.
- Add low-opacity archival grain and offset registration-line details through pseudo-elements so the system feels material without adding decorative clutter.
## ShadSync visual profile
{
"family": "paper-collage",
"material": "paper",
"contour": "pebble",
"border": "solid",
"underlay": true,
"grain": true,
"stickerBadges": true,
"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/warm-archival-maximalism/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 oxblood, grape, patinated blue, and warm brown as deep grounds for high-contrast headers, navigation, selected rows, and chart fields.; Reserve mustard for annotation roles, focus indicators, non-critical badges, and chart accents; test any mustard/text pairing against WCAG 2.2.; Tokenize editorial surfaces separately from core app surfaces: page ground, paper well, bound rail, enamel inset, annotation strip, and interactive accent.; Provide light and dark adaptations by swapping paper wells for inked grape/oxblood grounds while preserving semantic status colors.
- Do not: Do not add fake stains, torn edges, vintage illustrations, or decorative clutter that competes with workflow content.; Do not allow brown, orange, and mustard to dominate every surface; keep cool patinated blue and grape in the balance.; Do not use ornamental mustard as the only signal for destructive, success, or primary action states.; Do not flatten all surfaces into generic beige cards; each editorial surface role must remain distinct.
## 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 WarmArchivalMaximalismShadcnKit() {
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">Warm Archival Maximalism</h2>
<p className="mt-1 max-w-xl text-sm text-muted-foreground">
Use the Katagami registry theme, then compose these shadcn primitives
with the language-specific component recipes.
</p>
</div>
<Button>Apply theme</Button>
</div>
<Tabs defaultValue="components">
<TabsList>
<TabsTrigger value="components">Components</TabsTrigger>
<TabsTrigger value="states">States</TabsTrigger>
<TabsTrigger value="export">Export</TabsTrigger>
</TabsList>
</Tabs>
<Card>
<CardHeader>
<CardTitle>Component recipe</CardTitle>
<CardDescription>
Replace this starter content with the agent-authored product scene
from components.md and preview-shots.json.
</CardDescription>
</CardHeader>
<CardContent className="grid gap-3 sm:grid-cols-[1fr_auto]">
<Input defaultValue="Tokenized shadcn surface" aria-label="Recipe name" />
<Button variant="secondary">Preview state</Button>
</CardContent>
<CardFooter className="justify-between">
<Badge>Ready</Badge>
<Button variant="outline">Copy recipe</Button>
</CardFooter>
</Card>
</section>
);
}
```
## Layout notes
{
"breakpoints": "Mobile 375px single column; tablet 768px stacked rail with two-column content; desktop 1200px+ full editorial grid.",
"grid": "Desktop uses a 12-column editorial grid with a fixed 260px bound-volume rail, a flexible content span, and an optional 300px annotation rail.",
"whitespace": "Whitespace is contemporary and deliberate: 24px minimum inside panels, 32-48px between major zones, compact 12px row rhythm only inside ledgers."
}
{
"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-019ea9b3-61c8-7173-b4f3-45c771c645eb",
"name": "Warm Archival Maximalism",
"slug": "warm-archival-maximalism"
},
"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": [
"Layer aged-paper panels over a cultured-earth page ground with 1px warm-brown rules and restrained inset shadows instead of floating white SaaS cards.",
"Use oxblood and grape as large contrast fields for headers, side rails, and selected states while keeping body surfaces light and readable.",
"Render mustard as thin annotation strips, badges, chart ticks, and focus halos rather than broad text backgrounds unless contrast is verified.",
"Combine high-contrast serif display headings with compact sans product text and mono ledger numerals for an editorial-but-operational hierarchy.",
"Add low-opacity archival grain and offset registration-line details through pseudo-elements so the system feels material without adding decorative clutter."
],
"visualProfile": {
"family": "paper-collage",
"material": "paper",
"contour": "pebble",
"border": "solid",
"underlay": true,
"grain": true,
"stickerBadges": true,
"motion": "still",
"density": "dense",
"accents": [
"primary",
"accent",
"secondary",
"muted"
]
},
"shots": [
{
"id": "application-shell",
"title": "Application shell",
"viewport": "desktop",
"primitives": [
"button",
"card",
"input",
"select",
"tabs",
"badge",
"separator",
"table"
],
"composition": "A real product workspace with navigation, summary cards, filtering controls, and one dense content region.",
"mustShow": [
"primary and secondary actions",
"card hierarchy",
"filterable state",
"table or list density"
],
"avoid": [
"component inventory walls",
"placeholder-only content",
"generic rounded SaaS chrome"
],
"scene": {
"eyebrow": "workspace spread",
"headline": "Warm Archival Maximalism 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 oxblood, grape, patinated blue, and warm brown as deep grounds for high-contrast headers, navigation, selected rows, and chart fields.",
"Reserve mustard for annotation roles, focus indicators, non-critical badges, and chart accents; test any mustard/text pairing against WCAG 2.2.",
"Tokenize editorial surfaces separately from core app surfaces: page ground, paper well, bound rail, enamel inset, annotation strip, and interactive accent.",
"Provide light and dark adaptations by swapping paper wells for inked grape/oxblood grounds while preserving semantic status colors."
],
"dont": [
"Do not add fake stains, torn edges, vintage illustrations, or decorative clutter that competes with workflow content.",
"Do not allow brown, orange, and mustard to dominate every surface; keep cool patinated blue and grape in the balance.",
"Do not use ornamental mustard as the only signal for destructive, success, or primary action states.",
"Do not flatten all surfaces into generic beige cards; each editorial surface role must remain distinct."
]
}
}
try a remix
Keep Warm Archival Maximalismand swap a palette and an art style onto it — the landing & dashboard recolor live. The Studio does the same with all three lanes free.