back to gallery
design language·sequence-porcelain-atlas

Sequence Porcelain Atlas

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
Sequence Porcelain Atlas turns genomic work into a premium evidence atlas: quiet porcelain-white product surfaces, precise coordinate typography, nucleobase chips, and small quantized confidence pixels make DNA feel like inspectable data rather than biotech decoration.
values
Use genomics as operational notation: coordinates, base calls, variant evidence, confidence, and provenance drive the interface grammar.Keep the product calm and high-trust through white/neutral surfaces, exact spacing, restrained outlines, and cool semantic highlights.Let modular pixels appear only as data-bearing confidence cells, sequence ticks, or alignment mismatches rather than decorative retro styling.Make complex biology feel navigable through layered tracks, review queues, and evidence cards instead of textbook diagrams.
anti-values
×No DNA helix wallpaper, molecule sprinkles, chromosome rainbows, lab-dashboard templates, or science textbook illustrations.×No square-grid background, default dotted texture, colored side rails, striped card accents, chipped corners, uneven borders, or retro game skin.×No hospital-blue monotony or rainbow sprawl; color must encode status, base family, focus, or action.
tokens
borders4 items
accent width
2px
character
Cool blue-gray instrument borders; active states use complete indigo or turquoise outlines, never side rails or partial stripes.
default width
1px
style
solid hairline with occasional stepped focus outline
colors12 items
accent
#12AFA8
background
#F7F8F6
border
#DCE3E8
error
#B94A54
info
#2478C8
muted
#6F7C86
primary
#3157D5
secondary
#4F46A6
success
#1D8E72
surface
#FFFFFF
text
#17202A
warning
#B7862F
motion3 items
duration
160ms
easing
cubic-bezier(0.2, 0.8, 0.2, 1)
philosophy
Motion is analytical and small: locus rows lift 2px, confidence cells brighten, and panels crossfade without bouncing or theatrical lab effects.
radii5 items
full
9999px
lg
22px
md
12px
none
0
sm
6px
shadows3 items
lg
0 30px 80px rgba(31, 50, 73, 0.14)
md
0 14px 34px rgba(31, 50, 73, 0.10)
sm
0 1px 2px rgba(25, 36, 47, 0.06)
spacing2 items
base
8px
scale
4, 8, 12, 16, 24, 32, 48, 64, 80
surfaces3 items
bg pattern
Plain warm neutral background with a few localized sequence tick underlays inside dedicated track components only; no repeated square-grid background.
card style
Large rounded evidence panels, soft shadow, 1px cool border, compact internal sequence notations, and data-bearing chips rather than stripes.
treatment
Porcelain white panels over a warm mist background, with blue-gray hairline separation and no full-page grid or decorative dot texture.
typography8 items
base size
16px
body font
Geist
google fonts url
https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500;600&display=swap
heading font
Geist
letter spacing
-0.018em
line height
1.5
mono font
Geist Mono
scale ratio
1.22
rules
composition
Create a real genomic review workspace: top coordinate/navigation band, large central alignment and evidence track, supporting metric modules, and an interpretation editor. Use asymmetry through content scale, not decorative rails or equal dashboard cards.
density
Medium density with generous macro whitespace: sequence rows may be compact and data-rich, while panel gaps and page margins remain calm enough for premium review work.
hierarchy
Use crisp Geist headings, mono coordinate labels, and sequenced chip rows to separate product command, genomic location, evidence confidence, and clinical interpretation. Color appears only where it encodes action, state, base group, or validation.
signature patterns
Nucleobase chip strings place A/C/G/T inside tiny rounded cells with neutral fills and selective indigo, turquoise, green, or amber states for mutation, selection, validation, and uncertainty.Quantized confidence pixels appear as short rows of 3px to 8px square cells inside variant cards, tables, and sliders, always labeled or adjacent to a confidence value.Layered genome tracks use horizontal rounded bars, coordinate ticks, exon blocks, and mismatch markers inside bounded components instead of full-page grids or decorative wallpaper.Stepped focus halos combine a normal rounded outline with four tiny square corner pixels, making modularity visible only during focus, selection, or active locus states.
layout
breakpoints

mobile <= 640px, tablet 641px-1024px, desktop >= 1025px

grid
Desktop uses a 12-column product grid with a 3-column left navigation/evidence stack, 6-column central sequence atlas, and 3-column interpretation rail; tablet collapses to 8 columns and mobile becomes a single evidence flow.
whitespace

Keep outer page margins at 24-64px and panel gutters at 16-24px; reserve tight 4-8px spacing for nucleobase chips and confidence cells only.

guidance
do
  • Use genomic coordinates, sequence reads, base chips, variant queues, quality/confidence cells, and provenance labels as the primary visual motifs.
  • Keep backgrounds neutral and clean; localize modular pixels to data components, active focus, and confidence notation.
  • Use cool highlights with semantic discipline: indigo for action/locus, turquoise for selection, green for validation, amber for review uncertainty.
  • Write scene copy as a real genomics product with samples, loci, transcript IDs, pathogenicity notes, and review states.
avoid
  • Do not draw helixes, molecules, generic lab beakers, rainbow chromosomes, or science textbook panels.
  • Do not use square-grid backgrounds, dotted default texture, colored side rails, card stripes, chipped corners, uneven borders, or retro-game pixel art.
  • Do not create a generic analytics dashboard; every module should feel tied to sequence review, evidence interpretation, or genomic operations.
katagami spec
# Sequence Porcelain Atlas

## Philosophy

Sequence Porcelain Atlas turns genomic work into a premium evidence atlas: quiet porcelain-white product surfaces, precise coordinate typography, nucleobase chips, and small quantized confidence pixels make DNA feel like inspectable data rather than biotech decoration.

### Values

- Use genomics as operational notation: coordinates, base calls, variant evidence, confidence, and provenance drive the interface grammar.
- Keep the product calm and high-trust through white/neutral surfaces, exact spacing, restrained outlines, and cool semantic highlights.
- Let modular pixels appear only as data-bearing confidence cells, sequence ticks, or alignment mismatches rather than decorative retro styling.
- Make complex biology feel navigable through layered tracks, review queues, and evidence cards instead of textbook diagrams.

### Anti-Values

- No DNA helix wallpaper, molecule sprinkles, chromosome rainbows, lab-dashboard templates, or science textbook illustrations.
- No square-grid background, default dotted texture, colored side rails, striped card accents, chipped corners, uneven borders, or retro game skin.
- No hospital-blue monotony or rainbow sprawl; color must encode status, base family, focus, or action.

