back to gallerydo avoid
design language·kawaii-watercolor-packaging
Kawaii Watercolor Packaging
A portable design language for agents: download the markdown first, then inspect the preview, tokens, and rules as needed.
Download DESIGN.md
Portable DESIGN.md source of truth for most agents and apps.
the spec
specification
philosophy
summary
Kawaii Watercolor Packaging translates lessons from Japanese character goods, confection packaging, boutique skincare cartons, and watercolor paper craft into a UI language for soft-commerce and personal product experiences. Research into kawaii visual culture emphasizes friendliness through rounded forms, miniaturization, and approachable mascots; Japanese stationery and gift packaging contribute disciplined label zones, specimen windows, and neat shelf alignment; watercolor references contribute feathered edges, pigment bloom, and absorbent-paper softness. The resulting system is not childish collage and not flat luxury minimalism. It creates a curated package-flatlay feeling where airy washes sit underneath precise package geometry, tiny mascots act like collectible companions, and every action feels as if it were tucked into a seal, tag, or label strip. Interfaces using this language should feel giftable, delicate, emotionally clean, and commercially credible at the same time.
values
Tenderness over spectacle: sweetness should be offered through soft form, small motifs, and quiet color rather than loud novelty.Packaging discipline: charming details must live inside orderly shelves, label bands, specimen windows, and aligned metadata blocks.Painterly tactility: gradients, shadows, and overlays should resemble pigment diffusing through paper instead of synthetic glossy effects.Miniature delight: mascots, stamps, and icons stay small so they feel precious and collectible rather than dominant.Giftable refinement: every surface should feel like part of a premium stationery, skincare, or confection package ready to be unwrapped.
anti-values
×Neon pop clutter, sticker-bomb density, and chaotic youth-culture collage.×Sterile luxury minimalism that removes softness, character, and illustration.×Huge cartoon mascots or childish novelty that overwhelms functional content.×Sharp-edged enterprise cards with hard vector fills and no material bloom.
tokens
colors23 items
primary
#F4B6C8
secondary
#BFE9DD
accent
#CDBDF7
background
#FFF9F5
surface
#FFFDFC
text
#5E5469
muted
#8D8398
border
#8E7AA8
error
#E78CA8
success
#8BC9AE
warning
#F2C97D
info
#9EC7F3
cream
#FFF4E8
butter
#F9EDB8
sorbet
#FFD7DF
mint_milk
#DDF5EE
lilac_mist
#E9E0FA
plum_ink
#6F5D84
rose_water
#FCE5EC
mint_haze
#EAF8F2
lavender_wash
#F0EBFB
paper_white
#FFFEFD
shadow_tint
#D9D0E6
typography9 items
- heading font
- 'M PLUS Rounded 1c', 'Hiragino Maru Gothic ProN', sans-serif
- body font
- 'Zen Maru Gothic', 'Hiragino Kaku Gothic ProN', sans-serif
- mono font
- 'IBM Plex Mono', monospace
- base size
- 16px
- scale ratio
- 1.2
- line height
- 1.58
- letter spacing
- 0.01em
- weights
- regular 400·medium 500·semibold 600·bold 700
- google fonts url
- https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500&family=M+PLUS+Rounded+1c:wght@500;700;800&family=Zen+Maru+Gothic:wght@400;500;700&display=swap
spacing2 items
- base
- 8px
- scale
- 4, 8, 12, 16, 20, 24, 32, 40, 48, 64, 88
radii6 items
- none
- 0
- sm
- 10px
- md
- 18px
- lg
- 28px
- xl
- 38px
- full
- 9999px
shadows3 items
- sm
- 0 8px 20px rgba(132, 111, 155, 0.10)
- md
- 0 16px 36px rgba(132, 111, 155, 0.14)
- lg
- 0 28px 64px rgba(132, 111, 155, 0.18)
surfaces3 items
- treatment
- paper
- card style
- paper-white translucent cards with watercolor bloom backings, vellum top glows, and soft inset cutout windows that mimic boutique packaging inserts
- bg pattern
- wash clouds, ruled packaging lines, dotted confection specks
borders4 items
- default width
- 1.5px
- accent width
- 2.5px
- style
- solid
- character
- plum-ink borders are light but deliberate, often paired with dashed micro separators and attached label seams so sections feel packaged rather than simply boxed
motion3 items
- duration
- 220ms
- easing
- cubic-bezier(0.22, 1, 0.36, 1)
- philosophy
- gentle lift and pigment bloom: controls rise slightly, shadows soften outward, and tabs feel like delicate stickers being peeled from paper
rules
composition
Compose the screen like a premium Japanese gift package opened on a desk: one dominant specimen module, one supporting detail stack, and one lower shelf of neatly grouped assortments. Decorative elements should sit at the edges of these structures, not float independently. Watercolor fields may extend beyond the framed content, but the content itself must snap to package geometry with consistent baselines, rail alignments, and measured outer margins.
hierarchy
Lead with one framed specimen window and rounded display heading, then use slim label strips, mono metadata, and soft value chips to organize everything else. Contrast should come from cream-versus-wash layering, size changes, and border emphasis rather than hard black fills. Actions should appear as petite seals, tabs, or capsule buttons. Supporting data should be arranged in tidy value pairs or shelf rows, never in noisy dashboard scatter.
density
Low-to-medium density with generous outer air and tighter inner packets. Each cluster should feel collectible and deliberate, allowing micro-detail without losing calm.
signature patterns
every major panel gets a watercolor bloom backdrop through blurred radial-gradient pseudo-elements so the package frame appears to rest on absorbed pigmentlabel rails attach to the top or side edge of cards as capsules or strips carrying mono microcopy, SKU text, and dashed rule dividersspecimen windows use inset rounded rectangles with inner translucent borders, paper overlays, and soft shadows to mimic retail package cutoutsmini mascot medallions or icon stamps sit at strategic corners with imperfect outlines and tiny drop shadows, always smaller than adjacent text blocksstrict grid shelves are softened by confection micro-details like barcode ticks, sprinkle dots, and tiny seals placed inside alignment systems rather than outside them
layout
grid
Use a 12-column desktop packaging grid within a 1280px max width, 24px gutters, and 32px page margins. The first row typically splits 7/5 or 8/4 so a large specimen module dominates while a secondary stack supports it. Lower shelves can subdivide into two or three columns, but internal elements should still align to a clear baseline and label-rail logic.
breakpoints
Desktop: 1280px and above. Tablet: 820px to 1279px with an 8-column grid and reduced gutters. Mobile: 0px to 819px with a 4-column grid, full-width stacked specimen modules, and preserved corner-mascot and label-rail behavior.
whitespace
Whitespace should feel like the cream margin around a wrapped confection box: generous around primary modules, tighter inside chips and metadata shelves, and never so compressed that watercolor atmosphere disappears.
density
Aim for medium-light density suitable for boutique commerce, giftable dashboards, and curated product management views.
guidance
- Build sections from specimen windows, label rails, and shelf-like rows before adding decorative motifs.
- Use overlapping pastel washes with softened feathered edges instead of flat opaque rectangles.
- Keep mascots and icons miniature, corner-based, and subordinate to content.
- Pair rounded Japanese-friendly headings with mono microcopy for packaging contrast.
- Style actions as seals, stickers, tabs, or capsules that feel physically attached to the card.
- Use dashed dividers, barcode ticks, and neat quantity chips to make sweetness feel curated.
- Do not use neon hues, harsh black outlines, or arcade-pop visual aggression.
- Do not enlarge mascots into hero illustrations that compete with the main information.
- Do not replace pigment bloom with generic glassmorphism or flat SaaS cards.
- Do not scatter bows, cherries, and icons randomly outside the grid system.
- Do not rely on browser-default inputs or severe corporate typography.
- Do not turn the page into a scrapbook collage with many equal competing panels.
katagami spec
# Kawaii Watercolor Packaging
## Philosophy
Kawaii Watercolor Packaging translates lessons from Japanese character goods, confection packaging, boutique skincare cartons, and watercolor paper craft into a UI language for soft-commerce and personal product experiences. Research into kawaii visual culture emphasizes friendliness through rounded forms, miniaturization, and approachable mascots; Japanese stationery and gift packaging contribute disciplined label zones, specimen windows, and neat shelf alignment; watercolor references contribute feathered edges, pigment bloom, and absorbent-paper softness. The resulting system is not childish collage and not flat luxury minimalism. It creates a curated package-flatlay feeling where airy washes sit underneath precise package geometry, tiny mascots act like collectible companions, and every action feels as if it were tucked into a seal, tag, or label strip. Interfaces using this language should feel giftable, delicate, emotionally clean, and commercially credible at the same time.
### Values
- Tenderness over spectacle: sweetness should be offered through soft form, small motifs, and quiet color rather than loud novelty.
- Packaging discipline: charming details must live inside orderly shelves, label bands, specimen windows, and aligned metadata blocks.
- Painterly tactility: gradients, shadows, and overlays should resemble pigment diffusing through paper instead of synthetic glossy effects.
- Miniature delight: mascots, stamps, and icons stay small so they feel precious and collectible rather than dominant.
- Giftable refinement: every surface should feel like part of a premium stationery, skincare, or confection package ready to be unwrapped.
### Anti-Values
- Neon pop clutter, sticker-bomb density, and chaotic youth-culture collage.
- Sterile luxury minimalism that removes softness, character, and illustration.
- Huge cartoon mascots or childish novelty that overwhelms functional content.
- Sharp-edged enterprise cards with hard vector fills and no material bloom.
### Visual Character
- paper-white and cream panels sit over translucent watercolor washes created with blurred radial gradients so every section feels placed on painted paper
- small mascots, cherries, bows, and object icons appear only as corner medallions, stamps, or tiny badges with soft irregular outlines and never as giant illustrations
- rounded specimen windows use inner translucent borders, vellum overlays, and precise package-style framing to mimic product cutouts on Japanese retail boxes
- slim label rails and capsule tabs attach to card edges with mono microcopy, SKU notation, dashed dividers, and barcode-like ticks for packaging precision
- the palette stays in blush pink, mint milk, lilac mist, butter cream, and plum ink, with one darker outline color keeping pastel softness from dissolving into haze
## Tokens
### Colors
| Name | Value |
|------|-------|
| primary | `#F4B6C8` |
| secondary | `#BFE9DD` |
| accent | `#CDBDF7` |
| background | `#FFF9F5` |
| surface | `#FFFDFC` |
| text | `#5E5469` |
| muted | `#8D8398` |
| border | `#8E7AA8` |
| error | `#E78CA8` |
| success | `#8BC9AE` |
| warning | `#F2C97D` |
| info | `#9EC7F3` |
| cream | `#FFF4E8` |
| butter | `#F9EDB8` |
| sorbet | `#FFD7DF` |
| mint_milk | `#DDF5EE` |
| lilac_mist | `#E9E0FA` |
| plum_ink | `#6F5D84` |
| rose_water | `#FCE5EC` |
| mint_haze | `#EAF8F2` |
| lavender_wash | `#F0EBFB` |
| paper_white | `#FFFEFD` |
| shadow_tint | `#D9D0E6` |
### Typography
- **Heading Font**: 'M PLUS Rounded 1c', 'Hiragino Maru Gothic ProN', sans-serif
- **Body Font**: 'Zen Maru Gothic', 'Hiragino Kaku Gothic ProN', sans-serif
- **Mono Font**: 'IBM Plex Mono', monospace
- **Base Size**: 16px
- **Scale Ratio**: 1.2
- **Line Height**: 1.58
- **Letter Spacing**: 0.01em
- **Weights**: {"regular":400,"medium":500,"semibold":600,"bold":700}
- **Google Fonts Url**: https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500&family=M+PLUS+Rounded+1c:wght@500;700;800&family=Zen+Maru+Gothic:wght@400;500;700&display=swap
### Spacing
- **Base**: 8px
- **Scale**: [4,8,12,16,20,24,32,40,48,64,88]
### Radii
- **None**: 0
- **Sm**: 10px
- **Md**: 18px
- **Lg**: 28px
- **Xl**: 38px
- **Full**: 9999px
### Shadows
- **Sm**: 0 8px 20px rgba(132, 111, 155, 0.10)
- **Md**: 0 16px 36px rgba(132, 111, 155, 0.14)
- **Lg**: 0 28px 64px rgba(132, 111, 155, 0.18)
### Surfaces
- **Treatment**: paper
- **Card Style**: paper-white translucent cards with watercolor bloom backings, vellum top glows, and soft inset cutout windows that mimic boutique packaging inserts
- **Bg Pattern**: wash clouds, ruled packaging lines, dotted confection specks
### Borders
- **Default Width**: 1.5px
- **Accent Width**: 2.5px
- **Style**: solid
- **Character**: plum-ink borders are light but deliberate, often paired with dashed micro separators and attached label seams so sections feel packaged rather than simply boxed
### Motion
- **Duration**: 220ms
- **Easing**: cubic-bezier(0.22, 1, 0.36, 1)
- **Philosophy**: gentle lift and pigment bloom: controls rise slightly, shadows soften outward, and tabs feel like delicate stickers being peeled from paper
## Rules
### Composition
Compose the screen like a premium Japanese gift package opened on a desk: one dominant specimen module, one supporting detail stack, and one lower shelf of neatly grouped assortments. Decorative elements should sit at the edges of these structures, not float independently. Watercolor fields may extend beyond the framed content, but the content itself must snap to package geometry with consistent baselines, rail alignments, and measured outer margins.
### Hierarchy
Lead with one framed specimen window and rounded display heading, then use slim label strips, mono metadata, and soft value chips to organize everything else. Contrast should come from cream-versus-wash layering, size changes, and border emphasis rather than hard black fills. Actions should appear as petite seals, tabs, or capsule buttons. Supporting data should be arranged in tidy value pairs or shelf rows, never in noisy dashboard scatter.
### Density
Low-to-medium density with generous outer air and tighter inner packets. Each cluster should feel collectible and deliberate, allowing micro-detail without losing calm.
### Signature Patterns
- every major panel gets a watercolor bloom backdrop through blurred radial-gradient pseudo-elements so the package frame appears to rest on absorbed pigment
- label rails attach to the top or side edge of cards as capsules or strips carrying mono microcopy, SKU text, and dashed rule dividers
- specimen windows use inset rounded rectangles with inner translucent borders, paper overlays, and soft shadows to mimic retail package cutouts
- mini mascot medallions or icon stamps sit at strategic corners with imperfect outlines and tiny drop shadows, always smaller than adjacent text blocks
- strict grid shelves are softened by confection micro-details like barcode ticks, sprinkle dots, and tiny seals placed inside alignment systems rather than outside them
## Layout
### Grid
Use a 12-column desktop packaging grid within a 1280px max width, 24px gutters, and 32px page margins. The first row typically splits 7/5 or 8/4 so a large specimen module dominates while a secondary stack supports it. Lower shelves can subdivide into two or three columns, but internal elements should still align to a clear baseline and label-rail logic.
### Breakpoints
Desktop: 1280px and above. Tablet: 820px to 1279px with an 8-column grid and reduced gutters. Mobile: 0px to 819px with a 4-column grid, full-width stacked specimen modules, and preserved corner-mascot and label-rail behavior.
### Whitespace
Whitespace should feel like the cream margin around a wrapped confection box: generous around primary modules, tighter inside chips and metadata shelves, and never so compressed that watercolor atmosphere disappears.
### Density
Aim for medium-light density suitable for boutique commerce, giftable dashboards, and curated product management views.
## Guidance
### Do
- Build sections from specimen windows, label rails, and shelf-like rows before adding decorative motifs.
- Use overlapping pastel washes with softened feathered edges instead of flat opaque rectangles.
- Keep mascots and icons miniature, corner-based, and subordinate to content.
- Pair rounded Japanese-friendly headings with mono microcopy for packaging contrast.
- Style actions as seals, stickers, tabs, or capsules that feel physically attached to the card.
- Use dashed dividers, barcode ticks, and neat quantity chips to make sweetness feel curated.
### Don't
- Do not use neon hues, harsh black outlines, or arcade-pop visual aggression.
- Do not enlarge mascots into hero illustrations that compete with the main information.
- Do not replace pigment bloom with generic glassmorphism or flat SaaS cards.
- Do not scatter bows, cherries, and icons randomly outside the grid system.
- Do not rely on browser-default inputs or severe corporate typography.
- Do not turn the page into a scrapbook collage with many equal competing panels.
DESIGN.md
---
version: "alpha"
name: "Kawaii Watercolor Packaging"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
primary: "#F4B6C8"
secondary: "#BFE9DD"
accent: "#CDBDF7"
background: "#FFF9F5"
surface: "#FFFDFC"
text: "#5E5469"
muted: "#8D8398"
border: "#8E7AA8"
error: "#E78CA8"
success: "#8BC9AE"
warning: "#F2C97D"
info: "#9EC7F3"
cream: "#FFF4E8"
butter: "#F9EDB8"
sorbet: "#FFD7DF"
mint_milk: "#DDF5EE"
lilac_mist: "#E9E0FA"
plum_ink: "#6F5D84"
rose_water: "#FCE5EC"
mint_haze: "#EAF8F2"
lavender_wash: "#F0EBFB"
paper_white: "#FFFEFD"
shadow_tint: "#D9D0E6"
typography:
headline-lg:
fontFamily: "'M PLUS Rounded 1c', 'Hiragino Maru Gothic ProN', sans-serif"
fontSize: "1.728rem"
fontWeight: 700
lineHeight: 1.1
letterSpacing: "0.01em"
headline-md:
fontFamily: "'M PLUS Rounded 1c', 'Hiragino Maru Gothic ProN', sans-serif"
fontSize: "1.44rem"
fontWeight: 600
lineHeight: 1.15
letterSpacing: "0.01em"
body-md:
fontFamily: "'Zen Maru Gothic', 'Hiragino Kaku Gothic ProN', sans-serif"
fontSize: "16px"
fontWeight: 400
lineHeight: 1.58
letterSpacing: "0.01em"
label-md:
fontFamily: "'IBM Plex Mono', monospace"
fontSize: "0.75rem"
fontWeight: 600
lineHeight: 1
letterSpacing: "0.08em"
rounded:
none: "0px"
sm: "10px"
md: "18px"
lg: "28px"
xl: "38px"
full: "9999px"
spacing:
base: "8px"
xs: "4px"
sm: "8px"
md: "12px"
lg: "16px"
xl: "20px"
2xl: "24px"
3xl: "32px"
4xl: "40px"
step-8: "48px"
step-9: "64px"
step-10: "88px"
components:
color-reference-primary:
backgroundColor: "{colors.primary}"
color-reference-secondary:
backgroundColor: "{colors.secondary}"
color-reference-accent:
backgroundColor: "{colors.accent}"
color-reference-background:
backgroundColor: "{colors.background}"
color-reference-surface:
backgroundColor: "{colors.surface}"
color-reference-text:
backgroundColor: "{colors.text}"
color-reference-muted:
backgroundColor: "{colors.muted}"
color-reference-border:
backgroundColor: "{colors.border}"
color-reference-error:
backgroundColor: "{colors.error}"
color-reference-success:
backgroundColor: "{colors.success}"
color-reference-warning:
backgroundColor: "{colors.warning}"
color-reference-info:
backgroundColor: "{colors.info}"
color-reference-cream:
backgroundColor: "{colors.cream}"
color-reference-butter:
backgroundColor: "{colors.butter}"
color-reference-sorbet:
backgroundColor: "{colors.sorbet}"
color-reference-mint_milk:
backgroundColor: "{colors.mint_milk}"
color-reference-lilac_mist:
backgroundColor: "{colors.lilac_mist}"
color-reference-plum_ink:
backgroundColor: "{colors.plum_ink}"
color-reference-rose_water:
backgroundColor: "{colors.rose_water}"
color-reference-mint_haze:
backgroundColor: "{colors.mint_haze}"
color-reference-lavender_wash:
backgroundColor: "{colors.lavender_wash}"
color-reference-paper_white:
backgroundColor: "{colors.paper_white}"
color-reference-shadow_tint:
backgroundColor: "{colors.shadow_tint}"
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"
---
# Kawaii Watercolor Packaging
## Overview
Kawaii Watercolor Packaging translates lessons from Japanese character goods, confection packaging, boutique skincare cartons, and watercolor paper craft into a UI language for soft-commerce and personal product experiences. Research into kawaii visual culture emphasizes friendliness through rounded forms, miniaturization, and approachable mascots; Japanese stationery and gift packaging contribute disciplined label zones, specimen windows, and neat shelf alignment; watercolor references contribute feathered edges, pigment bloom, and absorbent-paper softness. The resulting system is not childish collage and not flat luxury minimalism. It creates a curated package-flatlay feeling where airy washes sit underneath precise package geometry, tiny mascots act like collectible companions, and every action feels as if it were tucked into a seal, tag, or label strip. Interfaces using this language should feel giftable, delicate, emotionally clean, and commercially credible at the same time.
### Values
- Tenderness over spectacle: sweetness should be offered through soft form, small motifs, and quiet color rather than loud novelty.
- Packaging discipline: charming details must live inside orderly shelves, label bands, specimen windows, and aligned metadata blocks.
- Painterly tactility: gradients, shadows, and overlays should resemble pigment diffusing through paper instead of synthetic glossy effects.
- Miniature delight: mascots, stamps, and icons stay small so they feel precious and collectible rather than dominant.
- Giftable refinement: every surface should feel like part of a premium stationery, skincare, or confection package ready to be unwrapped.
### Anti-Values
- Neon pop clutter, sticker-bomb density, and chaotic youth-culture collage.
- Sterile luxury minimalism that removes softness, character, and illustration.
- Huge cartoon mascots or childish novelty that overwhelms functional content.
- Sharp-edged enterprise cards with hard vector fills and no material bloom.
### Visual Character
- paper-white and cream panels sit over translucent watercolor washes created with blurred radial gradients so every section feels placed on painted paper
- small mascots, cherries, bows, and object icons appear only as corner medallions, stamps, or tiny badges with soft irregular outlines and never as giant illustrations
- rounded specimen windows use inner translucent borders, vellum overlays, and precise package-style framing to mimic product cutouts on Japanese retail boxes
- slim label rails and capsule tabs attach to card edges with mono microcopy, SKU notation, dashed dividers, and barcode-like ticks for packaging precision
- the palette stays in blush pink, mint milk, lilac mist, butter cream, and plum ink, with one darker outline color keeping pastel softness from dissolving into haze
## Colors
Use the YAML color tokens as the normative palette. The prose below names the roles agents should preserve when generating UI.
| Token | Value |
|-------|-------|
| primary | `#F4B6C8` |
| secondary | `#BFE9DD` |
| accent | `#CDBDF7` |
| background | `#FFF9F5` |
| surface | `#FFFDFC` |
| text | `#5E5469` |
| muted | `#8D8398` |
| border | `#8E7AA8` |
| error | `#E78CA8` |
| success | `#8BC9AE` |
| warning | `#F2C97D` |
| info | `#9EC7F3` |
| cream | `#FFF4E8` |
| butter | `#F9EDB8` |
| sorbet | `#FFD7DF` |
| mint_milk | `#DDF5EE` |
| lilac_mist | `#E9E0FA` |
| plum_ink | `#6F5D84` |
| rose_water | `#FCE5EC` |
| mint_haze | `#EAF8F2` |
| lavender_wash | `#F0EBFB` |
| paper_white | `#FFFEFD` |
| shadow_tint | `#D9D0E6` |
## Typography
- **Headline-Lg**: 'M PLUS Rounded 1c', 'Hiragino Maru Gothic ProN', sans-serif, 1.728rem, weight 700, line-height 1.1.
- **Headline-Md**: 'M PLUS Rounded 1c', 'Hiragino Maru Gothic ProN', sans-serif, 1.44rem, weight 600, line-height 1.15.
- **Body-Md**: 'Zen Maru Gothic', 'Hiragino Kaku Gothic ProN', sans-serif, 16px, weight 400, line-height 1.58.
- **Label-Md**: 'IBM Plex Mono', monospace, 0.75rem, weight 600, line-height 1.
## Layout
### Spacing Tokens
- **Base**: `8px`
- **Xs**: `4px`
- **Sm**: `8px`
- **Md**: `12px`
- **Lg**: `16px`
- **Xl**: `20px`
- **2xl**: `24px`
- **3xl**: `32px`
- **4xl**: `40px`
- **Step-8**: `48px`
- **Step-9**: `64px`
- **Step-10**: `88px`
### Grid
Use a 12-column desktop packaging grid within a 1280px max width, 24px gutters, and 32px page margins. The first row typically splits 7/5 or 8/4 so a large specimen module dominates while a secondary stack supports it. Lower shelves can subdivide into two or three columns, but internal elements should still align to a clear baseline and label-rail logic.
### Breakpoints
Desktop: 1280px and above. Tablet: 820px to 1279px with an 8-column grid and reduced gutters. Mobile: 0px to 819px with a 4-column grid, full-width stacked specimen modules, and preserved corner-mascot and label-rail behavior.
### Whitespace
Whitespace should feel like the cream margin around a wrapped confection box: generous around primary modules, tighter inside chips and metadata shelves, and never so compressed that watercolor atmosphere disappears.
### Density
Aim for medium-light density suitable for boutique commerce, giftable dashboards, and curated product management views.
## Elevation & Depth
### Shadows
- **Sm**: 0 8px 20px rgba(132, 111, 155, 0.10)
- **Md**: 0 16px 36px rgba(132, 111, 155, 0.14)
- **Lg**: 0 28px 64px rgba(132, 111, 155, 0.18)
## Shapes
### Rounded
- **None**: `0px`
- **Sm**: `10px`
- **Md**: `18px`
- **Lg**: `28px`
- **Xl**: `38px`
- **Full**: `9999px`
### Surfaces
- **Treatment**: paper
- **Card Style**: paper-white translucent cards with watercolor bloom backings, vellum top glows, and soft inset cutout windows that mimic boutique packaging inserts
- **Bg Pattern**: wash clouds, ruled packaging lines, dotted confection specks
### Borders
- **Default Width**: 1.5px
- **Accent Width**: 2.5px
- **Style**: solid
- **Character**: plum-ink borders are light but deliberate, often paired with dashed micro separators and attached label seams so sections feel packaged rather than simply boxed
## Components
### Composition
Compose the screen like a premium Japanese gift package opened on a desk: one dominant specimen module, one supporting detail stack, and one lower shelf of neatly grouped assortments. Decorative elements should sit at the edges of these structures, not float independently. Watercolor fields may extend beyond the framed content, but the content itself must snap to package geometry with consistent baselines, rail alignments, and measured outer margins.
### Hierarchy
Lead with one framed specimen window and rounded display heading, then use slim label strips, mono metadata, and soft value chips to organize everything else. Contrast should come from cream-versus-wash layering, size changes, and border emphasis rather than hard black fills. Actions should appear as petite seals, tabs, or capsule buttons. Supporting data should be arranged in tidy value pairs or shelf rows, never in noisy dashboard scatter.
### Density
Low-to-medium density with generous outer air and tighter inner packets. Each cluster should feel collectible and deliberate, allowing micro-detail without losing calm.
### Signature Patterns
- every major panel gets a watercolor bloom backdrop through blurred radial-gradient pseudo-elements so the package frame appears to rest on absorbed pigment
- label rails attach to the top or side edge of cards as capsules or strips carrying mono microcopy, SKU text, and dashed rule dividers
- specimen windows use inset rounded rectangles with inner translucent borders, paper overlays, and soft shadows to mimic retail package cutouts
- mini mascot medallions or icon stamps sit at strategic corners with imperfect outlines and tiny drop shadows, always smaller than adjacent text blocks
- strict grid shelves are softened by confection micro-details like barcode ticks, sprinkle dots, and tiny seals placed inside alignment systems rather than outside 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-019d9bb9-f27d-7600-9cdf-e09c86ec0075/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 Build sections from specimen windows, label rails, and shelf-like rows before adding decorative motifs.
- Do Use overlapping pastel washes with softened feathered edges instead of flat opaque rectangles.
- Do Keep mascots and icons miniature, corner-based, and subordinate to content.
- Do Pair rounded Japanese-friendly headings with mono microcopy for packaging contrast.
- Do Style actions as seals, stickers, tabs, or capsules that feel physically attached to the card.
- Do Use dashed dividers, barcode ticks, and neat quantity chips to make sweetness feel curated.
- Don't Do not use neon hues, harsh black outlines, or arcade-pop visual aggression.
- Don't Do not enlarge mascots into hero illustrations that compete with the main information.
- Don't Do not replace pigment bloom with generic glassmorphism or flat SaaS cards.
- Don't Do not scatter bows, cherries, and icons randomly outside the grid system.
- Don't Do not rely on browser-default inputs or severe corporate typography.
- Don't Do not turn the page into a scrapbook collage with many equal competing panels.
shadcn/ui theme
```json
{
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
"name": "kawaii-watercolor-packaging",
"type": "registry:theme",
"title": "Kawaii Watercolor Packaging shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#FFF9F5",
"foreground": "#5E5469",
"card": "#FFFDFC",
"card-foreground": "#5E5469",
"popover": "#FFFDFC",
"popover-foreground": "#5E5469",
"primary": "#F4B6C8",
"primary-foreground": "#111111",
"secondary": "#BFE9DD",
"secondary-foreground": "#111111",
"muted": "#8D8398",
"muted-foreground": "#5E5469",
"accent": "#CDBDF7",
"accent-foreground": "#111111",
"destructive": "#E78CA8",
"border": "#8E7AA8",
"input": "#8E7AA8",
"ring": "#CDBDF7",
"chart-1": "#F4B6C8",
"chart-2": "#BFE9DD",
"chart-3": "#CDBDF7",
"chart-4": "#8BC9AE",
"chart-5": "#F2C97D",
"sidebar": "#FFFDFC",
"sidebar-foreground": "#5E5469",
"sidebar-primary": "#F4B6C8",
"sidebar-primary-foreground": "#111111",
"sidebar-accent": "#9EC7F3",
"sidebar-accent-foreground": "#111111",
"sidebar-border": "#8E7AA8",
"sidebar-ring": "#CDBDF7",
"radius": "18px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#F4B6C8",
"primary-foreground": "#111111",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#CDBDF7",
"accent-foreground": "#111111",
"destructive": "#E78CA8",
"border": "#303642",
"input": "#303642",
"ring": "#CDBDF7",
"chart-1": "#F4B6C8",
"chart-2": "#BFE9DD",
"chart-3": "#CDBDF7",
"chart-4": "#8BC9AE",
"chart-5": "#F2C97D",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#F4B6C8",
"sidebar-primary-foreground": "#111111",
"sidebar-accent": "#CDBDF7",
"sidebar-accent-foreground": "#111111",
"sidebar-border": "#303642",
"sidebar-ring": "#CDBDF7",
"radius": "18px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019d9bb9-f27d-7600-9cdf-e09c86ec0075",
"slug": "kawaii-watercolor-packaging",
"componentManifest": [
"button",
"card",
"input",
"textarea",
"select",
"dialog",
"sheet",
"tabs",
"badge",
"separator",
"checkbox",
"switch",
"slider",
"tooltip",
"dropdown-menu",
"table"
],
"installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
"nativeTokenNames": {
"colors": [
"accent",
"background",
"border",
"butter",
"cream",
"error",
"info",
"lavender_wash",
"lilac_mist",
"mint_haze",
"mint_milk",
"muted",
"paper_white",
"plum_ink",
"primary",
"rose_water",
"secondary",
"shadow_tint",
"sorbet",
"success",
"surface",
"text",
"warning"
],
"typography": [
"base_size",
"body_font",
"google_fonts_url",
"heading_font",
"letter_spacing",
"line_height",
"mono_font",
"scale_ratio",
"weights"
],
"spacing": [
"base",
"scale"
],
"radii": [
"full",
"lg",
"md",
"none",
"sm",
"xl"
],
"shadows": [
"lg",
"md",
"sm"
],
"surfaces": [
"bg_pattern",
"card_style",
"treatment"
],
"borders": [
"accent_width",
"character",
"default_width",
"style"
],
"motion": [
"duration",
"easing",
"philosophy"
]
}
}
}
```in the wild
embodiments
the full element showcase
embodiment · kawaii-watercolor-packaging
DESIGN.md
at a glance
Typography
headline-lgM PLUS Rounded 1c · 28px · 700
The quick brown fox jumps
headline-mdM PLUS Rounded 1c · 23px · 600
The quick brown fox jumps
body-mdZen Maru Gothic · 16px · 400
The quick brown fox jumps
label-mdIBM Plex Mono · 12px · 600
The quick brown fox jumps
Components
New
Card title
Components rendered with this language’s tokens — colors, type, and rounded corners as specified.
Spacing
- base8px
- xs4px
- sm8px
- md12px
- lg16px
- xl20px
- 2xl24px
- 3xl32px
- 4xl40px
- step-848px
- step-964px
- step-1088px
Shape
none0px
sm10px
md18px
lg28px
xl38px
full9999px
shadcn/ui
implementation kit
recommendedcompatibility fallback
DESIGN.md with shadcn
Copy this when the target app uses shadcn/ui. It packages the Katagami DESIGN.md context with the install list, theme variables, component recipes, preview-shot contract, and starter TSX in one Markdown companion.
advanced implementation filesoptional machine-readable theme, CSS, TSX starter, recipes, and preview contract
shadcn add
npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu tabletheme css
:root {
--background: #FFF9F5;
--foreground: #5E5469;
--card: #FFFDFC;
--card-foreground: #5E5469;
--popover: #FFFDFC;
--popover-foreground: #5E5469;
--primary: #F4B6C8;
--primary-foreground: #111111;
--secondary: #BFE9DD;
--secondary-foreground: #111111;
--muted: #8D8398;
--muted-foreground: #5E5469;
--accent: #CDBDF7;
--accent-foreground: #111111;
--destructive: #E78CA8;
--border: #8E7AA8;
--input: #8E7AA8;
--ring: #CDBDF7;
--chart-1: #F4B6C8;
--chart-2: #BFE9DD;
--chart-3: #CDBDF7;
--chart-4: #8BC9AE;
--chart-5: #F2C97D;
--sidebar: #FFFDFC;
--sidebar-foreground: #5E5469;
--sidebar-primary: #F4B6C8;
--sidebar-primary-foreground: #111111;
--sidebar-accent: #9EC7F3;
--sidebar-accent-foreground: #111111;
--sidebar-border: #8E7AA8;
--sidebar-ring: #CDBDF7;
--radius: 18px;
}
.dark {
--background: #0f1115;
--foreground: #f8fafc;
--card: #181b22;
--card-foreground: #f8fafc;
--popover: #181b22;
--popover-foreground: #f8fafc;
--primary: #F4B6C8;
--primary-foreground: #111111;
--secondary: #252a33;
--secondary-foreground: #f8fafc;
--muted: #252a33;
--muted-foreground: #a1a1aa;
--accent: #CDBDF7;
--accent-foreground: #111111;
--destructive: #E78CA8;
--border: #303642;
--input: #303642;
--ring: #CDBDF7;
--chart-1: #F4B6C8;
--chart-2: #BFE9DD;
--chart-3: #CDBDF7;
--chart-4: #8BC9AE;
--chart-5: #F2C97D;
--sidebar: #181b22;
--sidebar-foreground: #f8fafc;
--sidebar-primary: #F4B6C8;
--sidebar-primary-foreground: #111111;
--sidebar-accent: #CDBDF7;
--sidebar-accent-foreground: #111111;
--sidebar-border: #303642;
--sidebar-ring: #CDBDF7;
--radius: 18px;
}
tsx starter
import { Badge } from "@/components/ui/badge";
import { Button } from "@/components/ui/button";
import {
Card,
CardContent,
CardDescription,
CardFooter,
CardHeader,
CardTitle,
} from "@/components/ui/card";
import { Input } from "@/components/ui/input";
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs";
export function KawaiiWatercolorPackagingShadcnKit() {
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">Kawaii Watercolor Packaging</h2>
<p className="mt-1 max-w-xl text-sm text-muted-foreground">
Use the Katagami registry theme, then compose these shadcn primitives
with the language-specific component recipes.
</p>
</div>
<Button>Apply theme</Button>
</div>
<Tabs defaultValue="components">
<TabsList>
<TabsTrigger value="components">Components</TabsTrigger>
<TabsTrigger value="states">States</TabsTrigger>
<TabsTrigger value="export">Export</TabsTrigger>
</TabsList>
</Tabs>
<Card>
<CardHeader>
<CardTitle>Component recipe</CardTitle>
<CardDescription>
Replace this starter content with the agent-authored product scene
from components.md and preview-shots.json.
</CardDescription>
</CardHeader>
<CardContent className="grid gap-3 sm:grid-cols-[1fr_auto]">
<Input defaultValue="Tokenized shadcn surface" aria-label="Recipe name" />
<Button variant="secondary">Preview state</Button>
</CardContent>
<CardFooter className="justify-between">
<Badge>Ready</Badge>
<Button variant="outline">Copy recipe</Button>
</CardFooter>
</Card>
</section>
);
}
theme JSONcompatibility fallback
{
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
"name": "kawaii-watercolor-packaging",
"type": "registry:theme",
"title": "Kawaii Watercolor Packaging shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#FFF9F5",
"foreground": "#5E5469",
"card": "#FFFDFC",
"card-foreground": "#5E5469",
"popover": "#FFFDFC",
"popover-foreground": "#5E5469",
"primary": "#F4B6C8",
"primary-foreground": "#111111",
"secondary": "#BFE9DD",
"secondary-foreground": "#111111",
"muted": "#8D8398",
"muted-foreground": "#5E5469",
"accent": "#CDBDF7",
"accent-foreground": "#111111",
"destructive": "#E78CA8",
"border": "#8E7AA8",
"input": "#8E7AA8",
"ring": "#CDBDF7",
"chart-1": "#F4B6C8",
"chart-2": "#BFE9DD",
"chart-3": "#CDBDF7",
"chart-4": "#8BC9AE",
"chart-5": "#F2C97D",
"sidebar": "#FFFDFC",
"sidebar-foreground": "#5E5469",
"sidebar-primary": "#F4B6C8",
"sidebar-primary-foreground": "#111111",
"sidebar-accent": "#9EC7F3",
"sidebar-accent-foreground": "#111111",
"sidebar-border": "#8E7AA8",
"sidebar-ring": "#CDBDF7",
"radius": "18px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#F4B6C8",
"primary-foreground": "#111111",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#CDBDF7",
"accent-foreground": "#111111",
"destructive": "#E78CA8",
"border": "#303642",
"input": "#303642",
"ring": "#CDBDF7",
"chart-1": "#F4B6C8",
"chart-2": "#BFE9DD",
"chart-3": "#CDBDF7",
"chart-4": "#8BC9AE",
"chart-5": "#F2C97D",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#F4B6C8",
"sidebar-primary-foreground": "#111111",
"sidebar-accent": "#CDBDF7",
"sidebar-accent-foreground": "#111111",
"sidebar-border": "#303642",
"sidebar-ring": "#CDBDF7",
"radius": "18px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019d9bb9-f27d-7600-9cdf-e09c86ec0075",
"slug": "kawaii-watercolor-packaging",
"componentManifest": [
"button",
"card",
"input",
"textarea",
"select",
"dialog",
"sheet",
"tabs",
"badge",
"separator",
"checkbox",
"switch",
"slider",
"tooltip",
"dropdown-menu",
"table"
],
"installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
"nativeTokenNames": {
"colors": [
"accent",
"background",
"border",
"butter",
"cream",
"error",
"info",
"lavender_wash",
"lilac_mist",
"mint_haze",
"mint_milk",
"muted",
"paper_white",
"plum_ink",
"primary",
"rose_water",
"secondary",
"shadow_tint",
"sorbet",
"success",
"surface",
"text",
"warning"
],
"typography": [
"base_size",
"body_font",
"google_fonts_url",
"heading_font",
"letter_spacing",
"line_height",
"mono_font",
"scale_ratio",
"weights"
],
"spacing": [
"base",
"scale"
],
"radii": [
"full",
"lg",
"md",
"none",
"sm",
"xl"
],
"shadows": [
"lg",
"md",
"sm"
],
"surfaces": [
"bg_pattern",
"card_style",
"treatment"
],
"borders": [
"accent_width",
"character",
"default_width",
"style"
],
"motion": [
"duration",
"easing",
"philosophy"
]
}
}
}
component recipescompatibility fallback
# Kawaii Watercolor Packaging shadcn/ui Components
Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `en-019d9bb9-f27d-7600-9cdf-e09c86ec0075`
Slug: `kawaii-watercolor-packaging`
## Intent
Kawaii Watercolor Packaging translates lessons from Japanese character goods, confection packaging, boutique skincare cartons, and watercolor paper craft into a UI language for soft-commerce and personal product experiences. Research into kawaii visual culture emphasizes friendliness through rounded forms, miniaturization, and approachable mascots; Japanese stationery and gift packaging contribute disciplined label zones, specimen windows, and neat shelf alignment; watercolor references contribute feathered edges, pigment bloom, and absorbent-paper softness. The resulting system is not childish collage and not flat luxury minimalism. It creates a curated package-flatlay feeling where airy washes sit underneath precise package geometry, tiny mascots act like collectible companions, and every action feels as if it were tucked into a seal, tag, or label strip. Interfaces using this language should feel giftable, delicate, emotionally clean, and commercially credible at the same time.
## 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:
{
"primary": "#F4B6C8",
"secondary": "#BFE9DD",
"accent": "#CDBDF7",
"background": "#FFF9F5",
"surface": "#FFFDFC",
"text": "#5E5469",
"muted": "#8D8398",
"border": "#8E7AA8",
"error": "#E78CA8",
"success": "#8BC9AE",
"warning": "#F2C97D",
"info": "#9EC7F3",
"cream": "#FFF4E8",
"butter": "#F9EDB8",
"sorbet": "#FFD7DF",
"mint_milk": "#DDF5EE",
"lilac_mist": "#E9E0FA",
"plum_ink": "#6F5D84",
"rose_water": "#FCE5EC",
"mint_haze": "#EAF8F2",
"lavender_wash": "#F0EBFB",
"paper_white": "#FFFEFD",
"shadow_tint": "#D9D0E6"
}
Typography:
{
"heading_font": "'M PLUS Rounded 1c', 'Hiragino Maru Gothic ProN', sans-serif",
"body_font": "'Zen Maru Gothic', 'Hiragino Kaku Gothic ProN', sans-serif",
"mono_font": "'IBM Plex Mono', monospace",
"base_size": "16px",
"scale_ratio": 1.2,
"line_height": 1.58,
"letter_spacing": "0.01em",
"weights": {
"regular": 400,
"medium": 500,
"semibold": 600,
"bold": 700
},
"google_fonts_url": "https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500&family=M+PLUS+Rounded+1c:wght@500;700;800&family=Zen+Maru+Gothic:wght@400;500;700&display=swap"
}
## Visual character to preserve
- paper-white and cream panels sit over translucent watercolor washes created with blurred radial gradients so every section feels placed on painted paper
- small mascots, cherries, bows, and object icons appear only as corner medallions, stamps, or tiny badges with soft irregular outlines and never as giant illustrations
- rounded specimen windows use inner translucent borders, vellum overlays, and precise package-style framing to mimic product cutouts on Japanese retail boxes
- slim label rails and capsule tabs attach to card edges with mono microcopy, SKU notation, dashed dividers, and barcode-like ticks for packaging precision
- the palette stays in blush pink, mint milk, lilac mist, butter cream, and plum ink, with one darker outline color keeping pastel softness from dissolving into haze
## ShadSync visual profile
{
"family": "paper-collage",
"material": "paper",
"contour": "blob",
"border": "dashed",
"underlay": false,
"grain": true,
"stickerBadges": true,
"motion": "lift",
"density": "balanced",
"accents": [
"primary",
"accent",
"secondary",
"muted"
]
}
## Signature component recipes
### Button
Use `Button` for primary, secondary, outline, and ghost actions. Primary actions must expose the language's strongest contrast pair, while secondary and ghost actions should preserve the surface treatment instead of falling back to default neutral SaaS styling.
### Card
Use `Card`, `CardHeader`, `CardContent`, `CardFooter`, and `CardAction` as the main composition frame. Cards should demonstrate the language's surface, border, hierarchy, and density rules rather than appearing as generic rounded rectangles.
### Input and Textarea
Use `Input` and `Textarea` with visible focus rings, field labels, validation states, and the language's rhythm. Forms should show real product content, not placeholder-only controls.
### Select, Tabs, and Table
Use `Select`, `Tabs`, and `Table` to prove navigation, filtering, and dense data states. The table should show row rhythm, separators, hover/focus states, and an empty or status state when the language calls for it.
### Dialog and Sheet
Use `Dialog` for centered decisions and `Sheet` for contextual editing. Both should inherit the language's spacing, border, overlay, and motion rules.
## Preview shots
- `application-shell`: dashboard or workspace shell with navigation, cards, forms, and state badges.
- `detail-editor`: focused editing flow using input, textarea, select, switch/checkbox, dialog or sheet, and action buttons.
- `data-operations`: table-heavy operational view with tabs, dropdown menu affordances, badges, and destructive/empty states.
- Each preview shot must include a renderable `scene` payload with concrete headline, description, actions, and rows/fields/stats for the UI preview.
## Implementation contract
- Start from local `ui/src/components/ui` shadcn-style primitives; do not create a second component system.
- Apply `/katagami/shadcn/kawaii-watercolor-packaging/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: Build sections from specimen windows, label rails, and shelf-like rows before adding decorative motifs.; Use overlapping pastel washes with softened feathered edges instead of flat opaque rectangles.; Keep mascots and icons miniature, corner-based, and subordinate to content.; Pair rounded Japanese-friendly headings with mono microcopy for packaging contrast.; Style actions as seals, stickers, tabs, or capsules that feel physically attached to the card.; Use dashed dividers, barcode ticks, and neat quantity chips to make sweetness feel curated.
- Do not: Do not use neon hues, harsh black outlines, or arcade-pop visual aggression.; Do not enlarge mascots into hero illustrations that compete with the main information.; Do not replace pigment bloom with generic glassmorphism or flat SaaS cards.; Do not scatter bows, cherries, and icons randomly outside the grid system.; Do not rely on browser-default inputs or severe corporate typography.; Do not turn the page into a scrapbook collage with many equal competing panels.
## 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 KawaiiWatercolorPackagingShadcnKit() {
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">Kawaii Watercolor Packaging</h2>
<p className="mt-1 max-w-xl text-sm text-muted-foreground">
Use the Katagami registry theme, then compose these shadcn primitives
with the language-specific component recipes.
</p>
</div>
<Button>Apply theme</Button>
</div>
<Tabs defaultValue="components">
<TabsList>
<TabsTrigger value="components">Components</TabsTrigger>
<TabsTrigger value="states">States</TabsTrigger>
<TabsTrigger value="export">Export</TabsTrigger>
</TabsList>
</Tabs>
<Card>
<CardHeader>
<CardTitle>Component recipe</CardTitle>
<CardDescription>
Replace this starter content with the agent-authored product scene
from components.md and preview-shots.json.
</CardDescription>
</CardHeader>
<CardContent className="grid gap-3 sm:grid-cols-[1fr_auto]">
<Input defaultValue="Tokenized shadcn surface" aria-label="Recipe name" />
<Button variant="secondary">Preview state</Button>
</CardContent>
<CardFooter className="justify-between">
<Badge>Ready</Badge>
<Button variant="outline">Copy recipe</Button>
</CardFooter>
</Card>
</section>
);
}
```
## Layout notes
{
"grid": "Use a 12-column desktop packaging grid within a 1280px max width, 24px gutters, and 32px page margins. The first row typically splits 7/5 or 8/4 so a large specimen module dominates while a secondary stack supports it. Lower shelves can subdivide into two or three columns, but internal elements should still align to a clear baseline and label-rail logic.",
"breakpoints": "Desktop: 1280px and above. Tablet: 820px to 1279px with an 8-column grid and reduced gutters. Mobile: 0px to 819px with a 4-column grid, full-width stacked specimen modules, and preserved corner-mascot and label-rail behavior.",
"whitespace": "Whitespace should feel like the cream margin around a wrapped confection box: generous around primary modules, tighter inside chips and metadata shelves, and never so compressed that watercolor atmosphere disappears.",
"density": "Aim for medium-light density suitable for boutique commerce, giftable dashboards, and curated product management views."
}
preview shotscompatibility fallback
{
"artifact": "katagami:shadcn-preview-shots",
"version": "preview-shots-v1",
"generator": "katagami-ui-compatibility-projection",
"generatedBy": "katagami-ui-projection",
"requiresVisualProfile": true,
"schema": "katagami:shadcn-preview-shots/renderable-v1",
"renderable": true,
"language": {
"id": "en-019d9bb9-f27d-7600-9cdf-e09c86ec0075",
"name": "Kawaii Watercolor Packaging",
"slug": "kawaii-watercolor-packaging"
},
"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": [
"paper-white and cream panels sit over translucent watercolor washes created with blurred radial gradients so every section feels placed on painted paper",
"small mascots, cherries, bows, and object icons appear only as corner medallions, stamps, or tiny badges with soft irregular outlines and never as giant illustrations",
"rounded specimen windows use inner translucent borders, vellum overlays, and precise package-style framing to mimic product cutouts on Japanese retail boxes",
"slim label rails and capsule tabs attach to card edges with mono microcopy, SKU notation, dashed dividers, and barcode-like ticks for packaging precision",
"the palette stays in blush pink, mint milk, lilac mist, butter cream, and plum ink, with one darker outline color keeping pastel softness from dissolving into haze"
],
"visualProfile": {
"family": "paper-collage",
"material": "paper",
"contour": "blob",
"border": "dashed",
"underlay": false,
"grain": true,
"stickerBadges": true,
"motion": "still",
"density": "balanced",
"accents": [
"primary",
"accent",
"secondary",
"muted"
]
},
"shots": [
{
"id": "application-shell",
"title": "Application shell",
"viewport": "desktop",
"primitives": [
"button",
"card",
"input",
"select",
"tabs",
"badge",
"separator",
"table"
],
"composition": "A real product workspace with navigation, summary cards, filtering controls, and one dense content region.",
"mustShow": [
"primary and secondary actions",
"card hierarchy",
"filterable state",
"table or list density"
],
"avoid": [
"component inventory walls",
"placeholder-only content",
"generic rounded SaaS chrome"
],
"scene": {
"eyebrow": "workspace spread",
"headline": "Kawaii Watercolor Packaging 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": [
"Build sections from specimen windows, label rails, and shelf-like rows before adding decorative motifs.",
"Use overlapping pastel washes with softened feathered edges instead of flat opaque rectangles.",
"Keep mascots and icons miniature, corner-based, and subordinate to content.",
"Pair rounded Japanese-friendly headings with mono microcopy for packaging contrast.",
"Style actions as seals, stickers, tabs, or capsules that feel physically attached to the card.",
"Use dashed dividers, barcode ticks, and neat quantity chips to make sweetness feel curated."
],
"dont": [
"Do not use neon hues, harsh black outlines, or arcade-pop visual aggression.",
"Do not enlarge mascots into hero illustrations that compete with the main information.",
"Do not replace pigment bloom with generic glassmorphism or flat SaaS cards.",
"Do not scatter bows, cherries, and icons randomly outside the grid system.",
"Do not rely on browser-default inputs or severe corporate typography.",
"Do not turn the page into a scrapbook collage with many equal competing panels."
]
}
}
related
More like this
Kawaii Organizershares kawaii-stickers · tokyo-signage · bright-popMemphis Postmodern Graphics UIshares kawaii-stickers · tokyo-signage · bright-popNeo-Kawaii Techshares kawaii-stickers · tokyo-signage · bright-popShibuya Sign-Density Popshares kawaii-stickers · tokyo-signage · bright-popSuperflat Pop Graphicsshares kawaii-stickers · tokyo-signage · bright-popTokyo Indie Zine Illustrationshares kawaii-stickers · tokyo-signage · bright-pop