Luminous Tidal Signal
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
- soft silver structural outlines with occasional electric-blue inner rails and oxidized-copper micro seams
- default width
- 1px
- style
- solid
colors12 items
motion3 items
- duration
- 180ms
- easing
- cubic-bezier(0.2, 0.8, 0.2, 1)
- philosophy
- quiet signal motion: small lift, glow sharpening, and rail expansion only on meaningful focus or state changes
radii5 items
- full
- 9999px
- lg
- 30px
- md
- 18px
- none
- 0
- sm
- 10px
shadows3 items
- lg
- 0 30px 90px rgba(18,109,255,0.16), 0 18px 42px rgba(22,126,130,0.18)
- md
- 0 18px 44px rgba(25,29,33,0.12), 0 0 0 1px rgba(255,255,255,0.62) inset
- sm
- 0 1px 0 rgba(25,29,33,0.08), 0 10px 24px rgba(22,126,130,0.08)
spacing2 items
- base
- 8px
- scale
- 4, 8, 12, 16, 24, 32, 48, 64
surfaces3 items
- bg pattern
- oversized radial light pools in transformative teal and digital lavender, plus sparse monoline contour arcs
- card style
- rounded panels with 1px silver border, inset electric-blue rail, and restrained colored data chips
- treatment
- chalk-white translucent surfaces over teal/lavender atmospheric fields with soft silver borders
typography8 items
- base size
- 16px
- body font
- Afacad Flux
- google fonts url
- https://fonts.googleapis.com/css2?family=Afacad+Flux:wght@400;500;600;700&family=Bricolage+Grotesque:wght@500;600;700;800&family=Fragment+Mono&display=swap
- heading font
- Bricolage Grotesque
- letter spacing
- -0.015em
- line height
- 1.52
- mono font
- Fragment Mono
- scale ratio
- 1.22
rules
Build screens like a color-forecast studio control surface: one dominant narrative panel, adjacent material-swatch cards, compact status modules, and a grounded bottom layer of product/textile data. Avoid three equal cards and avoid center-stacked hero clichés.
Balanced editorial density with generous gutters, readable product data, and at least one calm open atmospheric zone; never crowd the palette into a rainbow wall.
Headlines are large, condensed-grotesque, and graphite; labels and numeric readouts use mono or tight body text. Electric blue marks the active decision, teal carries primary areas, lavender creates ambient depth, and warm colors are reserved for human notes or trend emphasis.
layout
mobile 375px, tablet 768px, desktop 1200px and above
Responsive 12-column desktop grid with one 5-7 column hero split, collapsing to 6 columns on tablet and one column on mobile while preserving feature-first order.
Use 24-32px internal card padding and 16-24px gutters; leave atmospheric negative space around the largest teal/lavender field so accents remain controlled.
guidance
- Lead with transformative teal and digital lavender, then sharpen only active states with electric blue.
- Use oat, chalk, graphite, cocoa, clay, and soft silver as the material ground for fashion, interiors, branding, textile, and product examples.
- Make palette cards specific with finish names, material uses, and contrast notes rather than generic color blobs.
- Keep accessibility strong: graphite text on chalk or deep teal, large focus rings, and non-color state labels.
- Do not create neon overload, cyberpunk saturation, or blacklight glow stacks.
- Do not sequence every color at equal size; subordinate warm accents and dark romantic hues to the teal/lavender system.
- Do not use generic pastel gradients, 2010s millennial pink, or muddy low-contrast earthy palettes.
- Do not present the embodiment as a component catalog; it must feel like a real cross-industry palette strategy tool.
katagami spec
# Luminous Tidal Signal ## Philosophy A 2026 soft-futurist color language for brands and product systems that treats transformative teal as an intelligent calm, digital lavender as ambient interface light, and electric blue as a precise signal rather than spectacle. It is built for fashion, interiors, textiles, branding, and contemporary product design where optimism needs craft, ecological intelligence, and high usability. ### Values - Luminous restraint over neon spectacle - Cross-industry palette logic that can move from textile swatch to app chrome - Biophilic intelligence balanced with exact digital signal accents - Warmth from clay, butter, coral, cocoa, and oat neutrals rather than generic pastels - High contrast hierarchy with soft material transitions ### Anti-Values - Oversaturated cyberpunk gradients, blacklight blues, and generic sci-fi glass panels - Flat rainbow sequencing or equal-weight color stripes that make every hue compete - Muddy low-contrast naturalism that buries the teal/lavender/electric signal - 2010s millennial pink softness without structure ### Visual Character - Layered rounded-rectangle panels use a vertical teal-to-chalk atmospheric background, with each card holding a thin inset electric-blue keyline and a soft silver outer border in CSS. - Asymmetric editorial/product grids pair one oversized feature panel with smaller swatch, metric, and material cards, avoiding equal dashboard tiles through CSS grid spans. - Color appears in controlled bands: teal fields, lavender halos, small electric-blue focus rails, butter-yellow data pips, and muted-coral annotation chips rather than full-spectrum gradients. - Surfaces combine translucent chalk-white cards, graphite text blocks, and subtle radial lavender/teal light pools generated by pseudo-elements and background gradients. - Interactive objects use pill radii, monoline borders, and tiny oxidized-copper or mineral-green status seams to suggest future craft without heavy skeuomorphism. ## Tokens ### Borders - **Accent Width**: 2px - **Character**: soft silver structural outlines with occasional electric-blue inner rails and oxidized-copper micro seams - **Default Width**: 1px - **Style**: solid ### Colors | Name | Value | |------|-------| | accent | `#126DFF` | | background | `#F6F4EC` | | border | `#C7CCD0` | | error | `#A74653` | | info | `#6AC7D2` | | muted | `#6B7375` | | primary | `#167E82` | | secondary | `#B8A7FF` | | success | `#4E8A63` | | surface | `#FDFCF7` | | text | `#191D21` | | warning | `#F1C95A` | ### Motion - **Duration**: 180ms - **Easing**: cubic-bezier(0.2, 0.8, 0.2, 1) - **Philosophy**: quiet signal motion: small lift, glow sharpening, and rail expansion only on meaningful focus or state changes ### Radii - **Full**: 9999px - **Lg**: 30px - **Md**: 18px - **None**: 0 - **Sm**: 10px ### Shadows - **Lg**: 0 30px 90px rgba(18,109,255,0.16), 0 18px 42px rgba(22,126,130,0.18) - **Md**: 0 18px 44px rgba(25,29,33,0.12), 0 0 0 1px rgba(255,255,255,0.62) inset - **Sm**: 0 1px 0 rgba(25,29,33,0.08), 0 10px 24px rgba(22,126,130,0.08) ### Spacing - **Base**: 8px - **Scale**: [4,8,12,16,24,32,48,64] ### Surfaces - **Bg Pattern**: oversized radial light pools in transformative teal and digital lavender, plus sparse monoline contour arcs - **Card Style**: rounded panels with 1px silver border, inset electric-blue rail, and restrained colored data chips - **Treatment**: chalk-white translucent surfaces over teal/lavender atmospheric fields with soft silver borders ### Typography - **Base Size**: 16px - **Body Font**: Afacad Flux - **Google Fonts Url**: https://fonts.googleapis.com/css2?family=Afacad+Flux:wght@400;500;600;700&family=Bricolage+Grotesque:wght@500;600;700;800&family=Fragment+Mono&display=swap - **Heading Font**: Bricolage Grotesque - **Letter Spacing**: -0.015em - **Line Height**: 1.52 - **Mono Font**: Fragment Mono - **Scale Ratio**: 1.22 ## Rules ### Composition Build screens like a color-forecast studio control surface: one dominant narrative panel, adjacent material-swatch cards, compact status modules, and a grounded bottom layer of product/textile data. Avoid three equal cards and avoid center-stacked hero clichés. ### Density Balanced editorial density with generous gutters, readable product data, and at least one calm open atmospheric zone; never crowd the palette into a rainbow wall. ### Hierarchy Headlines are large, condensed-grotesque, and graphite; labels and numeric readouts use mono or tight body text. Electric blue marks the active decision, teal carries primary areas, lavender creates ambient depth, and warm colors are reserved for human notes or trend emphasis. ### Signature Patterns - Use CSS radial-gradient light pools behind translucent cards to make digital lavender and transformative teal feel luminous but not neon. - Add an inset left or top electric-blue rail on selected panels and controls, never more than two active rails per viewport. - Compose palette intelligence as physical swatch chips with material labels, tiny confidence meters, and warm annotation pills in butter or muted coral. - Use monoline contour arcs and soft-silver rule lines as background structure so the language reads as future-facing product design rather than generic SaaS. - Pair cool future colors with one grounded clay/cocoa/oat section per screen to keep the system cross-industry and tactile. ## Layout ### Breakpoints mobile 375px, tablet 768px, desktop 1200px and above ### Grid Responsive 12-column desktop grid with one 5-7 column hero split, collapsing to 6 columns on tablet and one column on mobile while preserving feature-first order. ### Whitespace Use 24-32px internal card padding and 16-24px gutters; leave atmospheric negative space around the largest teal/lavender field so accents remain controlled. ## Guidance ### Do - Lead with transformative teal and digital lavender, then sharpen only active states with electric blue. - Use oat, chalk, graphite, cocoa, clay, and soft silver as the material ground for fashion, interiors, branding, textile, and product examples. - Make palette cards specific with finish names, material uses, and contrast notes rather than generic color blobs. - Keep accessibility strong: graphite text on chalk or deep teal, large focus rings, and non-color state labels. ### Don't - Do not create neon overload, cyberpunk saturation, or blacklight glow stacks. - Do not sequence every color at equal size; subordinate warm accents and dark romantic hues to the teal/lavender system. - Do not use generic pastel gradients, 2010s millennial pink, or muddy low-contrast earthy palettes. - Do not present the embodiment as a component catalog; it must feel like a real cross-industry palette strategy tool. ### Usage Context Best for 2026 color strategy, future-facing consumer products, fashion palette planning, interior material systems, regenerative brand identities, textile launches, and luminous editorial-commerce tools.
DESIGN.md
---
version: "alpha"
name: "Luminous Tidal Signal"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
accent: "#126DFF"
background: "#F6F4EC"
border: "#C7CCD0"
error: "#A74653"
info: "#6AC7D2"
muted: "#6B7375"
primary: "#167E82"
secondary: "#B8A7FF"
success: "#4E8A63"
surface: "#FDFCF7"
text: "#191D21"
warning: "#F1C95A"
typography:
headline-lg:
fontFamily: "Bricolage Grotesque"
fontSize: "1.816rem"
fontWeight: 700
lineHeight: 1.1
letterSpacing: "-0.015em"
headline-md:
fontFamily: "Bricolage Grotesque"
fontSize: "1.488rem"
fontWeight: 600
lineHeight: 1.15
letterSpacing: "-0.015em"
body-md:
fontFamily: "Afacad Flux"
fontSize: "16px"
fontWeight: 400
lineHeight: 1.52
letterSpacing: "-0.015em"
label-md:
fontFamily: "Fragment Mono"
fontSize: "0.75rem"
fontWeight: 600
lineHeight: 1
letterSpacing: "0.08em"
rounded:
full: "9999px"
lg: "30px"
md: "18px"
none: "0px"
sm: "10px"
spacing:
base: "8px"
xs: "4px"
sm: "8px"
md: "12px"
lg: "16px"
xl: "24px"
2xl: "32px"
3xl: "48px"
4xl: "64px"
components:
color-reference-accent:
backgroundColor: "{colors.accent}"
color-reference-background:
backgroundColor: "{colors.background}"
color-reference-border:
backgroundColor: "{colors.border}"
color-reference-error:
backgroundColor: "{colors.error}"
color-reference-info:
backgroundColor: "{colors.info}"
color-reference-muted:
backgroundColor: "{colors.muted}"
color-reference-primary:
backgroundColor: "{colors.primary}"
color-reference-secondary:
backgroundColor: "{colors.secondary}"
color-reference-success:
backgroundColor: "{colors.success}"
color-reference-surface:
backgroundColor: "{colors.surface}"
color-reference-text:
backgroundColor: "{colors.text}"
color-reference-warning:
backgroundColor: "{colors.warning}"
button-primary:
backgroundColor: "{colors.primary}"
textColor: "#ffffff"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
card-surface:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
input-default:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.md}"
height: "44px"
---
# Luminous Tidal Signal
## Overview
A 2026 soft-futurist color language for brands and product systems that treats transformative teal as an intelligent calm, digital lavender as ambient interface light, and electric blue as a precise signal rather than spectacle. It is built for fashion, interiors, textiles, branding, and contemporary product design where optimism needs craft, ecological intelligence, and high usability.
### Values
- Luminous restraint over neon spectacle
- Cross-industry palette logic that can move from textile swatch to app chrome
- Biophilic intelligence balanced with exact digital signal accents
- Warmth from clay, butter, coral, cocoa, and oat neutrals rather than generic pastels
- High contrast hierarchy with soft material transitions
### Anti-Values
- Oversaturated cyberpunk gradients, blacklight blues, and generic sci-fi glass panels
- Flat rainbow sequencing or equal-weight color stripes that make every hue compete
- Muddy low-contrast naturalism that buries the teal/lavender/electric signal
- 2010s millennial pink softness without structure
### Visual Character
- Layered rounded-rectangle panels use a vertical teal-to-chalk atmospheric background, with each card holding a thin inset electric-blue keyline and a soft silver outer border in CSS.
- Asymmetric editorial/product grids pair one oversized feature panel with smaller swatch, metric, and material cards, avoiding equal dashboard tiles through CSS grid spans.
- Color appears in controlled bands: teal fields, lavender halos, small electric-blue focus rails, butter-yellow data pips, and muted-coral annotation chips rather than full-spectrum gradients.
- Surfaces combine translucent chalk-white cards, graphite text blocks, and subtle radial lavender/teal light pools generated by pseudo-elements and background gradients.
- Interactive objects use pill radii, monoline borders, and tiny oxidized-copper or mineral-green status seams to suggest future craft without heavy skeuomorphism.
## 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 | `#126DFF` |
| background | `#F6F4EC` |
| border | `#C7CCD0` |
| error | `#A74653` |
| info | `#6AC7D2` |
| muted | `#6B7375` |
| primary | `#167E82` |
| secondary | `#B8A7FF` |
| success | `#4E8A63` |
| surface | `#FDFCF7` |
| text | `#191D21` |
| warning | `#F1C95A` |
## Typography
- **Headline-Lg**: Bricolage Grotesque, 1.816rem, weight 700, line-height 1.1.
- **Headline-Md**: Bricolage Grotesque, 1.488rem, weight 600, line-height 1.15.
- **Body-Md**: Afacad Flux, 16px, weight 400, line-height 1.52.
- **Label-Md**: Fragment Mono, 0.75rem, weight 600, line-height 1.
## Layout
### Spacing Tokens
- **Base**: `8px`
- **Xs**: `4px`
- **Sm**: `8px`
- **Md**: `12px`
- **Lg**: `16px`
- **Xl**: `24px`
- **2xl**: `32px`
- **3xl**: `48px`
- **4xl**: `64px`
### Breakpoints
mobile 375px, tablet 768px, desktop 1200px and above
### Grid
Responsive 12-column desktop grid with one 5-7 column hero split, collapsing to 6 columns on tablet and one column on mobile while preserving feature-first order.
### Whitespace
Use 24-32px internal card padding and 16-24px gutters; leave atmospheric negative space around the largest teal/lavender field so accents remain controlled.
## Elevation & Depth
### Shadows
- **Lg**: 0 30px 90px rgba(18,109,255,0.16), 0 18px 42px rgba(22,126,130,0.18)
- **Md**: 0 18px 44px rgba(25,29,33,0.12), 0 0 0 1px rgba(255,255,255,0.62) inset
- **Sm**: 0 1px 0 rgba(25,29,33,0.08), 0 10px 24px rgba(22,126,130,0.08)
## Shapes
### Rounded
- **Full**: `9999px`
- **Lg**: `30px`
- **Md**: `18px`
- **None**: `0px`
- **Sm**: `10px`
### Surfaces
- **Bg Pattern**: oversized radial light pools in transformative teal and digital lavender, plus sparse monoline contour arcs
- **Card Style**: rounded panels with 1px silver border, inset electric-blue rail, and restrained colored data chips
- **Treatment**: chalk-white translucent surfaces over teal/lavender atmospheric fields with soft silver borders
### Borders
- **Accent Width**: 2px
- **Character**: soft silver structural outlines with occasional electric-blue inner rails and oxidized-copper micro seams
- **Default Width**: 1px
- **Style**: solid
## Components
### Composition
Build screens like a color-forecast studio control surface: one dominant narrative panel, adjacent material-swatch cards, compact status modules, and a grounded bottom layer of product/textile data. Avoid three equal cards and avoid center-stacked hero clichés.
### Density
Balanced editorial density with generous gutters, readable product data, and at least one calm open atmospheric zone; never crowd the palette into a rainbow wall.
### Hierarchy
Headlines are large, condensed-grotesque, and graphite; labels and numeric readouts use mono or tight body text. Electric blue marks the active decision, teal carries primary areas, lavender creates ambient depth, and warm colors are reserved for human notes or trend emphasis.
### Signature Patterns
- Use CSS radial-gradient light pools behind translucent cards to make digital lavender and transformative teal feel luminous but not neon.
- Add an inset left or top electric-blue rail on selected panels and controls, never more than two active rails per viewport.
- Compose palette intelligence as physical swatch chips with material labels, tiny confidence meters, and warm annotation pills in butter or muted coral.
- Use monoline contour arcs and soft-silver rule lines as background structure so the language reads as future-facing product design rather than generic SaaS.
- Pair cool future colors with one grounded clay/cocoa/oat section per screen to keep the system cross-industry and tactile.
## 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-019eb43d-f16f-74f3-be8c-000ce6120e3e/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 Lead with transformative teal and digital lavender, then sharpen only active states with electric blue.
- Do Use oat, chalk, graphite, cocoa, clay, and soft silver as the material ground for fashion, interiors, branding, textile, and product examples.
- Do Make palette cards specific with finish names, material uses, and contrast notes rather than generic color blobs.
- Do Keep accessibility strong: graphite text on chalk or deep teal, large focus rings, and non-color state labels.
- Don't Do not create neon overload, cyberpunk saturation, or blacklight glow stacks.
- Don't Do not sequence every color at equal size; subordinate warm accents and dark romantic hues to the teal/lavender system.
- Don't Do not use generic pastel gradients, 2010s millennial pink, or muddy low-contrast earthy palettes.
- Don't Do not present the embodiment as a component catalog; it must feel like a real cross-industry palette strategy tool.
### Usage Context
Best for 2026 color strategy, future-facing consumer products, fashion palette planning, interior material systems, regenerative brand identities, textile launches, and luminous editorial-commerce tools.
shadcn/ui theme
```json
{
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
"name": "luminous-tidal-signal",
"type": "registry:theme",
"title": "Luminous Tidal Signal shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#F6F4EC",
"foreground": "#191D21",
"card": "#FDFCF7",
"card-foreground": "#191D21",
"popover": "#FDFCF7",
"popover-foreground": "#191D21",
"primary": "#167E82",
"primary-foreground": "#ffffff",
"secondary": "#B8A7FF",
"secondary-foreground": "#ffffff",
"muted": "#6B7375",
"muted-foreground": "#191D21",
"accent": "#126DFF",
"accent-foreground": "#ffffff",
"destructive": "#A74653",
"border": "#C7CCD0",
"input": "#C7CCD0",
"ring": "#126DFF",
"chart-1": "#167E82",
"chart-2": "#B8A7FF",
"chart-3": "#126DFF",
"chart-4": "#4E8A63",
"chart-5": "#F1C95A",
"sidebar": "#FDFCF7",
"sidebar-foreground": "#191D21",
"sidebar-primary": "#167E82",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#6AC7D2",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#C7CCD0",
"sidebar-ring": "#126DFF",
"radius": "18px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#167E82",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#126DFF",
"accent-foreground": "#ffffff",
"destructive": "#A74653",
"border": "#303642",
"input": "#303642",
"ring": "#126DFF",
"chart-1": "#167E82",
"chart-2": "#B8A7FF",
"chart-3": "#126DFF",
"chart-4": "#4E8A63",
"chart-5": "#F1C95A",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#167E82",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#126DFF",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#303642",
"sidebar-ring": "#126DFF",
"radius": "18px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019eb43d-f16f-74f3-be8c-000ce6120e3e",
"slug": "luminous-tidal-signal",
"componentManifest": [
"button",
"card",
"input",
"textarea",
"select",
"dialog",
"sheet",
"tabs",
"badge",
"separator",
"checkbox",
"switch",
"slider",
"tooltip",
"dropdown-menu",
"table"
],
"installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
"nativeTokenNames": {
"borders": [
"accent_width",
"character",
"default_width",
"style"
],
"colors": [
"accent",
"background",
"border",
"error",
"info",
"muted",
"primary",
"secondary",
"success",
"surface",
"text",
"warning"
],
"motion": [
"duration",
"easing",
"philosophy"
],
"radii": [
"full",
"lg",
"md",
"none",
"sm"
],
"shadows": [
"lg",
"md",
"sm"
],
"spacing": [
"base",
"scale"
],
"surfaces": [
"bg_pattern",
"card_style",
"treatment"
],
"typography": [
"base_size",
"body_font",
"google_fonts_url",
"heading_font",
"letter_spacing",
"line_height",
"mono_font",
"scale_ratio"
]
}
}
}
```embodiments
at a glance
Typography
The quick brown fox jumps
The quick brown fox jumps
The quick brown fox jumps
The quick brown fox jumps
Components
Components rendered with this language’s tokens — colors, type, and rounded corners as specified.
Spacing
- base8px
- xs4px
- sm8px
- md12px
- lg16px
- xl24px
- 2xl32px
- 3xl48px
- 4xl64px
Shape
implementation kit
DESIGN.md with shadcn
Copy this when the target app uses shadcn/ui. It packages the Katagami DESIGN.md context with the install list, theme variables, component recipes, preview-shot contract, and starter TSX in one Markdown companion.
advanced implementation filesoptional machine-readable theme, CSS, TSX starter, recipes, and preview contract
npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table:root {
--background: #F6F4EC;
--foreground: #191D21;
--card: #FDFCF7;
--card-foreground: #191D21;
--popover: #FDFCF7;
--popover-foreground: #191D21;
--primary: #167E82;
--primary-foreground: #ffffff;
--secondary: #B8A7FF;
--secondary-foreground: #ffffff;
--muted: #6B7375;
--muted-foreground: #191D21;
--accent: #126DFF;
--accent-foreground: #ffffff;
--destructive: #A74653;
--border: #C7CCD0;
--input: #C7CCD0;
--ring: #126DFF;
--chart-1: #167E82;
--chart-2: #B8A7FF;
--chart-3: #126DFF;
--chart-4: #4E8A63;
--chart-5: #F1C95A;
--sidebar: #FDFCF7;
--sidebar-foreground: #191D21;
--sidebar-primary: #167E82;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #6AC7D2;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #C7CCD0;
--sidebar-ring: #126DFF;
--radius: 18px;
}
.dark {
--background: #0f1115;
--foreground: #f8fafc;
--card: #181b22;
--card-foreground: #f8fafc;
--popover: #181b22;
--popover-foreground: #f8fafc;
--primary: #167E82;
--primary-foreground: #ffffff;
--secondary: #252a33;
--secondary-foreground: #f8fafc;
--muted: #252a33;
--muted-foreground: #a1a1aa;
--accent: #126DFF;
--accent-foreground: #ffffff;
--destructive: #A74653;
--border: #303642;
--input: #303642;
--ring: #126DFF;
--chart-1: #167E82;
--chart-2: #B8A7FF;
--chart-3: #126DFF;
--chart-4: #4E8A63;
--chart-5: #F1C95A;
--sidebar: #181b22;
--sidebar-foreground: #f8fafc;
--sidebar-primary: #167E82;
--sidebar-primary-foreground: #ffffff;
--sidebar-accent: #126DFF;
--sidebar-accent-foreground: #ffffff;
--sidebar-border: #303642;
--sidebar-ring: #126DFF;
--radius: 18px;
}
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 LuminousTidalSignalShadcnKit() {
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">Luminous Tidal Signal</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": "luminous-tidal-signal",
"type": "registry:theme",
"title": "Luminous Tidal Signal shadcn Theme",
"cssVars": {
"theme": {},
"light": {
"background": "#F6F4EC",
"foreground": "#191D21",
"card": "#FDFCF7",
"card-foreground": "#191D21",
"popover": "#FDFCF7",
"popover-foreground": "#191D21",
"primary": "#167E82",
"primary-foreground": "#ffffff",
"secondary": "#B8A7FF",
"secondary-foreground": "#ffffff",
"muted": "#6B7375",
"muted-foreground": "#191D21",
"accent": "#126DFF",
"accent-foreground": "#ffffff",
"destructive": "#A74653",
"border": "#C7CCD0",
"input": "#C7CCD0",
"ring": "#126DFF",
"chart-1": "#167E82",
"chart-2": "#B8A7FF",
"chart-3": "#126DFF",
"chart-4": "#4E8A63",
"chart-5": "#F1C95A",
"sidebar": "#FDFCF7",
"sidebar-foreground": "#191D21",
"sidebar-primary": "#167E82",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#6AC7D2",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#C7CCD0",
"sidebar-ring": "#126DFF",
"radius": "18px"
},
"dark": {
"background": "#0f1115",
"foreground": "#f8fafc",
"card": "#181b22",
"card-foreground": "#f8fafc",
"popover": "#181b22",
"popover-foreground": "#f8fafc",
"primary": "#167E82",
"primary-foreground": "#ffffff",
"secondary": "#252a33",
"secondary-foreground": "#f8fafc",
"muted": "#252a33",
"muted-foreground": "#a1a1aa",
"accent": "#126DFF",
"accent-foreground": "#ffffff",
"destructive": "#A74653",
"border": "#303642",
"input": "#303642",
"ring": "#126DFF",
"chart-1": "#167E82",
"chart-2": "#B8A7FF",
"chart-3": "#126DFF",
"chart-4": "#4E8A63",
"chart-5": "#F1C95A",
"sidebar": "#181b22",
"sidebar-foreground": "#f8fafc",
"sidebar-primary": "#167E82",
"sidebar-primary-foreground": "#ffffff",
"sidebar-accent": "#126DFF",
"sidebar-accent-foreground": "#ffffff",
"sidebar-border": "#303642",
"sidebar-ring": "#126DFF",
"radius": "18px"
}
},
"meta": {
"source": "katagami",
"languageId": "en-019eb43d-f16f-74f3-be8c-000ce6120e3e",
"slug": "luminous-tidal-signal",
"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"
]
}
}
}
# Luminous Tidal Signal shadcn/ui Components
Author: `katagami-agent`
## Intent
Translate the 2026 Soft Futurism + Electric Optimism palette into local shadcn/ui primitives with teal/lavender atmospheric surfaces, soft-silver structure, and restrained electric-blue state rails. Components should feel like a color strategy product for fashion, interiors, branding, textiles, and product design, not a generic dashboard.
## Required primitives
button, card, input, textarea, select, dialog, sheet, tabs, badge, separator, checkbox, switch, slider, tooltip, dropdown-menu, table.
## Token cues
Use `{colors.primary}` as transformative teal fields, `{colors.secondary}` as digital lavender ambient wash, `{colors.accent}` only for focus rails, active tabs, selected rows, and primary button seams. Ground with `{colors.background}`, `{colors.surface}`, `{colors.text}`, `{colors.muted}`, and `{colors.border}`. Use `{spacing.*}` for open editorial gutters and `{rounded.lg}` for cards with `{rounded.full}` for badges.
## Visual character to preserve
- Translucent chalk cards over teal/lavender radial light pools.
- One dominant feature panel plus smaller swatch or operation cards.
- Electric-blue rail only on the active component or row.
- Warm clay, butter, cocoa, muted coral, mineral green, and oxidized copper as annotation or material cues.
- Soft-silver monoline borders and restrained shadows.
## ShadSync visual profile
family: soft-futurist-palette-system; material: luminous-translucent-chalk; contour: rounded-rect-pill; border: soft-silver-with-electric-rail; underlay: teal-lavender-radial-pools; grain: subtle; stickerBadges: restrained-coral-butter; motion: quiet-lift-rail-expand; density: balanced-editorial; accents: controlled-electric-blue.
## Signature component recipes
- button: Primary button uses teal fill, chalk text, pill radius, and a 2px electric-blue inset left rail on hover/focus. Secondary button is chalk translucent with silver border. Destructive uses muted coral, not neon red.
- card: Use rounded-lg containers with 1px silver border, soft translucent surface, optional radial lavender pseudo-underlay, and at most one selected card rail.
- input: Chalk surface, silver outline, graphite text, mono micro-label above, electric-blue focus ring/left seam, placeholder in muted gray.
- textarea: Same as input, with larger padding and a low-opacity lavender focus glow behind the field.
- select: Pill-like trigger, silver border, chevron in teal, active option marked by blue rail and butter dot.
- dialog: Centered chalk panel over teal/lavender wash, thick heading, soft-silver border, and coral/butter badges for warnings or notes.
- sheet: Right sheet uses graphite header band, chalk body, blue vertical rail, and swatch chips for context.
- tabs: Rounded segmented tabs; active tab has electric-blue rail and lavender halo, inactive tabs remain neutral.
- badge: Pill badges in teal, lavender, butter, coral, mineral green, or cocoa; use tiny labels and avoid rainbow rows.
- separator: 1px soft-silver rules; use teal/lavender gradient separator only for major section breaks.
- checkbox: Rounded small square with teal fill and blue focus outline; label includes non-color state text.
- switch: Teal track when on, oat track when off, blue focus ring, chalk thumb.
- slider: Silver rail, teal progress, electric-blue thumb, butter tick for recommended range.
- tooltip: Graphite bubble with chalk text and lavender edge glow.
- dropdown-menu: Chalk translucent menu, silver border, active item blue rail, warm note badges for destructive or pending states.
- table: Rows on chalk surface, selected row has blue rail and pale teal fill; use mono column metadata and swatch dots.
## Preview shots
1. application-shell: palette command center with feature card, swatch metrics, tabs, dropdown menu, and table.
2. detail-editor: material direction editor with inputs, textarea, select, slider, switches, dialog trigger, and badges.
3. data-operations: sourcing table and batch operation sheet with checkbox states, tooltip explanations, separators, and status badges.
## Implementation contract
Import local primitives from `@/components/ui/*`. Do not invent another component system. Preserve semantic HTML, visible focus, WCAG AA contrast, and restrained accent usage. The preview should read as a polished product screen, not a component inventory wall.
## Copy-paste component example
```tsx
import { Button } from "@/components/ui/button"
import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card"
import { Badge } from "@/components/ui/badge"
import { Input } from "@/components/ui/input"
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"
export function TidalSignalPanel() {
return (
<Card className="relative overflow-hidden rounded-[30px] border border-[var(--border)] bg-[var(--card)]/80 shadow-lg before:absolute before:left-0 before:top-6 before:h-24 before:w-[3px] before:rounded-full before:bg-[var(--accent)]">
<CardHeader className="space-y-3">
<Badge className="w-fit rounded-full bg-[#F1C95A] text-[#191D21]">2026 palette intelligence</Badge>
<CardTitle className="font-heading text-4xl tracking-tight">Future color that breathes before it glows.</CardTitle>
</CardHeader>
<CardContent className="grid gap-4">
<Tabs defaultValue="soft-futurism"><TabsList><TabsTrigger value="soft-futurism">Soft Futurism</TabsTrigger><TabsTrigger value="biophilic">Biophilic Luxe</TabsTrigger></TabsList></Tabs>
<Input placeholder="Search material, runway, or product cue" />
<Button className="rounded-full bg-[var(--primary)] text-[var(--primary-foreground)] shadow-md focus-visible:ring-[var(--accent)]">Apply electric signal</Button>
</CardContent>
</Card>
)
}
```
{
"artifact": "katagami:shadcn-preview-shots",
"author": "katagami-agent",
"componentRecipes": [
{
"component": "button",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "card",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "input",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "textarea",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "select",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "dialog",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "sheet",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "tabs",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "badge",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "separator",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "checkbox",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "switch",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "slider",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "tooltip",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "dropdown-menu",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
},
{
"component": "table",
"recipe": "Apply Luminous Tidal Signal tokens with chalk surface, soft silver border, rounded contour, and controlled electric-blue active state."
}
],
"generatedBy": "katagami-agent",
"renderable": true,
"requiresVisualProfile": true,
"schema": "katagami:shadcn-preview-shots/renderable-v1",
"shots": [
{
"avoid": [
"rainbow equal swatch rows",
"neon glow overload",
"generic analytics tiles"
],
"composition": "Dominant teal/lavender feature card beside swatch metrics and a sourcing table; one selected panel carries the blue rail.",
"id": "application-shell",
"mustShowStates": [
"active tab",
"primary action focus",
"selected table row",
"tooltip on confidence score"
],
"primitives": [
"button",
"card",
"tabs",
"badge",
"separator",
"dropdown-menu",
"table",
"tooltip"
],
"scene": {
"actions": [
"Apply signal rail",
"Export textile brief"
],
"description": "A palette strategist compares runway, interior, and product signals without letting electric blue dominate.",
"eyebrow": "2026 cross-industry forecast",
"headline": "Soft Futurism color command",
"rows": [
{
"direction": "Transformative Teal",
"status": "primary",
"use": "product shell"
},
{
"direction": "Digital Lavender",
"status": "support",
"use": "ambient UI layer"
},
{
"direction": "Butter Yellow",
"status": "micro accent",
"use": "optimism marker"
}
],
"stats": [
{
"label": "teal confidence",
"value": "86%"
},
{
"label": "accent cap",
"value": "12%"
},
{
"label": "AA contrast",
"value": "pass"
}
]
},
"title": "Palette intelligence shell"
},
{
"avoid": [
"default browser inputs",
"muddy clay fields",
"pastel gradient wash"
],
"composition": "Chalk editor card with lavender halo, controlled form density, material badges, and a dialog for contrast validation.",
"id": "detail-editor",
"mustShowStates": [
"focused input with blue rail",
"slider recommended tick",
"switch on",
"dialog open preview"
],
"primitives": [
"input",
"textarea",
"select",
"slider",
"switch",
"checkbox",
"dialog",
"badge",
"separator",
"button"
],
"scene": {
"actions": [
"Validate contrast",
"Save material story"
],
"description": "Designers tune product finishes and textile applications with warm grounded notes.",
"eyebrow": "material recipe",
"fields": [
{
"label": "Primary finish",
"value": "soft anodized teal"
},
{
"label": "Accent rule",
"value": "electric blue focus only"
},
{
"label": "Warm counterweight",
"value": "warm clay / cocoa"
}
],
"headline": "Teal body, lavender glass, cocoa grip",
"stats": [
{
"label": "lavender opacity",
"value": "28%"
},
{
"label": "silver border",
"value": "1px"
}
]
},
"title": "Material direction editor"
},
{
"avoid": [
"dense spreadsheet wall",
"cyberpunk dark mode",
"unlabeled color-only statuses"
],
"composition": "Operational table grounded in oat/chalk neutrals with selected rows, side sheet, and restrained coral/butter status pills.",
"id": "data-operations",
"mustShowStates": [
"checked rows",
"open sheet",
"pending badge",
"dropdown select"
],
"primitives": [
"table",
"checkbox",
"sheet",
"select",
"badge",
"separator",
"tooltip",
"button",
"switch"
],
"scene": {
"actions": [
"Open batch sheet",
"Approve selected"
],
"description": "A team batches textile, packaging, and interface color decisions for 2026 market release.",
"eyebrow": "launch readiness",
"headline": "Cross-industry palette rollout",
"rows": [
{
"item": "woven lavender overlay",
"owner": "textile",
"status": "sampling"
},
{
"item": "teal appliance shell",
"owner": "product",
"status": "approved"
},
{
"item": "oat interior laminate",
"owner": "interiors",
"status": "pending"
}
],
"stats": [
{
"label": "selected",
"value": "3"
},
{
"label": "risks",
"value": "1 coral note"
}
]
},
"title": "Sourcing and launch operations"
}
],
"version": "preview-shots-v1",
"visualProfile": {
"accents": "controlled-electric-blue",
"border": "soft-silver-with-electric-rail",
"contour": "rounded-rect-pill",
"density": "balanced-editorial",
"family": "soft-futurist-palette-system",
"grain": "subtle",
"material": "luminous-translucent-chalk",
"motion": "quiet-lift-rail-expand",
"stickerBadges": "restrained-coral-butter",
"underlay": "teal-lavender-radial-pools"
}
}