### Visual Character

- Use porcelain-white and warm-neutral application surfaces with very thin blue-gray borders, large rounded rectangles, and soft ambient shadows that read as premium instruments rather than cards with garnish.
- Build sequence motifs from inline nucleobase chips: compact A/C/G/T letter cells, muted neutral fills, and occasional cool-highlight mutation cells embedded inside tables, tabs, and summary panels.
- Express pixel/modular styling through 3px to 8px quantized confidence cells, stepped focus halos, and tiny alignment bars that carry data state instead of forming repeated background grids.
- Compose screens as genomic evidence atlases: a coordinate header, layered horizontal sequence tracks, variant review cards, and a right-side interpretation workspace with no decorative side stripes.
- Use cool highlights as semantic channels: deep indigo for primary action and active locus, sea-glass green for validated evidence, turquoise for live selection, and amber only for review uncertainty.

## Tokens

### Borders

- **Accent Width**: 2px
- **Character**: Cool blue-gray instrument borders; active states use complete indigo or turquoise outlines, never side rails or partial stripes.
- **Default Width**: 1px
- **Style**: solid hairline with occasional stepped focus outline

### Colors

| Name | Value |
|------|-------|
| accent | `#12AFA8` |
| background | `#F7F8F6` |
| border | `#DCE3E8` |
| error | `#B94A54` |
| info | `#2478C8` |
| muted | `#6F7C86` |
| primary | `#3157D5` |
| secondary | `#4F46A6` |
| success | `#1D8E72` |
| surface | `#FFFFFF` |
| text | `#17202A` |
| warning | `#B7862F` |

### Motion

- **Duration**: 160ms
- **Easing**: cubic-bezier(0.2, 0.8, 0.2, 1)
- **Philosophy**: Motion is analytical and small: locus rows lift 2px, confidence cells brighten, and panels crossfade without bouncing or theatrical lab effects.

### Radii

- **Full**: 9999px
- **Lg**: 22px
- **Md**: 12px
- **None**: 0
- **Sm**: 6px

### Shadows

- **Lg**: 0 30px 80px rgba(31, 50, 73, 0.14)
- **Md**: 0 14px 34px rgba(31, 50, 73, 0.10)
- **Sm**: 0 1px 2px rgba(25, 36, 47, 0.06)

### Spacing

- **Base**: 8px
- **Scale**: [4,8,12,16,24,32,48,64,80]

### Surfaces

- **Bg Pattern**: Plain warm neutral background with a few localized sequence tick underlays inside dedicated track components only; no repeated square-grid background.
- **Card Style**: Large rounded evidence panels, soft shadow, 1px cool border, compact internal sequence notations, and data-bearing chips rather than stripes.
- **Treatment**: Porcelain white panels over a warm mist background, with blue-gray hairline separation and no full-page grid or decorative dot texture.

### Typography

- **Base Size**: 16px
- **Body Font**: Geist
- **Google Fonts Url**: https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500;600&display=swap
- **Heading Font**: Geist
- **Letter Spacing**: -0.018em
- **Line Height**: 1.5
- **Mono Font**: Geist Mono
- **Scale Ratio**: 1.22

## Rules

### Composition

Create a real genomic review workspace: top coordinate/navigation band, large central alignment and evidence track, supporting metric modules, and an interpretation editor. Use asymmetry through content scale, not decorative rails or equal dashboard cards.

### Density

Medium density with generous macro whitespace: sequence rows may be compact and data-rich, while panel gaps and page margins remain calm enough for premium review work.

### Hierarchy

Use crisp Geist headings, mono coordinate labels, and sequenced chip rows to separate product command, genomic location, evidence confidence, and clinical interpretation. Color appears only where it encodes action, state, base group, or validation.

### Signature Patterns

- Nucleobase chip strings place A/C/G/T inside tiny rounded cells with neutral fills and selective indigo, turquoise, green, or amber states for mutation, selection, validation, and uncertainty.
- Quantized confidence pixels appear as short rows of 3px to 8px square cells inside variant cards, tables, and sliders, always labeled or adjacent to a confidence value.
- Layered genome tracks use horizontal rounded bars, coordinate ticks, exon blocks, and mismatch markers inside bounded components instead of full-page grids or decorative wallpaper.
- Stepped focus halos combine a normal rounded outline with four tiny square corner pixels, making modularity visible only during focus, selection, or active locus states.

## Layout

### Breakpoints

mobile <= 640px, tablet 641px-1024px, desktop >= 1025px

### Grid

Desktop uses a 12-column product grid with a 3-column left navigation/evidence stack, 6-column central sequence atlas, and 3-column interpretation rail; tablet collapses to 8 columns and mobile becomes a single evidence flow.

### Whitespace

Keep outer page margins at 24-64px and panel gutters at 16-24px; reserve tight 4-8px spacing for nucleobase chips and confidence cells only.

## Guidance

### Do

- Use genomic coordinates, sequence reads, base chips, variant queues, quality/confidence cells, and provenance labels as the primary visual motifs.
- Keep backgrounds neutral and clean; localize modular pixels to data components, active focus, and confidence notation.
- Use cool highlights with semantic discipline: indigo for action/locus, turquoise for selection, green for validation, amber for review uncertainty.
- Write scene copy as a real genomics product with samples, loci, transcript IDs, pathogenicity notes, and review states.

### Don't

- Do not draw helixes, molecules, generic lab beakers, rainbow chromosomes, or science textbook panels.
- Do not use square-grid backgrounds, dotted default texture, colored side rails, card stripes, chipped corners, uneven borders, or retro-game pixel art.
- Do not create a generic analytics dashboard; every module should feel tied to sequence review, evidence interpretation, or genomic operations.

### Candidate Directions

