Dew Candy Minimalism
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
- Borders are milk-glass seams: rgba(35,33,38,0.08) on neutral surfaces and thin pink/blue rails only for active or selected elements.
- default width
- 1px
- style
- solid
colors12 items
motion3 items
- duration
- 180ms
- easing
- cubic-bezier(0.2, 0.8, 0.2, 1)
- philosophy
- Small buoyant focus movement only: buttons rise 1px, liquid indicators slide gently, and no looping shimmer or distracting candy animation is allowed.
radii5 items
- full
- 9999px
- lg
- 24px
- md
- 24px
- none
- 0
- sm
- 16px
shadows3 items
- lg
- 0 30px 90px rgba(84, 112, 130, 0.14), 0 8px 24px rgba(217,130,152,0.10), inset 0 1px 0 rgba(255,255,255,0.9)
- md
- 0 18px 54px rgba(94, 63, 74, 0.10), inset 0 1px 0 rgba(255,255,255,0.86)
- sm
- 0 1px 2px rgba(35, 33, 38, 0.05), inset 0 1px 0 rgba(255,255,255,0.76)
spacing2 items
- base
- 8px
- scale
- 4, 8, 12, 16, 24, 32, 48, 64, 80, 96
surfaces3 items
- bg pattern
- Nearly plain white with two oversized radial surface tints: pale lychee at the top left and pale pool blue at the lower right, both below 18 percent opacity.
- card style
- Dominant cards use {colors.surface} with translucent overlays, a committed 24px container radius, 1px near-invisible borders, and inset top highlights for a candy-shell edge.
- treatment
- Milk-glass layering: rgba(255,255,255,0.72) panels over #FFFFFF with backdrop-filter blur(22px), clipped blush/aqua lozenges, and opaque micro-panels behind dense text.
typography8 items
- base size
- 16px
- body font
- Nunito Sans
- google fonts url
- https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght,SOFT,WONK@9..144,500..700,80,0..1&family=Nunito+Sans:opsz,wght@6..12,400;6..12,650;6..12,760&family=Martian+Mono:wght@500;600&display=swap
- heading font
- Fraunces
- letter spacing
- -0.02em
- line height
- 1.56
- mono font
- Martian Mono
- scale ratio
- 1.25
rules
Build screens around one dominant translucent workspace, not equal cards. Leave a large quiet white area on at least one side, place supporting modules as smaller offset lozenges, and let pale background washes imply zones. Use an asymmetric split at desktop, stacked priority at tablet, and a single-column story at mobile. Never rely on hard dividers when spacing and tint can group the content.
Overall density is low and breathable, but each screen needs one dense operational pocket such as a compact tray, route list, or status stack. Use 4 to 8px gaps inside small clusters and 64 to 96px separations between conceptual areas.
Use a three-voice type hierarchy: Fraunces display headlines with -0.04em tracking and soft optical weight, Nunito Sans body copy at 16px with -0.02em tracking, and Martian Mono labels for tiny timestamps and quantities. Primary actions get pool blue outlines or fills; care or warmth cues get lychee pink chips. Text remains dark on opaque reading planes even inside glass panels.
layout
mobile 0-639px, tablet 640-1023px, desktop 1024px and above
Breathable by default with one compact pocket per view; the language depends on contrast between 4px micro-gaps and 96px quiet fields.
Desktop uses a 12-column max-width 1180px grid with 24px gutters and an asymmetric 7/5 split; tablet collapses to 6 columns; mobile uses one column with 24px edge padding.
At tablet sizes, supporting lozenges move below the dominant workspace while maintaining offset overlap; at mobile, decorative washes flatten and text shelves become full-width cards.
White space is an active material: keep at least one unfilled field near the main panel, separate sections by 64px or more, and avoid filling corners with decoration.
guidance
- Use a white or milk-neutral canvas and let soft spacing do more work than boxes.
- Reserve lychee pink for caring, warm, or completion cues and pool blue for current location, focus, or navigation.
- Place long copy and important numbers on opaque white shelves even when the parent card is frosted glass.
- Use 24px container radii and full-pill controls consistently; the softness should feel systematic rather than randomly bubbly.
- Keep borders near invisible at roughly 6 to 10 percent opacity and strengthen only the active rail.
- Create at least one asymmetric composition break with an oversized quiet field or offset floating tray.
- Check contrast on every translucent panel and increase shelf opacity before increasing text weight.
- Do not use rainbow gradients, saturated candy stripes, neon glows, or more than two accent hues.
- Do not place paragraph text directly on busy blur, imagery, or overlapping tinted shapes.
- Do not add mascots, emoji, sticker clusters, toy icons, bubble alphabets, or childish kawaii clutter.
- Do not create three equal cards in a row; one module must be dominant or the layout must be asymmetric.
- Do not use heavy gray borders, generic SaaS shadows, or default form controls.
- Do not fill every white area with decoration; the blank field is part of the language.
- Do not animate with looping shimmer, jelly bounce, or syrup-like motion that undermines calm readability.
katagami spec
# Dew Candy Minimalism
## Philosophy
Dew Candy Minimalism is an airy, readable white-space interface language that borrows the softness of milk glass and fruit candy without becoming childish. It uses mostly white and barely tinted surfaces, reserving lychee pink and pool blue for priority cues, selected controls, and small moments of delight. Translucency is a hierarchy tool rather than decoration: frosted panels, liquid highlights, and pale surface tints create depth while text stays high contrast and calm.
### Values
- White space carries the primary hierarchy; color appears only where it clarifies state, priority, or a selected path.
- Translucent candy surfaces remain legible, with blur isolated behind panels and solid inner reading planes for text-heavy content.
- Youthful softness comes from rounded geometry, pill controls, and dew-like highlights, not from mascots, stickers, or rainbow novelty.
- Every accent is sparse and named: lychee pink for warmth and care, pool blue for navigation and active focus.
- Tone-based containers separate information through subtle aqua and blush tints instead of hard gray boxes.
- The interface feels fresh, hydrated, and quiet, with enough contrast to operate as a serious product.
### Anti-Values
- Rainbow gradients, neon candy colors, or saturated multi-hue palettes that turn the system into toy packaging.
- Glassmorphism used indiscriminately behind paragraphs, causing low contrast, noisy overlaps, or unreadable blur.
- Kawaii clutter such as emoji confetti, mascot faces, sticker piles, novelty icons, or childish bubble lettering.
- Generic SaaS card grids with identical boxes and medium spacing everywhere.
### Visual Character
- A white canvas uses oversized asymmetric empty zones, with content gathered into one dominant milk-glass panel and smaller offset tint chips.
- Cards use rgba white fills, backdrop-filter blur, inset white highlights, and 8 percent borders while text sits on nontransparent reading layers.
- Lychee pink and pool blue appear as tiny pill tabs, active rails, and one liquid selection blob rather than full-area gradients.
- Controls share a committed 24px rounded container radius or full pills, using soft inner shadows and hairline borders to suggest candy shells without toy gloss.
- Section dividers are replaced by pale aqua or blush surface washes clipped into rounded lozenges that float behind content.
## Tokens
### Borders
- **Accent Width**: 2px
- **Character**: Borders are milk-glass seams: rgba(35,33,38,0.08) on neutral surfaces and thin pink/blue rails only for active or selected elements.
- **Default Width**: 1px
- **Style**: solid
### Colors
| Name | Value |
|------|-------|
| accent | `#F2B7C5` |
| background | `#FFFFFF` |
| border | `#EDE7E8` |
| error | `#B65B68` |
| info | `#5D9EB8` |
| muted | `#746F78` |
| primary | `#D98298` |
| secondary | `#74BCD6` |
| success | `#5D947E` |
| surface | `#FDFBFA` |
| text | `#232126` |
| warning | `#B58A4C` |
### Motion
- **Duration**: 180ms
- **Easing**: cubic-bezier(0.2, 0.8, 0.2, 1)
- **Philosophy**: Small buoyant focus movement only: buttons rise 1px, liquid indicators slide gently, and no looping shimmer or distracting candy animation is allowed.
### Radii
- **Full**: 9999px
- **Lg**: 24px
- **Md**: 24px
- **None**: 0
- **Sm**: 16px
### Shadows
- **Lg**: 0 30px 90px rgba(84, 112, 130, 0.14), 0 8px 24px rgba(217,130,152,0.10), inset 0 1px 0 rgba(255,255,255,0.9)
- **Md**: 0 18px 54px rgba(94, 63, 74, 0.10), inset 0 1px 0 rgba(255,255,255,0.86)
- **Sm**: 0 1px 2px rgba(35, 33, 38, 0.05), inset 0 1px 0 rgba(255,255,255,0.76)
### Spacing
- **Base**: 8px
- **Scale**: [4,8,12,16,24,32,48,64,80,96]
### Surfaces
- **Bg Pattern**: Nearly plain white with two oversized radial surface tints: pale lychee at the top left and pale pool blue at the lower right, both below 18 percent opacity.
- **Card Style**: Dominant cards use {colors.surface} with translucent overlays, a committed 24px container radius, 1px near-invisible borders, and inset top highlights for a candy-shell edge.
- **Treatment**: Milk-glass layering: rgba(255,255,255,0.72) panels over #FFFFFF with backdrop-filter blur(22px), clipped blush/aqua lozenges, and opaque micro-panels behind dense text.
### Typography
- **Base Size**: 16px
- **Body Font**: Nunito Sans
- **Google Fonts Url**: https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght,SOFT,WONK@9..144,500..700,80,0..1&family=Nunito+Sans:opsz,wght@6..12,400;6..12,650;6..12,760&family=Martian+Mono:wght@500;600&display=swap
- **Heading Font**: Fraunces
- **Letter Spacing**: -0.02em
- **Line Height**: 1.56
- **Mono Font**: Martian Mono
- **Scale Ratio**: 1.25
## Rules
### Composition
Build screens around one dominant translucent workspace, not equal cards. Leave a large quiet white area on at least one side, place supporting modules as smaller offset lozenges, and let pale background washes imply zones. Use an asymmetric split at desktop, stacked priority at tablet, and a single-column story at mobile. Never rely on hard dividers when spacing and tint can group the content.
### Density
Overall density is low and breathable, but each screen needs one dense operational pocket such as a compact tray, route list, or status stack. Use 4 to 8px gaps inside small clusters and 64 to 96px separations between conceptual areas.
### Hierarchy
Use a three-voice type hierarchy: Fraunces display headlines with -0.04em tracking and soft optical weight, Nunito Sans body copy at 16px with -0.02em tracking, and Martian Mono labels for tiny timestamps and quantities. Primary actions get pool blue outlines or fills; care or warmth cues get lychee pink chips. Text remains dark on opaque reading planes even inside glass panels.
### Signature Patterns
- Dew-drop selection blob: an active pill contains a small translucent circular highlight offset to the upper right with pool-blue edge tint.
- Milk-glass reading shelf: translucent outer cards include a solid white inner shelf for copy-heavy rows to preserve contrast under blur.
- Tint lozenge zoning: blush and aqua rounded background capsules sit behind sections instead of using gray dividers or colored cards.
- Candy-shell border stack: components combine a 1px low-opacity seam, inset white highlight, and restrained soft shadow for tactile depth.
- Sparse flavor chips: lychee and pool accents appear as miniature labels, rails, and badges with large white space around them.
## Layout
### Breakpoints
mobile 0-639px, tablet 640-1023px, desktop 1024px and above
### Density
Breathable by default with one compact pocket per view; the language depends on contrast between 4px micro-gaps and 96px quiet fields.
### Grid
Desktop uses a 12-column max-width 1180px grid with 24px gutters and an asymmetric 7/5 split; tablet collapses to 6 columns; mobile uses one column with 24px edge padding.
### Responsive
At tablet sizes, supporting lozenges move below the dominant workspace while maintaining offset overlap; at mobile, decorative washes flatten and text shelves become full-width cards.
### Whitespace
White space is an active material: keep at least one unfilled field near the main panel, separate sections by 64px or more, and avoid filling corners with decoration.
## Guidance
### Do
- Use a white or milk-neutral canvas and let soft spacing do more work than boxes.
- Reserve lychee pink for caring, warm, or completion cues and pool blue for current location, focus, or navigation.
- Place long copy and important numbers on opaque white shelves even when the parent card is frosted glass.
- Use 24px container radii and full-pill controls consistently; the softness should feel systematic rather than randomly bubbly.
- Keep borders near invisible at roughly 6 to 10 percent opacity and strengthen only the active rail.
- Create at least one asymmetric composition break with an oversized quiet field or offset floating tray.
- Check contrast on every translucent panel and increase shelf opacity before increasing text weight.
### Don't
- Do not use rainbow gradients, saturated candy stripes, neon glows, or more than two accent hues.
- Do not place paragraph text directly on busy blur, imagery, or overlapping tinted shapes.
- Do not add mascots, emoji, sticker clusters, toy icons, bubble alphabets, or childish kawaii clutter.
- Do not create three equal cards in a row; one module must be dominant or the layout must be asymmetric.
- Do not use heavy gray borders, generic SaaS shadows, or default form controls.
- Do not fill every white area with decoration; the blank field is part of the language.
- Do not animate with looping shimmer, jelly bounce, or syrup-like motion that undermines calm readability.
### Accessibility
Maintain WCAG AA contrast for body text, keep blur decorative instead of structural for reading, provide visible focus rings in pool blue, and avoid communicating state by color alone.
### Usage Context
Best for wellness utilities, gentle scheduling, taste curation, learning companions, and consumer productivity where calm delight and immediate legibility both matter.
DESIGN.md
---
version: "alpha"
name: "Dew Candy Minimalism"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
accent: "#F2B7C5"
background: "#FFFFFF"
border: "#EDE7E8"
error: "#B65B68"
info: "#5D9EB8"
muted: "#746F78"
primary: "#D98298"
secondary: "#74BCD6"
success: "#5D947E"
surface: "#FDFBFA"
text: "#232126"
warning: "#B58A4C"
typography:
headline-lg:
fontFamily: "Fraunces"
fontSize: "1.953rem"
fontWeight: 700
lineHeight: 1.1
letterSpacing: "-0.02em"
headline-md:
fontFamily: "Fraunces"
fontSize: "1.563rem"
fontWeight: 600
lineHeight: 1.15
letterSpacing: "-0.02em"
body-md:
fontFamily: "Nunito Sans"
fontSize: "16px"
fontWeight: 400
lineHeight: 1.56
letterSpacing: "-0.02em"
label-md:
fontFamily: "Martian Mono"
fontSize: "0.75rem"
fontWeight: 600
lineHeight: 1
letterSpacing: "0.08em"
rounded:
full: "9999px"
lg: "24px"
md: "24px"
none: "0px"
sm: "16px"
spacing:
base: "8px"
xs: "4px"
sm: "8px"
md: "12px"
lg: "16px"
xl: "24px"
2xl: "32px"
3xl: "48px"
4xl: "64px"
step-8: "80px"
step-9: "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: "#000000"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
card-surface:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
input-default:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.md}"
height: "44px"
---
# Dew Candy Minimalism
## Overview
Dew Candy Minimalism is an airy, readable white-space interface language that borrows the softness of milk glass and fruit candy without becoming childish. It uses mostly white and barely tinted surfaces, reserving lychee pink and pool blue for priority cues, selected controls, and small moments of delight. Translucency is a hierarchy tool rather than decoration: frosted panels, liquid highlights, and pale surface tints create depth while text stays high contrast and calm.
### Values
- White space carries the primary hierarchy; color appears only where it clarifies state, priority, or a selected path.
- Translucent candy surfaces remain legible, with blur isolated behind panels and solid inner reading planes for text-heavy content.
- Youthful softness comes from rounded geometry, pill controls, and dew-like highlights, not from mascots, stickers, or rainbow novelty.
- Every accent is sparse and named: lychee pink for warmth and care, pool blue for navigation and active focus.
- Tone-based containers separate information through subtle aqua and blush tints instead of hard gray boxes.
- The interface feels fresh, hydrated, and quiet, with enough contrast to operate as a serious product.
### Anti-Values
- Rainbow gradients, neon candy colors, or saturated multi-hue palettes that turn the system into toy packaging.
- Glassmorphism used indiscriminately behind paragraphs, causing low contrast, noisy overlaps, or unreadable blur.
- Kawaii clutter such as emoji confetti, mascot faces, sticker piles, novelty icons, or childish bubble lettering.
- Generic SaaS card grids with identical boxes and medium spacing everywhere.
### Visual Character
- A white canvas uses oversized asymmetric empty zones, with content gathered into one dominant milk-glass panel and smaller offset tint chips.
- Cards use rgba white fills, backdrop-filter blur, inset white highlights, and 8 percent borders while text sits on nontransparent reading layers.
- Lychee pink and pool blue appear as tiny pill tabs, active rails, and one liquid selection blob rather than full-area gradients.
- Controls share a committed 24px rounded container radius or full pills, using soft inner shadows and hairline borders to suggest candy shells without toy gloss.
- Section dividers are replaced by pale aqua or blush surface washes clipped into rounded lozenges that float behind content.
## 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 | `#F2B7C5` |
| background | `#FFFFFF` |
| border | `#EDE7E8` |
| error | `#B65B68` |
| info | `#5D9EB8` |
| muted | `#746F78` |
| primary | `#D98298` |
| secondary | `#74BCD6` |
| success | `#5D947E` |
| surface | `#FDFBFA` |
| text | `#232126` |
| warning | `#B58A4C` |
## Typography
- **Headline-Lg**: Fraunces, 1.953rem, weight 700, line-height 1.1.
- **Headline-Md**: Fraunces, 1.563rem, weight 600, line-height 1.15.
- **Body-Md**: Nunito Sans, 16px, weight 400, line-height 1.56.
- **Label-Md**: Martian 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**: `80px`
- **Step-9**: `96px`
### Breakpoints
mobile 0-639px, tablet 640-1023px, desktop 1024px and above
### Density
Breathable by default with one compact pocket per view; the language depends on contrast between 4px micro-gaps and 96px quiet fields.
### Grid
Desktop uses a 12-column max-width 1180px grid with 24px gutters and an asymmetric 7/5 split; tablet collapses to 6 columns; mobile uses one column with 24px edge padding.
### Responsive
At tablet sizes, supporting lozenges move below the dominant workspace while maintaining offset overlap; at mobile, decorative washes flatten and text shelves become full-width cards.
### Whitespace
White space is an active material: keep at least one unfilled field near the main panel, separate sections by 64px or more, and avoid filling corners with decoration.
## Elevation & Depth
### Shadows
- **Lg**: 0 30px 90px rgba(84, 112, 130, 0.14), 0 8px 24px rgba(217,130,152,0.10), inset 0 1px 0 rgba(255,255,255,0.9)
- **Md**: 0 18px 54px rgba(94, 63, 74, 0.10), inset 0 1px 0 rgba(255,255,255,0.86)
- **Sm**: 0 1px 2px rgba(35, 33, 38, 0.05), inset 0 1px 0 rgba(255,255,255,0.76)
## Shapes
### Rounded
- **Full**: `9999px`
- **Lg**: `24px`
- **Md**: `24px`
- **None**: `0px`
- **Sm**: `16px`
### Surfaces
- **Bg Pattern**: Nearly plain white with two oversized radial surface tints: pale lychee at the top left and pale pool blue at the lower right, both below 18 percent opacity.
- **Card Style**: Dominant cards use {colors.surface} with translucent overlays, a committed 24px container radius, 1px near-invisible borders, and inset top highlights for a candy-shell edge.
- **Treatment**: Milk-glass layering: rgba(255,255,255,0.72) panels over #FFFFFF with backdrop-filter blur(22px), clipped blush/aqua lozenges, and opaque micro-panels behind dense text.
### Borders
- **Accent Width**: 2px
- **Character**: Borders are milk-glass seams: rgba(35,33,38,0.08) on neutral surfaces and thin pink/blue rails only for active or selected elements.
- **Default Width**: 1px
- **Style**: solid
## Components
### Composition
Build screens around one dominant translucent workspace, not equal cards. Leave a large quiet white area on at least one side, place supporting modules as smaller offset lozenges, and let pale background washes imply zones. Use an asymmetric split at desktop, stacked priority at tablet, and a single-column story at mobile. Never rely on hard dividers when spacing and tint can group the content.
### Density
Overall density is low and breathable, but each screen needs one dense operational pocket such as a compact tray, route list, or status stack. Use 4 to 8px gaps inside small clusters and 64 to 96px separations between conceptual areas.
### Hierarchy
Use a three-voice type hierarchy: Fraunces display headlines with -0.04em tracking and soft optical weight, Nunito Sans body copy at 16px with -0.02em tracking, and Martian Mono labels for tiny timestamps and quantities. Primary actions get pool blue outlines or fills; care or warmth cues get lychee pink chips. Text remains dark on opaque reading planes even inside glass panels.
### Signature Patterns
- Dew-drop selection blob: an active pill contains a small translucent circular highlight offset to the upper right with pool-blue edge tint.
- Milk-glass reading shelf: translucent outer cards include a solid white inner shelf for copy-heavy rows to preserve contrast under blur.
- Tint lozenge zoning: blush and aqua rounded background capsules sit behind sections instead of using gray dividers or colored cards.
- Candy-shell border stack: components combine a 1px low-opacity seam, inset white highlight, and restrained soft shadow for tactile depth.
- Sparse flavor chips: lychee and pool accents appear as miniature labels, rails, and badges with large white space around them.
## 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-019e0a5d-fffb-71f1-a47b-7e5bc145b049/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 a white or milk-neutral canvas and let soft spacing do more work than boxes.
- Do Reserve lychee pink for caring, warm, or completion cues and pool blue for current location, focus, or navigation.
- Do Place long copy and important numbers on opaque white shelves even when the parent card is frosted glass.
- Do Use 24px container radii and full-pill controls consistently; the softness should feel systematic rather than randomly bubbly.
- Do Keep borders near invisible at roughly 6 to 10 percent opacity and strengthen only the active rail.
- Do Create at least one asymmetric composition break with an oversized quiet field or offset floating tray.
- Do Check contrast on every translucent panel and increase shelf opacity before increasing text weight.
- Don't Do not use rainbow gradients, saturated candy stripes, neon glows, or more than two accent hues.
- Don't Do not place paragraph text directly on busy blur, imagery, or overlapping tinted shapes.
- Don't Do not add mascots, emoji, sticker clusters, toy icons, bubble alphabets, or childish kawaii clutter.
- Don't Do not create three equal cards in a row; one module must be dominant or the layout must be asymmetric.
- Don't Do not use heavy gray borders, generic SaaS shadows, or default form controls.
- Don't Do not fill every white area with decoration; the blank field is part of the language.
- Don't Do not animate with looping shimmer, jelly bounce, or syrup-like motion that undermines calm readability.
### Accessibility
Maintain WCAG AA contrast for body text, keep blur decorative instead of structural for reading, provide visible focus rings in pool blue, and avoid communicating state by color alone.
### Usage Context
Best for wellness utilities, gentle scheduling, taste curation, learning companions, and consumer productivity where calm delight and immediate legibility both matter.
shadcn/ui theme
```json
{
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
"name": "dew-candy-minimalism",
"type": "registry:theme",
"title": "Dew Candy Minimalism shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#FFFFFF",
"foreground": "#232126",
"card": "#FDFBFA",
"card-foreground": "#232126",
"popover": "#FDFBFA",
"popover-foreground": "#232126",
"primary": "#D98298",
"primary-foreground": "#ffffff",
"secondary": "#74BCD6",
"secondary-foreground": "#ffffff",
"muted": "#746F78",
"muted-foreground": "#232126",
"accent": "#F2B7C5",
"accent-foreground": "#111111",
"destructive": "#B65B68",
"border": "#EDE7E8",
"input": "#EDE7E8",
"ring": "#F2B7C5",
"chart-1": "#D98298",
"chart-2": "#74BCD6",
"chart-3": "#F2B7C5",
"chart-4": "#5D947E",
"chart-5": "#B58A4C",
"sidebar": "#FDFBFA",
"sidebar-foreground": "#232126",
"sidebar-primary": "#D98298",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#5D9EB8",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#EDE7E8",
"sidebar-ring": "#F2B7C5",
"radius": "24px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#D98298",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#F2B7C5",
"accent-foreground": "#111111",
"destructive": "#B65B68",
"border": "#303642",
"input": "#303642",
"ring": "#F2B7C5",
"chart-1": "#D98298",
"chart-2": "#74BCD6",
"chart-3": "#F2B7C5",
"chart-4": "#5D947E",
"chart-5": "#B58A4C",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#D98298",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#F2B7C5",
"sidebar-accent-foreground": "#111111",
"sidebar-border": "#303642",
"sidebar-ring": "#F2B7C5",
"radius": "24px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019e0a5d-fffb-71f1-a47b-7e5bc145b049",
"slug": "dew-candy-minimalism",
"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
- step-880px
- step-996px
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: #FFFFFF;
--foreground: #232126;
--card: #FDFBFA;
--card-foreground: #232126;
--popover: #FDFBFA;
--popover-foreground: #232126;
--primary: #D98298;
--primary-foreground: #ffffff;
--secondary: #74BCD6;
--secondary-foreground: #ffffff;
--muted: #746F78;
--muted-foreground: #232126;
--accent: #F2B7C5;
--accent-foreground: #111111;
--destructive: #B65B68;
--border: #EDE7E8;
--input: #EDE7E8;
--ring: #F2B7C5;
--chart-1: #D98298;
--chart-2: #74BCD6;
--chart-3: #F2B7C5;
--chart-4: #5D947E;
--chart-5: #B58A4C;
--sidebar: #FDFBFA;
--sidebar-foreground: #232126;
--sidebar-primary: #D98298;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #5D9EB8;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #EDE7E8;
--sidebar-ring: #F2B7C5;
--radius: 24px;
}
.dark {
--background: #0f1115;
--foreground: #f8fafc;
--card: #181b22;
--card-foreground: #f8fafc;
--popover: #181b22;
--popover-foreground: #f8fafc;
--primary: #D98298;
--primary-foreground: #ffffff;
--secondary: #252a33;
--secondary-foreground: #f8fafc;
--muted: #252a33;
--muted-foreground: #a1a1aa;
--accent: #F2B7C5;
--accent-foreground: #111111;
--destructive: #B65B68;
--border: #303642;
--input: #303642;
--ring: #F2B7C5;
--chart-1: #D98298;
--chart-2: #74BCD6;
--chart-3: #F2B7C5;
--chart-4: #5D947E;
--chart-5: #B58A4C;
--sidebar: #181b22;
--sidebar-foreground: #f8fafc;
--sidebar-primary: #D98298;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #F2B7C5;
--sidebar-accent-foreground: #111111;
--sidebar-border: #303642;
--sidebar-ring: #F2B7C5;
--radius: 24px;
}
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 DewCandyMinimalismShadcnKit() {
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">Dew Candy Minimalism</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": "dew-candy-minimalism",
"type": "registry:theme",
"title": "Dew Candy Minimalism shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#FFFFFF",
"foreground": "#232126",
"card": "#FDFBFA",
"card-foreground": "#232126",
"popover": "#FDFBFA",
"popover-foreground": "#232126",
"primary": "#D98298",
"primary-foreground": "#ffffff",
"secondary": "#74BCD6",
"secondary-foreground": "#ffffff",
"muted": "#746F78",
"muted-foreground": "#232126",
"accent": "#F2B7C5",
"accent-foreground": "#111111",
"destructive": "#B65B68",
"border": "#EDE7E8",
"input": "#EDE7E8",
"ring": "#F2B7C5",
"chart-1": "#D98298",
"chart-2": "#74BCD6",
"chart-3": "#F2B7C5",
"chart-4": "#5D947E",
"chart-5": "#B58A4C",
"sidebar": "#FDFBFA",
"sidebar-foreground": "#232126",
"sidebar-primary": "#D98298",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#5D9EB8",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#EDE7E8",
"sidebar-ring": "#F2B7C5",
"radius": "24px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#D98298",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#F2B7C5",
"accent-foreground": "#111111",
"destructive": "#B65B68",
"border": "#303642",
"input": "#303642",
"ring": "#F2B7C5",
"chart-1": "#D98298",
"chart-2": "#74BCD6",
"chart-3": "#F2B7C5",
"chart-4": "#5D947E",
"chart-5": "#B58A4C",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#D98298",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#F2B7C5",
"sidebar-accent-foreground": "#111111",
"sidebar-border": "#303642",
"sidebar-ring": "#F2B7C5",
"radius": "24px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019e0a5d-fffb-71f1-a47b-7e5bc145b049",
"slug": "dew-candy-minimalism",
"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"
]
}
}
}
# Dew Candy Minimalism shadcn/ui Components
Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `en-019e0a5d-fffb-71f1-a47b-7e5bc145b049`
Slug: `dew-candy-minimalism`
## Intent
Dew Candy Minimalism is an airy, readable white-space interface language that borrows the softness of milk glass and fruit candy without becoming childish. It uses mostly white and barely tinted surfaces, reserving lychee pink and pool blue for priority cues, selected controls, and small moments of delight. Translucency is a hierarchy tool rather than decoration: frosted panels, liquid highlights, and pale surface tints create depth while text stays high contrast and calm.
## 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": "#F2B7C5",
"background": "#FFFFFF",
"border": "#EDE7E8",
"error": "#B65B68",
"info": "#5D9EB8",
"muted": "#746F78",
"primary": "#D98298",
"secondary": "#74BCD6",
"success": "#5D947E",
"surface": "#FDFBFA",
"text": "#232126",
"warning": "#B58A4C"
}
Typography:
{
"base_size": "16px",
"body_font": "Nunito Sans",
"google_fonts_url": "https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght,SOFT,WONK@9..144,500..700,80,0..1&family=Nunito+Sans:opsz,wght@6..12,400;6..12,650;6..12,760&family=Martian+Mono:wght@500;600&display=swap",
"heading_font": "Fraunces",
"letter_spacing": "-0.02em",
"line_height": 1.56,
"mono_font": "Martian Mono",
"scale_ratio": 1.25
}
## Visual character to preserve
- A white canvas uses oversized asymmetric empty zones, with content gathered into one dominant milk-glass panel and smaller offset tint chips.
- Cards use rgba white fills, backdrop-filter blur, inset white highlights, and 8 percent borders while text sits on nontransparent reading layers.
- Lychee pink and pool blue appear as tiny pill tabs, active rails, and one liquid selection blob rather than full-area gradients.
- Controls share a committed 24px rounded container radius or full pills, using soft inner shadows and hairline borders to suggest candy shells without toy gloss.
- Section dividers are replaced by pale aqua or blush surface washes clipped into rounded lozenges that float behind content.
## ShadSync visual profile
{
"family": "system",
"material": "flat",
"contour": "blob",
"border": "solid",
"underlay": true,
"grain": false,
"stickerBadges": true,
"motion": "still",
"density": "dense",
"accents": [
"primary",
"accent",
"secondary",
"muted"
]
}
## Signature component recipes
### Button
Use `Button` for primary, secondary, outline, and ghost actions. Primary actions must expose the language's strongest contrast pair, while secondary and ghost actions should preserve the surface treatment instead of falling back to default neutral SaaS styling.
### Card
Use `Card`, `CardHeader`, `CardContent`, `CardFooter`, and `CardAction` as the main composition frame. Cards should demonstrate the language's surface, border, hierarchy, and density rules rather than appearing as generic rounded rectangles.
### Input and Textarea
Use `Input` and `Textarea` with visible focus rings, field labels, validation states, and the language's rhythm. Forms should show real product content, not placeholder-only controls.
### Select, Tabs, and Table
Use `Select`, `Tabs`, and `Table` to prove navigation, filtering, and dense data states. The table should show row rhythm, separators, hover/focus states, and an empty or status state when the language calls for it.
### Dialog and Sheet
Use `Dialog` for centered decisions and `Sheet` for contextual editing. Both should inherit the language's spacing, border, overlay, and motion rules.
## Preview shots
- `application-shell`: dashboard or workspace shell with navigation, cards, forms, and state badges.
- `detail-editor`: focused editing flow using input, textarea, select, switch/checkbox, dialog or sheet, and action buttons.
- `data-operations`: table-heavy operational view with tabs, dropdown menu affordances, badges, and destructive/empty states.
- Each preview shot must include a renderable `scene` payload with concrete headline, description, actions, and rows/fields/stats for the UI preview.
## Implementation contract
- Start from local `ui/src/components/ui` shadcn-style primitives; do not create a second component system.
- Apply `/katagami/shadcn/dew-candy-minimalism/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 a white or milk-neutral canvas and let soft spacing do more work than boxes.; Reserve lychee pink for caring, warm, or completion cues and pool blue for current location, focus, or navigation.; Place long copy and important numbers on opaque white shelves even when the parent card is frosted glass.; Use 24px container radii and full-pill controls consistently; the softness should feel systematic rather than randomly bubbly.; Keep borders near invisible at roughly 6 to 10 percent opacity and strengthen only the active rail.; Create at least one asymmetric composition break with an oversized quiet field or offset floating tray.; Check contrast on every translucent panel and increase shelf opacity before increasing text weight.
- Do not: Do not use rainbow gradients, saturated candy stripes, neon glows, or more than two accent hues.; Do not place paragraph text directly on busy blur, imagery, or overlapping tinted shapes.; Do not add mascots, emoji, sticker clusters, toy icons, bubble alphabets, or childish kawaii clutter.; Do not create three equal cards in a row; one module must be dominant or the layout must be asymmetric.; Do not use heavy gray borders, generic SaaS shadows, or default form controls.; Do not fill every white area with decoration; the blank field is part of the language.; Do not animate with looping shimmer, jelly bounce, or syrup-like motion that undermines calm readability.
## 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 DewCandyMinimalismShadcnKit() {
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">Dew Candy Minimalism</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 0-639px, tablet 640-1023px, desktop 1024px and above",
"density": "Breathable by default with one compact pocket per view; the language depends on contrast between 4px micro-gaps and 96px quiet fields.",
"grid": "Desktop uses a 12-column max-width 1180px grid with 24px gutters and an asymmetric 7/5 split; tablet collapses to 6 columns; mobile uses one column with 24px edge padding.",
"responsive": "At tablet sizes, supporting lozenges move below the dominant workspace while maintaining offset overlap; at mobile, decorative washes flatten and text shelves become full-width cards.",
"whitespace": "White space is an active material: keep at least one unfilled field near the main panel, separate sections by 64px or more, and avoid filling corners with decoration."
}
{
"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-019e0a5d-fffb-71f1-a47b-7e5bc145b049",
"name": "Dew Candy Minimalism",
"slug": "dew-candy-minimalism"
},
"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 white canvas uses oversized asymmetric empty zones, with content gathered into one dominant milk-glass panel and smaller offset tint chips.",
"Cards use rgba white fills, backdrop-filter blur, inset white highlights, and 8 percent borders while text sits on nontransparent reading layers.",
"Lychee pink and pool blue appear as tiny pill tabs, active rails, and one liquid selection blob rather than full-area gradients.",
"Controls share a committed 24px rounded container radius or full pills, using soft inner shadows and hairline borders to suggest candy shells without toy gloss.",
"Section dividers are replaced by pale aqua or blush surface washes clipped into rounded lozenges that float behind content."
],
"visualProfile": {
"family": "system",
"material": "flat",
"contour": "blob",
"border": "solid",
"underlay": true,
"grain": false,
"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": "Dew Candy Minimalism 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 a white or milk-neutral canvas and let soft spacing do more work than boxes.",
"Reserve lychee pink for caring, warm, or completion cues and pool blue for current location, focus, or navigation.",
"Place long copy and important numbers on opaque white shelves even when the parent card is frosted glass.",
"Use 24px container radii and full-pill controls consistently; the softness should feel systematic rather than randomly bubbly.",
"Keep borders near invisible at roughly 6 to 10 percent opacity and strengthen only the active rail.",
"Create at least one asymmetric composition break with an oversized quiet field or offset floating tray.",
"Check contrast on every translucent panel and increase shelf opacity before increasing text weight."
],
"dont": [
"Do not use rainbow gradients, saturated candy stripes, neon glows, or more than two accent hues.",
"Do not place paragraph text directly on busy blur, imagery, or overlapping tinted shapes.",
"Do not add mascots, emoji, sticker clusters, toy icons, bubble alphabets, or childish kawaii clutter.",
"Do not create three equal cards in a row; one module must be dominant or the layout must be asymmetric.",
"Do not use heavy gray borders, generic SaaS shadows, or default form controls.",
"Do not fill every white area with decoration; the blank field is part of the language.",
"Do not animate with looping shimmer, jelly bounce, or syrup-like motion that undermines calm readability."
]
}
}