- {"idea":"white porcelain surfaces with genomic coordinate ledgers, nucleobase chips, quantized confidence pixels, and calm cool highlight semantics","name":"Sequence Porcelain Atlas","scores":{"distinctiveness":9,"freshness":9,"motif_quality":10,"palette_harmony":9,"product_usefulness":10,"research_grounding":10,"restraint":9},"verdict":"chosen"}
- {"idea":"legal/records office metaphor for variant review with stamped provenance and monospaced accession labels","name":"Variant Clerk Ledger","scores":{"distinctiveness":8,"freshness":8,"motif_quality":8,"palette_harmony":7,"product_usefulness":9,"research_grounding":8,"restraint":8},"verdict":"strong but too document-heavy and less expressive for live product UI"}
- {"idea":"translucent microscopy panes and soft green glow for lab-to-cloud workflow","name":"Cellular Glass Console","scores":{"distinctiveness":5,"freshness":6,"motif_quality":6,"palette_harmony":7,"product_usefulness":7,"research_grounding":6,"restraint":5},"verdict":"rejected because glass biotech risks generic lab SaaS and garnish color"}
- {"idea":"inheritance and cohort relationships expressed through braided rows, family-haplotype bands, and sparse kinship arcs","name":"Population Weave","scores":{"distinctiveness":8,"freshness":8,"motif_quality":8,"palette_harmony":8,"product_usefulness":7,"research_grounding":8,"restraint":7},"verdict":"not chosen because relationship diagrams are narrower than a reusable product language"}
- {"idea":"high-density sequencer-console UI with monospace reads, command palette, and quality histograms","name":"Basecall Terminal","scores":{"distinctiveness":7,"freshness":7,"motif_quality":8,"palette_harmony":7,"product_usefulness":8,"research_grounding":9,"restraint":6},"verdict":"too close to lab terminal/dashboard territory and less premium"}
- {"idea":"minimal white interface with turquoise markup layers and floating genomics notes","name":"Turquoise Annotation Field","scores":{"distinctiveness":5,"freshness":6,"motif_quality":6,"palette_harmony":8,"product_usefulness":7,"research_grounding":6,"restraint":8},"verdict":"too likely to become generic medical SaaS without a stronger structural motif"}

### Chosen Direction Rationale

Sequence Porcelain Atlas scored highest because it converts research-derived genomics primitives into product-useful UI grammar while preserving restraint. It can scale across shadcn components, supports premium white/neutral surfaces, and uses pixel/modular styling as evidence notation rather than decoration.

### Research Notes

- {"observation":"Serious genomics tools organize meaning as tracks, alignments, base calls, genomic coordinates, variants, confidence, and annotations. The strongest product metaphor is not a helix but a navigable coordinate atlas of evidence layers.","source":"UCSC Genome Browser / Ensembl / IGV interface conventions"}
- {"observation":"A/C/G/T letters, base-quality marks, variant callouts, exon/intron blocks, and alignment mismatches are compact, non-cliche visual material. They can become chips and micro-bars rather than decorative science icons.","source":"DNA sequencing notation and nucleobase conventions"}
- {"observation":"Trust comes from quiet surfaces, generous white space, exact typography, subdued outlines, and narrow semantic color channels. Blue alone risks generic hospital SaaS; cooler blue-violet plus sea-glass green feels more precise and less clinical.","source":"Modern premium health-tech/product UI"}
- {"observation":"Pixel language feels premium when it is quantized data notation: tiny square confidence cells, base tickers, and stepped focus rings. It fails when used as a game skin, background grid, or decorative dot wallpaper.","source":"Contemporary modular/pixel product design"}
- {"observation":"Avoid helix wallpaper, molecule sprinkles, rainbow chromosomes, lab-dashboard templates, left color rails, generic KPI cards, and textbook diagrams. Product usefulness requires sequence operations, review states, provenance, and decision queues.","source":"Bioinformatics anti-pattern scan"}
DESIGN.md
---
version: "alpha"
name: "Sequence Porcelain Atlas"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
  accent: "#12AFA8"
  background: "#F7F8F6"
  border: "#DCE3E8"
  error: "#B94A54"
  info: "#2478C8"
  muted: "#6F7C86"
  primary: "#3157D5"
  secondary: "#4F46A6"
  success: "#1D8E72"
  surface: "#FFFFFF"
  text: "#17202A"
  warning: "#B7862F"
typography:
  headline-lg:
    fontFamily: "Geist"
    fontSize: "1.816rem"
    fontWeight: 700
    lineHeight: 1.1
    letterSpacing: "-0.018em"
  headline-md:
    fontFamily: "Geist"
    fontSize: "1.488rem"
    fontWeight: 600
    lineHeight: 1.15
    letterSpacing: "-0.018em"
  body-md:
    fontFamily: "Geist"
    fontSize: "16px"
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: "-0.018em"
  label-md:
    fontFamily: "Geist Mono"
    fontSize: "0.75rem"
    fontWeight: 600
    lineHeight: 1
    letterSpacing: "0.08em"
rounded:
  full: "9999px"
  lg: "22px"
  md: "12px"
  none: "0px"
  sm: "6px"
spacing:
  base: "8px"
  xs: "4px"
  sm: "8px"
  md: "12px"
  lg: "16px"
  xl: "24px"
  2xl: "32px"
  3xl: "48px"
  4xl: "64px"
  step-8: "80px"
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"
---

# Sequence Porcelain Atlas

## Overview

Sequence Porcelain Atlas turns genomic work into a premium evidence atlas: quiet porcelain-white product surfaces, precise coordinate typography, nucleobase chips, and small quantized confidence pixels make DNA feel like inspectable data rather than biotech decoration.

### Values

- Use genomics as operational notation: coordinates, base calls, variant evidence, confidence, and provenance drive the interface grammar.
- Keep the product calm and high-trust through white/neutral surfaces, exact spacing, restrained outlines, and cool semantic highlights.
- Let modular pixels appear only as data-bearing confidence cells, sequence ticks, or alignment mismatches rather than decorative retro styling.
- Make complex biology feel navigable through layered tracks, review queues, and evidence cards instead of textbook diagrams.

### Anti-Values

- No DNA helix wallpaper, molecule sprinkles, chromosome rainbows, lab-dashboard templates, or science textbook illustrations.
- No square-grid background, default dotted texture, colored side rails, striped card accents, chipped corners, uneven borders, or retro game skin.
- No hospital-blue monotony or rainbow sprawl; color must encode status, base family, focus, or action.

### Visual Character

- Use porcelain-white and warm-neutral application surfaces with very thin blue-gray borders, large rounded rectangles, and soft ambient shadows that read as premium instruments rather than cards with garnish.
- Build sequence motifs from inline nucleobase chips: compact A/C/G/T letter cells, muted neutral fills, and occasional cool-highlight mutation cells embedded inside tables, tabs, and summary panels.
- Express pixel/modular styling through 3px to 8px quantized confidence cells, stepped focus halos, and tiny alignment bars that carry data state instead of forming repeated background grids.
- Compose screens as genomic evidence atlases: a coordinate header, layered horizontal sequence tracks, variant review cards, and a right-side interpretation workspace with no decorative side stripes.
- Use cool highlights as semantic channels: deep indigo for primary action and active locus, sea-glass green for validated evidence, turquoise for live selection, and amber only for review uncertainty.

## 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 | `#12AFA8` |
| background | `#F7F8F6` |
| border | `#DCE3E8` |
| error | `#B94A54` |
| info | `#2478C8` |
| muted | `#6F7C86` |
| primary | `#3157D5` |
| secondary | `#4F46A6` |
| success | `#1D8E72` |
| surface | `#FFFFFF` |
| text | `#17202A` |
| warning | `#B7862F` |

## Typography

- **Headline-Lg**: Geist, 1.816rem, weight 700, line-height 1.1.
- **Headline-Md**: Geist, 1.488rem, weight 600, line-height 1.15.
- **Body-Md**: Geist, 16px, weight 400, line-height 1.5.
- **Label-Md**: Geist Mono, 0.75rem, weight 600, line-height 1.

## Layout

### Spacing Tokens

- **Base**: `8px`
- **Xs**: `4px`
- **Sm**: `8px`
- **Md**: `12px`
- **Lg**: `16px`
- **Xl**: `24px`
- **2xl**: `32px`
- **3xl**: `48px`
- **4xl**: `64px`
- **Step-8**: `80px`

### Breakpoints

mobile <= 640px, tablet 641px-1024px, desktop >= 1025px

### Grid

Desktop uses a 12-column product grid with a 3-column left navigation/evidence stack, 6-column central sequence atlas, and 3-column interpretation rail; tablet collapses to 8 columns and mobile becomes a single evidence flow.

### Whitespace

Keep outer page margins at 24-64px and panel gutters at 16-24px; reserve tight 4-8px spacing for nucleobase chips and confidence cells only.

## Elevation & Depth

### Shadows

- **Lg**: 0 30px 80px rgba(31, 50, 73, 0.14)
- **Md**: 0 14px 34px rgba(31, 50, 73, 0.10)
- **Sm**: 0 1px 2px rgba(25, 36, 47, 0.06)

## Shapes

### Rounded

- **Full**: `9999px`
- **Lg**: `22px`
- **Md**: `12px`
- **None**: `0px`
- **Sm**: `6px`

### Surfaces

- **Bg Pattern**: Plain warm neutral background with a few localized sequence tick underlays inside dedicated track components only; no repeated square-grid background.
- **Card Style**: Large rounded evidence panels, soft shadow, 1px cool border, compact internal sequence notations, and data-bearing chips rather than stripes.
- **Treatment**: Porcelain white panels over a warm mist background, with blue-gray hairline separation and no full-page grid or decorative dot texture.

### Borders

- **Accent Width**: 2px
- **Character**: Cool blue-gray instrument borders; active states use complete indigo or turquoise outlines, never side rails or partial stripes.
- **Default Width**: 1px
- **Style**: solid hairline with occasional stepped focus outline

## Components

### Composition

Create a real genomic review workspace: top coordinate/navigation band, large central alignment and evidence track, supporting metric modules, and an interpretation editor. Use asymmetry through content scale, not decorative rails or equal dashboard cards.

### Density

Medium density with generous macro whitespace: sequence rows may be compact and data-rich, while panel gaps and page margins remain calm enough for premium review work.

### Hierarchy

Use crisp Geist headings, mono coordinate labels, and sequenced chip rows to separate product command, genomic location, evidence confidence, and clinical interpretation. Color appears only where it encodes action, state, base group, or validation.

### Signature Patterns

- Nucleobase chip strings place A/C/G/T inside tiny rounded cells with neutral fills and selective indigo, turquoise, green, or amber states for mutation, selection, validation, and uncertainty.
- Quantized confidence pixels appear as short rows of 3px to 8px square cells inside variant cards, tables, and sliders, always labeled or adjacent to a confidence value.
- Layered genome tracks use horizontal rounded bars, coordinate ticks, exon blocks, and mismatch markers inside bounded components instead of full-page grids or decorative wallpaper.
- Stepped focus halos combine a normal rounded outline with four tiny square corner pixels, making modularity visible only during focus, selection, or active locus states.

## 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-019e4c10-d236-7f81-b35c-9268b9ae3f35/DESIGN.with-shadcn.md`.

The shadcn page also exposes optional machine-readable files for automation, but the human-facing handoff is DESIGN.md with shadcn.

Install recommended primitives with `npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table`.

Use these primitives in shadcn apps:
- button
- card
- input
- textarea
- select
- dialog
- sheet
- tabs
- badge
- separator
- checkbox
- switch
- slider
- tooltip
- dropdown-menu
- table

Implementation rule for agents: import shadcn primitives from `@/components/ui/*`, apply the generated CSS variables first, then compose the language-specific recipes from the companion MD. Katagami remains the source of truth; shadcn names are the implementation surface.

## Do's and Don'ts

- Do Use genomic coordinates, sequence reads, base chips, variant queues, quality/confidence cells, and provenance labels as the primary visual motifs.
- Do Keep backgrounds neutral and clean; localize modular pixels to data components, active focus, and confidence notation.
- Do Use cool highlights with semantic discipline: indigo for action/locus, turquoise for selection, green for validation, amber for review uncertainty.
- Do Write scene copy as a real genomics product with samples, loci, transcript IDs, pathogenicity notes, and review states.
- Don't Do not draw helixes, molecules, generic lab beakers, rainbow chromosomes, or science textbook panels.
- Don't Do not use square-grid backgrounds, dotted default texture, colored side rails, card stripes, chipped corners, uneven borders, or retro-game pixel art.
- Don't Do not create a generic analytics dashboard; every module should feel tied to sequence review, evidence interpretation, or genomic operations.

### Candidate Directions

- {"idea":"white porcelain surfaces with genomic coordinate ledgers, nucleobase chips, quantized confidence pixels, and calm cool highlight semantics","name":"Sequence Porcelain Atlas","scores":{"distinctiveness":9,"freshness":9,"motif_quality":10,"palette_harmony":9,"product_usefulness":10,"research_grounding":10,"restraint":9},"verdict":"chosen"}
- {"idea":"legal/records office metaphor for variant review with stamped provenance and monospaced accession labels","name":"Variant Clerk Ledger","scores":{"distinctiveness":8,"freshness":8,"motif_quality":8,"palette_harmony":7,"product_usefulness":9,"research_grounding":8,"restraint":8},"verdict":"strong but too document-heavy and less expressive for live product UI"}
- {"idea":"translucent microscopy panes and soft green glow for lab-to-cloud workflow","name":"Cellular Glass Console","scores":{"distinctiveness":5,"freshness":6,"motif_quality":6,"palette_harmony":7,"product_usefulness":7,"research_grounding":6,"restraint":5},"verdict":"rejected because glass biotech risks generic lab SaaS and garnish color"}
- {"idea":"inheritance and cohort relationships expressed through braided rows, family-haplotype bands, and sparse kinship arcs","name":"Population Weave","scores":{"distinctiveness":8,"freshness":8,"motif_quality":8,"palette_harmony":8,"product_usefulness":7,"research_grounding":8,"restraint":7},"verdict":"not chosen because relationship diagrams are narrower than a reusable product language"}
- {"idea":"high-density sequencer-console UI with monospace reads, command palette, and quality histograms","name":"Basecall Terminal","scores":{"distinctiveness":7,"freshness":7,"motif_quality":8,"palette_harmony":7,"product_usefulness":8,"research_grounding":9,"restraint":6},"verdict":"too close to lab terminal/dashboard territory and less premium"}
- {"idea":"minimal white interface with turquoise markup layers and floating genomics notes","name":"Turquoise Annotation Field","scores":{"distinctiveness":5,"freshness":6,"motif_quality":6,"palette_harmony":8,"product_usefulness":7,"research_grounding":6,"restraint":8},"verdict":"too likely to become generic medical SaaS without a stronger structural motif"}

### Chosen Direction Rationale

Sequence Porcelain Atlas scored highest because it converts research-derived genomics primitives into product-useful UI grammar while preserving restraint. It can scale across shadcn components, supports premium white/neutral surfaces, and uses pixel/modular styling as evidence notation rather than decoration.

### Research Notes

- {"observation":"Serious genomics tools organize meaning as tracks, alignments, base calls, genomic coordinates, variants, confidence, and annotations. The strongest product metaphor is not a helix but a navigable coordinate atlas of evidence layers.","source":"UCSC Genome Browser / Ensembl / IGV interface conventions"}
- {"observation":"A/C/G/T letters, base-quality marks, variant callouts, exon/intron blocks, and alignment mismatches are compact, non-cliche visual material. They can become chips and micro-bars rather than decorative science icons.","source":"DNA sequencing notation and nucleobase conventions"}
- {"observation":"Trust comes from quiet surfaces, generous white space, exact typography, subdued outlines, and narrow semantic color channels. Blue alone risks generic hospital SaaS; cooler blue-violet plus sea-glass green feels more precise and less clinical.","source":"Modern premium health-tech/product UI"}
- {"observation":"Pixel language feels premium when it is quantized data notation: tiny square confidence cells, base tickers, and stepped focus rings. It fails when used as a game skin, background grid, or decorative dot wallpaper.","source":"Contemporary modular/pixel product design"}
- {"observation":"Avoid helix wallpaper, molecule sprinkles, rainbow chromosomes, lab-dashboard templates, left color rails, generic KPI cards, and textbook diagrams. Product usefulness requires sequence operations, review states, provenance, and decision queues.","source":"Bioinformatics anti-pattern scan"}
shadcn/ui theme
```json
{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "sequence-porcelain-atlas",
  "type": "registry:theme",
  "title": "Sequence Porcelain Atlas shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#F7F8F6",
      "foreground": "#17202A",
      "card": "#FFFFFF",
      "card-foreground": "#17202A",
      "popover": "#FFFFFF",
      "popover-foreground": "#17202A",
      "primary": "#3157D5",
      "primary-foreground": "#ffffff",
      "secondary": "#4F46A6",
      "secondary-foreground": "#ffffff",
      "muted": "#6F7C86",
      "muted-foreground": "#17202A",
      "accent": "#12AFA8",
      "accent-foreground": "#ffffff",
      "destructive": "#B94A54",
      "border": "#DCE3E8",
      "input": "#DCE3E8",
      "ring": "#12AFA8",
      "chart-1": "#3157D5",
      "chart-2": "#4F46A6",
      "chart-3": "#12AFA8",
      "chart-4": "#1D8E72",
      "chart-5": "#B7862F",
      "sidebar": "#FFFFFF",
      "sidebar-foreground": "#17202A",
      "sidebar-primary": "#3157D5",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#2478C8",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#DCE3E8",
      "sidebar-ring": "#12AFA8",
      "radius": "12px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#3157D5",
      "primary-foreground": "#ffffff",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#12AFA8",
      "accent-foreground": "#ffffff",
      "destructive": "#B94A54",
      "border": "#303642",
      "input": "#303642",
      "ring": "#12AFA8",
      "chart-1": "#3157D5",
      "chart-2": "#4F46A6",
      "chart-3": "#12AFA8",
      "chart-4": "#1D8E72",
      "chart-5": "#B7862F",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#3157D5",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#12AFA8",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#303642",
      "sidebar-ring": "#12AFA8",
      "radius": "12px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "en-019e4c10-d236-7f81-b35c-9268b9ae3f35",
    "slug": "sequence-porcelain-atlas",
    "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"
      ]
    }
  }
}
```
in the wild

embodiments

the full element showcase
embodiment · sequence-porcelain-atlas
DESIGN.md

at a glance

Palette

Typography

headline-lgGeist · 29px · 700

The quick brown fox jumps

headline-mdGeist · 24px · 600

The quick brown fox jumps

body-mdGeist · 16px · 400

The quick brown fox jumps

label-mdGeist 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
  • xl24px
  • 2xl32px
  • 3xl48px
  • 4xl64px
  • step-880px

Shape

full9999px
lg22px
md12px
none0px
sm6px
shadcn/ui

implementation kit

needs agent-authored kitcompatibility fallback
shadcn compatibility only
The generated theme variables are available, but the polished shadcn component recipes and shots have not been authored by the Katagami agent yet.
fallbackprimitives render
Compatibility proof
Local shadcn-style primitives accept the generated theme variables.
primaryaccentsurfacemutedwarningerror
table rhythm
buttonok
cardok
inputok
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 table
theme css
:root {
  --background: #F7F8F6;
  --foreground: #17202A;
  --card: #FFFFFF;
  --card-foreground: #17202A;
  --popover: #FFFFFF;
  --popover-foreground: #17202A;
  --primary: #3157D5;
  --primary-foreground: #ffffff;
  --secondary: #4F46A6;
  --secondary-foreground: #ffffff;
  --muted: #6F7C86;
  --muted-foreground: #17202A;
  --accent: #12AFA8;
  --accent-foreground: #ffffff;
  --destructive: #B94A54;
  --border: #DCE3E8;
  --input: #DCE3E8;
  --ring: #12AFA8;
  --chart-1: #3157D5;
  --chart-2: #4F46A6;
  --chart-3: #12AFA8;
  --chart-4: #1D8E72;
  --chart-5: #B7862F;
  --sidebar: #FFFFFF;
  --sidebar-foreground: #17202A;
  --sidebar-primary: #3157D5;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #2478C8;
  --sidebar-accent-foreground: #ffffff;
  --sidebar-border: #DCE3E8;
  --sidebar-ring: #12AFA8;
  --radius: 12px;
}

.dark {
  --background: #0f1115;
  --foreground: #f8fafc;
  --card: #181b22;
  --card-foreground: #f8fafc;
  --popover: #181b22;
  --popover-foreground: #f8fafc;
  --primary: #3157D5;
  --primary-foreground: #ffffff;
  --secondary: #252a33;
  --secondary-foreground: #f8fafc;
  --muted: #252a33;
  --muted-foreground: #a1a1aa;
  --accent: #12AFA8;
  --accent-foreground: #ffffff;
  --destructive: #B94A54;
  --border: #303642;
  --input: #303642;
  --ring: #12AFA8;
  --chart-1: #3157D5;
  --chart-2: #4F46A6;
  --chart-3: #12AFA8;
  --chart-4: #1D8E72;
  --chart-5: #B7862F;
  --sidebar: #181b22;
  --sidebar-foreground: #f8fafc;
  --sidebar-primary: #3157D5;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #12AFA8;
  --sidebar-accent-foreground: #ffffff;
  --sidebar-border: #303642;
  --sidebar-ring: #12AFA8;
  --radius: 12px;
}
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 SequencePorcelainAtlasShadcnKit() {
  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">Sequence Porcelain Atlas</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 JSONstored + verified
{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "cssVars": {
    "dark": {
      "accent": "#12AFA8",
      "accent-foreground": "#ffffff",
      "background": "#0f1115",
      "border": "#303642",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "chart-1": "#3157D5",
      "chart-2": "#4F46A6",
      "chart-3": "#12AFA8",
      "chart-4": "#1D8E72",
      "chart-5": "#B7862F",
      "destructive": "#B94A54",
      "foreground": "#f8fafc",
      "input": "#303642",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#3157D5",
      "primary-foreground": "#ffffff",
      "radius": "12px",
      "ring": "#12AFA8",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "sidebar": "#181b22",
      "sidebar-accent": "#12AFA8",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#303642",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#3157D5",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-ring": "#12AFA8"
    },
    "light": {
      "accent": "#12AFA8",
      "accent-foreground": "#ffffff",
      "background": "#F7F8F6",
      "border": "#DCE3E8",
      "card": "#FFFFFF",
      "card-foreground": "#17202A",
      "chart-1": "#3157D5",
      "chart-2": "#4F46A6",
      "chart-3": "#12AFA8",
      "chart-4": "#1D8E72",
      "chart-5": "#B7862F",
      "destructive": "#B94A54",
      "foreground": "#17202A",
      "input": "#DCE3E8",
      "muted": "#6F7C86",
      "muted-foreground": "#17202A",
      "popover": "#FFFFFF",
      "popover-foreground": "#17202A",
      "primary": "#3157D5",
      "primary-foreground": "#ffffff",
      "radius": "12px",
      "ring": "#12AFA8",
      "secondary": "#4F46A6",
      "secondary-foreground": "#ffffff",
      "sidebar": "#FFFFFF",
      "sidebar-accent": "#2478C8",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#DCE3E8",
      "sidebar-foreground": "#17202A",
      "sidebar-primary": "#3157D5",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-ring": "#12AFA8"
    },
    "theme": {}
  },
  "meta": {
    "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",
    "languageId": "en-019e4c10-d236-7f81-b35c-9268b9ae3f35",
    "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"
      ]
    },
    "slug": "sequence-porcelain-atlas",
    "source": "katagami"
  },
  "name": "sequence-porcelain-atlas",
  "title": "Sequence Porcelain Atlas shadcn Theme",
  "type": "registry:theme"
}
component recipescompatibility fallback
# Sequence Porcelain Atlas shadcn/ui Components

Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `en-019e4c10-d236-7f81-b35c-9268b9ae3f35`
Slug: `sequence-porcelain-atlas`

## Intent

Sequence Porcelain Atlas turns genomic work into a premium evidence atlas: quiet porcelain-white product surfaces, precise coordinate typography, nucleobase chips, and small quantized confidence pixels make DNA feel like inspectable data rather than biotech decoration.

## Required primitives

- button
- card
- input
- textarea
- select
- dialog
- sheet
- tabs
- badge
- separator
- checkbox
- switch
- slider
- tooltip
- dropdown-menu
- table

Install with `npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table`.

## Token cues

Colors:

{
  "accent": "#12AFA8",
  "background": "#F7F8F6",
  "border": "#DCE3E8",
  "error": "#B94A54",
  "info": "#2478C8",
  "muted": "#6F7C86",
  "primary": "#3157D5",
  "secondary": "#4F46A6",
  "success": "#1D8E72",
  "surface": "#FFFFFF",
  "text": "#17202A",
  "warning": "#B7862F"
}

Typography:

{
  "base_size": "16px",
  "body_font": "Geist",
  "google_fonts_url": "https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500;600&display=swap",
  "heading_font": "Geist",
  "letter_spacing": "-0.018em",
  "line_height": 1.5,
  "mono_font": "Geist Mono",
  "scale_ratio": 1.22
}

## Visual character to preserve

- Use porcelain-white and warm-neutral application surfaces with very thin blue-gray borders, large rounded rectangles, and soft ambient shadows that read as premium instruments rather than cards with garnish.
- Build sequence motifs from inline nucleobase chips: compact A/C/G/T letter cells, muted neutral fills, and occasional cool-highlight mutation cells embedded inside tables, tabs, and summary panels.
- Express pixel/modular styling through 3px to 8px quantized confidence cells, stepped focus halos, and tiny alignment bars that carry data state instead of forming repeated background grids.
- Compose screens as genomic evidence atlases: a coordinate header, layered horizontal sequence tracks, variant review cards, and a right-side interpretation workspace with no decorative side stripes.
- Use cool highlights as semantic channels: deep indigo for primary action and active locus, sea-glass green for validated evidence, turquoise for live selection, and amber only for review uncertainty.

## ShadSync visual profile

{
  "family": "paper-collage",
  "material": "paper",
  "contour": "default",
  "border": "solid",
  "underlay": true,
  "grain": true,
  "stickerBadges": false,
  "motion": "lift",
  "density": "dense",
  "accents": [
    "primary",
    "accent",
    "secondary",
    "muted"
  ]
}

## Signature component recipes

### Button
Use `Button` for primary, secondary, outline, and ghost actions. Primary actions must expose the language's strongest contrast pair, while secondary and ghost actions should preserve the surface treatment instead of falling back to default neutral SaaS styling.

### Card
Use `Card`, `CardHeader`, `CardContent`, `CardFooter`, and `CardAction` as the main composition frame. Cards should demonstrate the language's surface, border, hierarchy, and density rules rather than appearing as generic rounded rectangles.

### Input and Textarea
Use `Input` and `Textarea` with visible focus rings, field labels, validation states, and the language's rhythm. Forms should show real product content, not placeholder-only controls.

### Select, Tabs, and Table
Use `Select`, `Tabs`, and `Table` to prove navigation, filtering, and dense data states. The table should show row rhythm, separators, hover/focus states, and an empty or status state when the language calls for it.

### Dialog and Sheet
Use `Dialog` for centered decisions and `Sheet` for contextual editing. Both should inherit the language's spacing, border, overlay, and motion rules.

## Preview shots

- `application-shell`: dashboard or workspace shell with navigation, cards, forms, and state badges.
- `detail-editor`: focused editing flow using input, textarea, select, switch/checkbox, dialog or sheet, and action buttons.
- `data-operations`: table-heavy operational view with tabs, dropdown menu affordances, badges, and destructive/empty states.
- Each preview shot must include a renderable `scene` payload with concrete headline, description, actions, and rows/fields/stats for the UI preview.

## Implementation contract

- Start from local `ui/src/components/ui` shadcn-style primitives; do not create a second component system.
- Apply `/katagami/shadcn/sequence-porcelain-atlas/registry-theme.json` variables, then use these recipes for composition and state design.
- Preserve Katagami token names as source metadata; shadcn semantic names are only the export surface.
- Do: Use genomic coordinates, sequence reads, base chips, variant queues, quality/confidence cells, and provenance labels as the primary visual motifs.; Keep backgrounds neutral and clean; localize modular pixels to data components, active focus, and confidence notation.; Use cool highlights with semantic discipline: indigo for action/locus, turquoise for selection, green for validation, amber for review uncertainty.; Write scene copy as a real genomics product with samples, loci, transcript IDs, pathogenicity notes, and review states.
- Do not: Do not draw helixes, molecules, generic lab beakers, rainbow chromosomes, or science textbook panels.; Do not use square-grid backgrounds, dotted default texture, colored side rails, card stripes, chipped corners, uneven borders, or retro-game pixel art.; Do not create a generic analytics dashboard; every module should feel tied to sequence review, evidence interpretation, or genomic operations.

## 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 SequencePorcelainAtlasShadcnKit() {
  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">Sequence Porcelain Atlas</h2>
          <p className="mt-1 max-w-xl text-sm text-muted-foreground">
            Use the Katagami registry theme, then compose these shadcn primitives
            with the language-specific component recipes.
          </p>
        </div>
        <Button>Apply theme</Button>
      </div>

      <Tabs defaultValue="components">
        <TabsList>
          <TabsTrigger value="components">Components</TabsTrigger>
          <TabsTrigger value="states">States</TabsTrigger>
          <TabsTrigger value="export">Export</TabsTrigger>
        </TabsList>
      </Tabs>

      <Card>
        <CardHeader>
          <CardTitle>Component recipe</CardTitle>
          <CardDescription>
            Replace this starter content with the agent-authored product scene
            from components.md and preview-shots.json.
          </CardDescription>
        </CardHeader>
        <CardContent className="grid gap-3 sm:grid-cols-[1fr_auto]">
          <Input defaultValue="Tokenized shadcn surface" aria-label="Recipe name" />
          <Button variant="secondary">Preview state</Button>
        </CardContent>
        <CardFooter className="justify-between">
          <Badge>Ready</Badge>
          <Button variant="outline">Copy recipe</Button>
        </CardFooter>
      </Card>
    </section>
  );
}
```

## Layout notes

{
  "breakpoints": "mobile <= 640px, tablet 641px-1024px, desktop >= 1025px",
  "grid": "Desktop uses a 12-column product grid with a 3-column left navigation/evidence stack, 6-column central sequence atlas, and 3-column interpretation rail; tablet collapses to 8 columns and mobile becomes a single evidence flow.",
  "whitespace": "Keep outer page margins at 24-64px and panel gutters at 16-24px; reserve tight 4-8px spacing for nucleobase chips and confidence cells only."
}
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-019e4c10-d236-7f81-b35c-9268b9ae3f35",
    "name": "Sequence Porcelain Atlas",
    "slug": "sequence-porcelain-atlas"
  },
  "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": [
    "Use porcelain-white and warm-neutral application surfaces with very thin blue-gray borders, large rounded rectangles, and soft ambient shadows that read as premium instruments rather than cards with garnish.",
    "Build sequence motifs from inline nucleobase chips: compact A/C/G/T letter cells, muted neutral fills, and occasional cool-highlight mutation cells embedded inside tables, tabs, and summary panels.",
    "Express pixel/modular styling through 3px to 8px quantized confidence cells, stepped focus halos, and tiny alignment bars that carry data state instead of forming repeated background grids.",
    "Compose screens as genomic evidence atlases: a coordinate header, layered horizontal sequence tracks, variant review cards, and a right-side interpretation workspace with no decorative side stripes.",
    "Use cool highlights as semantic channels: deep indigo for primary action and active locus, sea-glass green for validated evidence, turquoise for live selection, and amber only for review uncertainty."
  ],
  "visualProfile": {
    "family": "paper-collage",
    "material": "paper",
    "contour": "default",
    "border": "solid",
    "underlay": true,
    "grain": true,
    "stickerBadges": false,
    "motion": "still",
    "density": "dense",
    "accents": [
      "primary",
      "accent",
      "secondary",
      "muted"
    ]
  },
  "shots": [
    {
      "id": "application-shell",
      "title": "Application shell",
      "viewport": "desktop",
      "primitives": [
        "button",
        "card",
        "input",
        "select",
        "tabs",
        "badge",
        "separator",
        "table"
      ],
      "composition": "A real product workspace with navigation, summary cards, filtering controls, and one dense content region.",
      "mustShow": [
        "primary and secondary actions",
        "card hierarchy",
        "filterable state",
        "table or list density"
      ],
      "avoid": [
        "component inventory walls",
        "placeholder-only content",
        "generic rounded SaaS chrome"
      ],
      "scene": {
        "eyebrow": "workspace spread",
        "headline": "Sequence Porcelain Atlas launch room",
        "description": "A product team workspace where navigation, filters, metrics, and dense rows carry the language's visible structure.",
        "primaryAction": "Apply theme",
        "secondaryAction": "Review states",
        "stats": [
          {
            "label": "components",
            "value": "16",
            "tone": "accent"
          },
          {
            "label": "states",
            "value": "ready"
          },
          {
            "label": "density",
            "value": "balanced",
            "tone": "warning"
          }
        ],
        "rows": [
          {
            "label": "Primary flow",
            "value": "mapped",
            "status": "active"
          },
          {
            "label": "Token coverage",
            "value": "semantic",
            "status": "synced"
          },
          {
            "label": "Responsive proof",
            "value": "queued",
            "status": "review"
          }
        ],
        "statuses": [
          "Active",
          "Synced",
          "Draft"
        ]
      }
    },
    {
      "id": "detail-editor",
      "title": "Detail editor",
      "viewport": "tablet",
      "primitives": [
        "button",
        "card",
        "input",
        "textarea",
        "select",
        "checkbox",
        "switch",
        "slider",
        "dialog",
        "sheet"
      ],
      "composition": "A focused editing flow with form fields, validation, confirmation, and a contextual side panel.",
      "mustShow": [
        "focus ring",
        "error or destructive state",
        "dialog or sheet treatment",
        "written guidance content"
      ],
      "avoid": [
        "unstyled browser controls",
        "floating cards inside cards",
        "missing labels"
      ],
      "scene": {
        "eyebrow": "editing flow",
        "headline": "Language recipe editor",
        "description": "A focused form proving labels, validation, toggles, panel rhythm, and action hierarchy.",
        "primaryAction": "Save recipe",
        "secondaryAction": "Open sheet",
        "fields": [
          {
            "label": "Component family",
            "value": "Narrative cards"
          },
          {
            "label": "State treatment",
            "value": "Visible focus + validation"
          },
          {
            "label": "Motion",
            "value": "Small lift, no opacity-only fade"
          }
        ],
        "statuses": [
          "Focus",
          "Invalid",
          "Confirmed"
        ]
      }
    },
    {
      "id": "data-operations",
      "title": "Data operations",
      "viewport": "mobile",
      "primitives": [
        "button",
        "tabs",
        "badge",
        "dropdown-menu",
        "table",
        "tooltip",
        "separator"
      ],
      "composition": "A compact operational view proving row rhythm, stacked actions, menu states, badges, and empty/destructive states.",
      "mustShow": [
        "responsive reflow",
        "dense row styling",
        "menu affordance",
        "status badge system"
      ],
      "avoid": [
        "desktop-only tables",
        "text overflow",
        "default shadcn spacing without Katagami character"
      ],
      "scene": {
        "eyebrow": "operations",
        "headline": "Compact review queue",
        "description": "A narrow viewport scene with rows, menus, tooltips, badges, and destructive affordances.",
        "primaryAction": "Resolve",
        "secondaryAction": "Filter",
        "rows": [
          {
            "label": "Button hierarchy",
            "value": "approved",
            "status": "ok"
          },
          {
            "label": "Table rhythm",
            "value": "needs pass",
            "status": "watch"
          },
          {
            "label": "Empty state",
            "value": "designed",
            "status": "done"
          }
        ],
        "statuses": [
          "Queued",
          "Blocked",
          "Done"
        ]
      }
    }
  ],
  "componentRecipes": [
    {
      "primitive": "button",
      "intent": "Prove action hierarchy, focus, disabled, and destructive states."
    },
    {
      "primitive": "card",
      "intent": "Carry the language surface, border, elevation, and density rules."
    },
    {
      "primitive": "input",
      "intent": "Show labels, focus rings, validation, and spacing rhythm."
    },
    {
      "primitive": "textarea",
      "intent": "Show longer guidance, validation copy, and writing density."
    },
    {
      "primitive": "select",
      "intent": "Show filtering, selection contrast, and menu trigger styling."
    },
    {
      "primitive": "dialog",
      "intent": "Show centered decision states and overlay treatment."
    },
    {
      "primitive": "sheet",
      "intent": "Show contextual side panels and responsive editing."
    },
    {
      "primitive": "tabs",
      "intent": "Show navigational structure and active/inactive contrast."
    },
    {
      "primitive": "badge",
      "intent": "Show compact status vocabulary and semantic colors."
    },
    {
      "primitive": "separator",
      "intent": "Show section rhythm without generic gray dividers."
    },
    {
      "primitive": "checkbox",
      "intent": "Show binary selection with visible focus and checked states."
    },
    {
      "primitive": "switch",
      "intent": "Show settings toggles and on/off contrast."
    },
    {
      "primitive": "slider",
      "intent": "Show numeric adjustment with track/thumb styling."
    },
    {
      "primitive": "tooltip",
      "intent": "Show concise explanation styling above compact controls."
    },
    {
      "primitive": "dropdown-menu",
      "intent": "Show action menus, destructive items, and grouped choices."
    },
    {
      "primitive": "table",
      "intent": "Show dense operational data, separators, row states, and responsive behavior."
    }
  ],
  "qualityRules": {
    "do": [
      "Use genomic coordinates, sequence reads, base chips, variant queues, quality/confidence cells, and provenance labels as the primary visual motifs.",
      "Keep backgrounds neutral and clean; localize modular pixels to data components, active focus, and confidence notation.",
      "Use cool highlights with semantic discipline: indigo for action/locus, turquoise for selection, green for validation, amber for review uncertainty.",
      "Write scene copy as a real genomics product with samples, loci, transcript IDs, pathogenicity notes, and review states."
    ],
    "dont": [
      "Do not draw helixes, molecules, generic lab beakers, rainbow chromosomes, or science textbook panels.",
      "Do not use square-grid backgrounds, dotted default texture, colored side rails, card stripes, chipped corners, uneven borders, or retro-game pixel art.",
      "Do not create a generic analytics dashboard; every module should feel tied to sequence review, evidence interpretation, or genomic operations."
    ]
  }
}