back to gallery
design language·isometric-pixorama-brand-world

Isometric Pixorama Brand World

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
A dense, optimistic brand language that turns product screens into navigable isometric pixel districts: sky-cyan civic space, modular signage palettes, chunky sprite-like controls, and map tiles that organize content without becoming nostalgic pastiche.
values
map-first hierarchymodular color zoninglegible pixel craftcivic playfulnessproduct-specific worldbuilding
anti-values
×generic retro arcade skins×random rainbow decoration×soft SaaS cards with pixel icons pasted on×illegible novelty type
tokens
borders4 items
accent width
4px
character
ink-black tile outlines with occasional colored signage rails
default width
2px
style
solid
colors12 items
accent
#FFD43B
background
#7FE7FF
border
#10202A
error
#FF4A3D
info
#00A7FF
muted
#4E6C75
primary
#005BFF
secondary
#FF2E88
success
#20D66B
surface
#FFF8D6
text
#10202A
warning
#FF9F1C
motion3 items
duration
120ms
easing
steps(2, jump-end)
philosophy
movement snaps one pixel-cell at a time; hover lifts by a 4px diagonal offset rather than fading
radii5 items
full
9999px
lg
4px
md
2px
none
0
sm
0
shadows3 items
lg
8px 8px 0 #10202A
md
4px 4px 0 #10202A
sm
2px 2px 0 #10202A
spacing2 items
base
8px
scale
4, 8, 12, 16, 24, 32, 48, 64
surfaces3 items
bg pattern
subtle 12px bitmap grid plus sparse square cloud pixels
card style
hard-edged tile cards with black offset shadows and colored header rails
treatment
flat cream and cyan fields with pixel-grid overlays and no blur
typography8 items
base size
16px
body font
Atkinson Hyperlegible
google fonts url
https://fonts.googleapis.com/css2?family=Atkinson+Hyperlegible:wght@400;700&family=JetBrains+Mono:wght@500;700&family=Space+Grotesk:wght@500;700&display=swap
heading font
Space Grotesk
letter spacing
-0.015em
line height
1.45
mono font
JetBrains Mono
scale ratio
1.25
rules
composition
Lead with one dominant isometric city-map artifact that acts as product navigation; secondary panels dock to its edges like kiosks rather than forming a generic card grid.
density

High-density by design: compact controls and many small objects are allowed when aligned to the 12px bitmap grid and separated by large map-to-panel gaps.

hierarchy
Neighborhood color rails identify content families, large geometric headings name the active district, mono labels provide coordinates and status, and signpost badges carry calls to action.
signature patterns
Isometric diamond tiles appear in the hero, mini charts, and selected states; each tile has a black lower edge and a brighter top face to imply stacked city blocks.Sprite-sign buttons use a 2px black outline, 4px colored top rail, and 4px by 4px corner tab that changes neighborhood color on hover and focus.Dither bands use repeating-linear-gradient square pixels only in transition zones between sky, panels, and data heatmaps, creating texture without full-screen noise.Coordinate chips combine mono uppercase labels, two-color pixel flags, and tiny square status lamps to make navigation and state feel like signage in a miniature city.Panel shadows are always hard diagonal offsets in black or deep cobalt so depth reads as voxel-adjacent stacking, never soft material elevation.
layout
breakpoints
Desktop >= 1100px uses map-plus-kiosks; tablet 720-1099px stacks kiosks below the map; mobile < 720px turns the map into a scrollable tile strip with compact signage cards.
grid

12px base grid with an asymmetric 7/5 desktop split: dominant isometric map left, stacked operations kiosks right, and a bottom ticker for live city events.

whitespace

Whitespace is civic plaza space: a few 48-64px gaps around the map contrast with 4-12px gaps inside dense sprite modules.

guidance
do
  • Anchor every screen with a specific city-like artifact such as a route map, kiosk wall, district builder, or inventory street.
  • Assign bright colors to named modules or neighborhoods so the palette communicates structure.
  • Use crisp 2px borders, hard shadows, and stepped interaction states consistently across controls.
avoid
  • Do not use pixel art as loose icon confetti around otherwise generic SaaS layouts.
  • Do not mix rounded glassmorphism, soft shadows, or blur with the hard bitmap material logic.
  • Do not sacrifice readability for faux 8-bit typography in body copy or important data.
katagami spec
# Isometric Pixorama Brand World

## Philosophy

A dense, optimistic brand language that turns product screens into navigable isometric pixel districts: sky-cyan civic space, modular signage palettes, chunky sprite-like controls, and map tiles that organize content without becoming nostalgic pastiche.

### Values

- map-first hierarchy
- modular color zoning
- legible pixel craft
- civic playfulness
- product-specific worldbuilding

### Anti-Values

- generic retro arcade skins
- random rainbow decoration
- soft SaaS cards with pixel icons pasted on
- illegible novelty type

### Visual Character

- Use a 12px bitmap planning grid with square-corner panels, 2px hard borders, and visible 1px internal gridlines for dense but controlled placement.
- Build the primary composition around a large CSS isometric tile field using skewed diamond blocks, stacked z-index layers, and signpost labels as navigation anchors.
- Apply a sky-cyan background with saturated signage strips in magenta, amber, lime, and cobalt assigned to semantic neighborhoods rather than scattered accents.
- Render controls as sprite modules with offset black under-shadows, no blur, no gradients, stepped focus rings, and small 8-bit corner tabs.
- Use crisp bitmap-style type treatments through mono uppercase labels, tight all-caps captions, and larger geometric headings that stay readable in product contexts.

## Tokens

### Borders

- **Accent Width**: 4px
- **Character**: ink-black tile outlines with occasional colored signage rails
- **Default Width**: 2px
- **Style**: solid

### Colors

| Name | Value |
|------|-------|
| accent | `#FFD43B` |
| background | `#7FE7FF` |
| border | `#10202A` |
| error | `#FF4A3D` |
| info | `#00A7FF` |
| muted | `#4E6C75` |
| primary | `#005BFF` |
| secondary | `#FF2E88` |
| success | `#20D66B` |
| surface | `#FFF8D6` |
| text | `#10202A` |
| warning | `#FF9F1C` |

### Motion

- **Duration**: 120ms
- **Easing**: steps(2, jump-end)
- **Philosophy**: movement snaps one pixel-cell at a time; hover lifts by a 4px diagonal offset rather than fading

### Radii

- **Full**: 9999px
- **Lg**: 4px
- **Md**: 2px
- **None**: 0
- **Sm**: 0

### Shadows

- **Lg**: 8px 8px 0 #10202A
- **Md**: 4px 4px 0 #10202A
- **Sm**: 2px 2px 0 #10202A

### Spacing

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

### Surfaces

- **Bg Pattern**: subtle 12px bitmap grid plus sparse square cloud pixels
- **Card Style**: hard-edged tile cards with black offset shadows and colored header rails
- **Treatment**: flat cream and cyan fields with pixel-grid overlays and no blur

### Typography

- **Base Size**: 16px
- **Body Font**: Atkinson Hyperlegible
- **Google Fonts Url**: https://fonts.googleapis.com/css2?family=Atkinson+Hyperlegible:wght@400;700&family=JetBrains+Mono:wght@500;700&family=Space+Grotesk:wght@500;700&display=swap
- **Heading Font**: Space Grotesk
- **Letter Spacing**: -0.015em
- **Line Height**: 1.45
- **Mono Font**: JetBrains Mono
- **Scale Ratio**: 1.25

## Rules

### Composition

Lead with one dominant isometric city-map artifact that acts as product navigation; secondary panels dock to its edges like kiosks rather than forming a generic card grid.

### Density

High-density by design: compact controls and many small objects are allowed when aligned to the 12px bitmap grid and separated by large map-to-panel gaps.

### Hierarchy

Neighborhood color rails identify content families, large geometric headings name the active district, mono labels provide coordinates and status, and signpost badges carry calls to action.

### Signature Patterns

- Isometric diamond tiles appear in the hero, mini charts, and selected states; each tile has a black lower edge and a brighter top face to imply stacked city blocks.
- Sprite-sign buttons use a 2px black outline, 4px colored top rail, and 4px by 4px corner tab that changes neighborhood color on hover and focus.
- Dither bands use repeating-linear-gradient square pixels only in transition zones between sky, panels, and data heatmaps, creating texture without full-screen noise.
- Coordinate chips combine mono uppercase labels, two-color pixel flags, and tiny square status lamps to make navigation and state feel like signage in a miniature city.
- Panel shadows are always hard diagonal offsets in black or deep cobalt so depth reads as voxel-adjacent stacking, never soft material elevation.

## Layout

### Breakpoints

Desktop >= 1100px uses map-plus-kiosks; tablet 720-1099px stacks kiosks below the map; mobile < 720px turns the map into a scrollable tile strip with compact signage cards.

### Grid

12px base grid with an asymmetric 7/5 desktop split: dominant isometric map left, stacked operations kiosks right, and a bottom ticker for live city events.

### Whitespace

Whitespace is civic plaza space: a few 48-64px gaps around the map contrast with 4-12px gaps inside dense sprite modules.

## Guidance

### Do

- Anchor every screen with a specific city-like artifact such as a route map, kiosk wall, district builder, or inventory street.
- Assign bright colors to named modules or neighborhoods so the palette communicates structure.
- Use crisp 2px borders, hard shadows, and stepped interaction states consistently across controls.

### Don't

- Do not use pixel art as loose icon confetti around otherwise generic SaaS layouts.
- Do not mix rounded glassmorphism, soft shadows, or blur with the hard bitmap material logic.
- Do not sacrifice readability for faux 8-bit typography in body copy or important data.
DESIGN.md
---
version: "alpha"
name: "Isometric Pixorama Brand World"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
  accent: "#FFD43B"
  background: "#7FE7FF"
  border: "#10202A"
  error: "#FF4A3D"
  info: "#00A7FF"
  muted: "#4E6C75"
  primary: "#005BFF"
  secondary: "#FF2E88"
  success: "#20D66B"
  surface: "#FFF8D6"
  text: "#10202A"
  warning: "#FF9F1C"
typography:
  headline-lg:
    fontFamily: "Space Grotesk"
    fontSize: "1.953rem"
    fontWeight: 700
    lineHeight: 1.1
    letterSpacing: "-0.015em"
  headline-md:
    fontFamily: "Space Grotesk"
    fontSize: "1.563rem"
    fontWeight: 600
    lineHeight: 1.15
    letterSpacing: "-0.015em"
  body-md:
    fontFamily: "Atkinson Hyperlegible"
    fontSize: "16px"
    fontWeight: 400
    lineHeight: 1.45
    letterSpacing: "-0.015em"
  label-md:
    fontFamily: "JetBrains Mono"
    fontSize: "0.75rem"
    fontWeight: 600
    lineHeight: 1
    letterSpacing: "0.08em"
rounded:
  full: "9999px"
  lg: "4px"
  md: "2px"
  none: "0px"
  sm: "0px"
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"
---

# Isometric Pixorama Brand World

## Overview

A dense, optimistic brand language that turns product screens into navigable isometric pixel districts: sky-cyan civic space, modular signage palettes, chunky sprite-like controls, and map tiles that organize content without becoming nostalgic pastiche.

### Values

- map-first hierarchy
- modular color zoning
- legible pixel craft
- civic playfulness
- product-specific worldbuilding

### Anti-Values

- generic retro arcade skins
- random rainbow decoration
- soft SaaS cards with pixel icons pasted on
- illegible novelty type

### Visual Character

- Use a 12px bitmap planning grid with square-corner panels, 2px hard borders, and visible 1px internal gridlines for dense but controlled placement.
- Build the primary composition around a large CSS isometric tile field using skewed diamond blocks, stacked z-index layers, and signpost labels as navigation anchors.
- Apply a sky-cyan background with saturated signage strips in magenta, amber, lime, and cobalt assigned to semantic neighborhoods rather than scattered accents.
- Render controls as sprite modules with offset black under-shadows, no blur, no gradients, stepped focus rings, and small 8-bit corner tabs.
- Use crisp bitmap-style type treatments through mono uppercase labels, tight all-caps captions, and larger geometric headings that stay readable in product contexts.

## 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 | `#FFD43B` |
| background | `#7FE7FF` |
| border | `#10202A` |
| error | `#FF4A3D` |
| info | `#00A7FF` |
| muted | `#4E6C75` |
| primary | `#005BFF` |
| secondary | `#FF2E88` |
| success | `#20D66B` |
| surface | `#FFF8D6` |
| text | `#10202A` |
| warning | `#FF9F1C` |

## Typography

- **Headline-Lg**: Space Grotesk, 1.953rem, weight 700, line-height 1.1.
- **Headline-Md**: Space Grotesk, 1.563rem, weight 600, line-height 1.15.
- **Body-Md**: Atkinson Hyperlegible, 16px, weight 400, line-height 1.45.
- **Label-Md**: JetBrains 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

Desktop >= 1100px uses map-plus-kiosks; tablet 720-1099px stacks kiosks below the map; mobile < 720px turns the map into a scrollable tile strip with compact signage cards.

### Grid

12px base grid with an asymmetric 7/5 desktop split: dominant isometric map left, stacked operations kiosks right, and a bottom ticker for live city events.

### Whitespace

Whitespace is civic plaza space: a few 48-64px gaps around the map contrast with 4-12px gaps inside dense sprite modules.

## Elevation & Depth

### Shadows

- **Lg**: 8px 8px 0 #10202A
- **Md**: 4px 4px 0 #10202A
- **Sm**: 2px 2px 0 #10202A

## Shapes

### Rounded

- **Full**: `9999px`
- **Lg**: `4px`
- **Md**: `2px`
- **None**: `0px`
- **Sm**: `0px`

### Surfaces

- **Bg Pattern**: subtle 12px bitmap grid plus sparse square cloud pixels
- **Card Style**: hard-edged tile cards with black offset shadows and colored header rails
- **Treatment**: flat cream and cyan fields with pixel-grid overlays and no blur

### Borders

- **Accent Width**: 4px
- **Character**: ink-black tile outlines with occasional colored signage rails
- **Default Width**: 2px
- **Style**: solid

## Components

### Composition

Lead with one dominant isometric city-map artifact that acts as product navigation; secondary panels dock to its edges like kiosks rather than forming a generic card grid.

### Density

High-density by design: compact controls and many small objects are allowed when aligned to the 12px bitmap grid and separated by large map-to-panel gaps.

### Hierarchy

Neighborhood color rails identify content families, large geometric headings name the active district, mono labels provide coordinates and status, and signpost badges carry calls to action.

### Signature Patterns

- Isometric diamond tiles appear in the hero, mini charts, and selected states; each tile has a black lower edge and a brighter top face to imply stacked city blocks.
- Sprite-sign buttons use a 2px black outline, 4px colored top rail, and 4px by 4px corner tab that changes neighborhood color on hover and focus.
- Dither bands use repeating-linear-gradient square pixels only in transition zones between sky, panels, and data heatmaps, creating texture without full-screen noise.
- Coordinate chips combine mono uppercase labels, two-color pixel flags, and tiny square status lamps to make navigation and state feel like signage in a miniature city.
- Panel shadows are always hard diagonal offsets in black or deep cobalt so depth reads as voxel-adjacent stacking, never soft material elevation.

## 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-019e69a6-68f3-7121-94fd-e67b83e742e0/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 Anchor every screen with a specific city-like artifact such as a route map, kiosk wall, district builder, or inventory street.
- Do Assign bright colors to named modules or neighborhoods so the palette communicates structure.
- Do Use crisp 2px borders, hard shadows, and stepped interaction states consistently across controls.
- Don't Do not use pixel art as loose icon confetti around otherwise generic SaaS layouts.
- Don't Do not mix rounded glassmorphism, soft shadows, or blur with the hard bitmap material logic.
- Don't Do not sacrifice readability for faux 8-bit typography in body copy or important data.
shadcn/ui theme
```json
{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "isometric-pixorama-brand-world",
  "type": "registry:theme",
  "title": "Isometric Pixorama Brand World shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#7FE7FF",
      "foreground": "#10202A",
      "card": "#FFF8D6",
      "card-foreground": "#10202A",
      "popover": "#FFF8D6",
      "popover-foreground": "#10202A",
      "primary": "#005BFF",
      "primary-foreground": "#ffffff",
      "secondary": "#FF2E88",
      "secondary-foreground": "#ffffff",
      "muted": "#4E6C75",
      "muted-foreground": "#10202A",
      "accent": "#FFD43B",
      "accent-foreground": "#111111",
      "destructive": "#FF4A3D",
      "border": "#10202A",
      "input": "#10202A",
      "ring": "#FFD43B",
      "chart-1": "#005BFF",
      "chart-2": "#FF2E88",
      "chart-3": "#FFD43B",
      "chart-4": "#20D66B",
      "chart-5": "#FF9F1C",
      "sidebar": "#FFF8D6",
      "sidebar-foreground": "#10202A",
      "sidebar-primary": "#005BFF",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#00A7FF",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#10202A",
      "sidebar-ring": "#FFD43B",
      "radius": "2px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#005BFF",
      "primary-foreground": "#ffffff",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#FFD43B",
      "accent-foreground": "#111111",
      "destructive": "#FF4A3D",
      "border": "#303642",
      "input": "#303642",
      "ring": "#FFD43B",
      "chart-1": "#005BFF",
      "chart-2": "#FF2E88",
      "chart-3": "#FFD43B",
      "chart-4": "#20D66B",
      "chart-5": "#FF9F1C",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#005BFF",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#FFD43B",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#303642",
      "sidebar-ring": "#FFD43B",
      "radius": "2px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "en-019e69a6-68f3-7121-94fd-e67b83e742e0",
    "slug": "isometric-pixorama-brand-world",
    "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

Design Language Preview

Isometric Pixorama Brand World

Color Palette

primary
secondary
accent
background
surface
text
muted
border
error
success
warning
info

Typography

h1

Heading One

h2

Heading Two

h3

Heading Three

h4

Heading Four

body

Body text demonstrates the reading experience. Good typography is invisible — it lets the content speak without drawing attention to the letterforms themselves.

caption

Caption text for supplementary information and metadata.

code
const theme = applyTokens(designLanguage);
render(<App theme={theme} />);

Buttons

Form Controls

Navigation

tabs
Overview content area with contextual information about the design language.
segmented control
dropdown menu

Feedback & Status

badges
NewDefaultActivePendingErrorOutline
alerts
Info: A new version is available.
Success: Changes saved successfully.
Warning: Storage is almost full.
Error: Failed to process request.
progress
66% complete
tooltip
avatar
AKJDML

Containers & Overlays

card

Card Title

Cards group related content and actions. This example shows a basic content card with a title and description.

accordion

Design tokens are the atomic values of a design system — colors, spacing, typography, and other values stored as key-value pairs.

dialog
separator

Data Display

table
NameStatusCategoryScore
Neo BrutalismPublishedMaximalist94
Aero GlassDraftSpatial87
Signal UIReviewEnterprise91
stat cards
Languages
42
+12%
Elements
3,150
+8%
Usage
18.4k
+23%
DESIGN.md

at a glance

Palette

Typography

headline-lgSpace Grotesk · 31px · 700

The quick brown fox jumps

headline-mdSpace Grotesk · 25px · 600

The quick brown fox jumps

body-mdAtkinson Hyperlegible · 16px · 400

The quick brown fox jumps

label-mdJetBrains 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

Shape

full9999px
lg4px
md2px
none0px
sm0px
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: #7FE7FF;
  --foreground: #10202A;
  --card: #FFF8D6;
  --card-foreground: #10202A;
  --popover: #FFF8D6;
  --popover-foreground: #10202A;
  --primary: #005BFF;
  --primary-foreground: #ffffff;
  --secondary: #FF2E88;
  --secondary-foreground: #ffffff;
  --muted: #4E6C75;
  --muted-foreground: #10202A;
  --accent: #FFD43B;
  --accent-foreground: #111111;
  --destructive: #FF4A3D;
  --border: #10202A;
  --input: #10202A;
  --ring: #FFD43B;
  --chart-1: #005BFF;
  --chart-2: #FF2E88;
  --chart-3: #FFD43B;
  --chart-4: #20D66B;
  --chart-5: #FF9F1C;
  --sidebar: #FFF8D6;
  --sidebar-foreground: #10202A;
  --sidebar-primary: #005BFF;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #00A7FF;
  --sidebar-accent-foreground: #ffffff;
  --sidebar-border: #10202A;
  --sidebar-ring: #FFD43B;
  --radius: 2px;
}

.dark {
  --background: #0f1115;
  --foreground: #f8fafc;
  --card: #181b22;
  --card-foreground: #f8fafc;
  --popover: #181b22;
  --popover-foreground: #f8fafc;
  --primary: #005BFF;
  --primary-foreground: #ffffff;
  --secondary: #252a33;
  --secondary-foreground: #f8fafc;
  --muted: #252a33;
  --muted-foreground: #a1a1aa;
  --accent: #FFD43B;
  --accent-foreground: #111111;
  --destructive: #FF4A3D;
  --border: #303642;
  --input: #303642;
  --ring: #FFD43B;
  --chart-1: #005BFF;
  --chart-2: #FF2E88;
  --chart-3: #FFD43B;
  --chart-4: #20D66B;
  --chart-5: #FF9F1C;
  --sidebar: #181b22;
  --sidebar-foreground: #f8fafc;
  --sidebar-primary: #005BFF;
  --sidebar-primary-foreground: #ffffff;
  --sidebar-accent: #FFD43B;
  --sidebar-accent-foreground: #111111;
  --sidebar-border: #303642;
  --sidebar-ring: #FFD43B;
  --radius: 2px;
}
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 IsometricPixoramaBrandWorldShadcnKit() {
  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">Isometric Pixorama Brand World</h2>
          <p className="mt-1 max-w-xl text-sm text-muted-foreground">
            Use the Katagami registry theme, then compose these shadcn primitives
            with the language-specific component recipes.
          </p>
        </div>
        <Button>Apply theme</Button>
      </div>

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

      <Card>
        <CardHeader>
          <CardTitle>Component recipe</CardTitle>
          <CardDescription>
            Replace this starter content with the agent-authored product scene
            from components.md and preview-shots.json.
          </CardDescription>
        </CardHeader>
        <CardContent className="grid gap-3 sm:grid-cols-[1fr_auto]">
          <Input defaultValue="Tokenized shadcn surface" aria-label="Recipe name" />
          <Button variant="secondary">Preview state</Button>
        </CardContent>
        <CardFooter className="justify-between">
          <Badge>Ready</Badge>
          <Button variant="outline">Copy recipe</Button>
        </CardFooter>
      </Card>
    </section>
  );
}
theme JSONcompatibility fallback
{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "isometric-pixorama-brand-world",
  "type": "registry:theme",
  "title": "Isometric Pixorama Brand World shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#7FE7FF",
      "foreground": "#10202A",
      "card": "#FFF8D6",
      "card-foreground": "#10202A",
      "popover": "#FFF8D6",
      "popover-foreground": "#10202A",
      "primary": "#005BFF",
      "primary-foreground": "#ffffff",
      "secondary": "#FF2E88",
      "secondary-foreground": "#ffffff",
      "muted": "#4E6C75",
      "muted-foreground": "#10202A",
      "accent": "#FFD43B",
      "accent-foreground": "#111111",
      "destructive": "#FF4A3D",
      "border": "#10202A",
      "input": "#10202A",
      "ring": "#FFD43B",
      "chart-1": "#005BFF",
      "chart-2": "#FF2E88",
      "chart-3": "#FFD43B",
      "chart-4": "#20D66B",
      "chart-5": "#FF9F1C",
      "sidebar": "#FFF8D6",
      "sidebar-foreground": "#10202A",
      "sidebar-primary": "#005BFF",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#00A7FF",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#10202A",
      "sidebar-ring": "#FFD43B",
      "radius": "2px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#005BFF",
      "primary-foreground": "#ffffff",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#FFD43B",
      "accent-foreground": "#111111",
      "destructive": "#FF4A3D",
      "border": "#303642",
      "input": "#303642",
      "ring": "#FFD43B",
      "chart-1": "#005BFF",
      "chart-2": "#FF2E88",
      "chart-3": "#FFD43B",
      "chart-4": "#20D66B",
      "chart-5": "#FF9F1C",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#005BFF",
      "sidebar-primary-foreground": "#ffffff",
      "sidebar-accent": "#FFD43B",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#303642",
      "sidebar-ring": "#FFD43B",
      "radius": "2px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "en-019e69a6-68f3-7121-94fd-e67b83e742e0",
    "slug": "isometric-pixorama-brand-world",
    "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"
      ]
    }
  }
}
component recipescompatibility fallback
# Isometric Pixorama Brand World shadcn/ui Components

Artifact: `component-recipes-v1`
Author: `katagami-ui-projection`
Language ID: `en-019e69a6-68f3-7121-94fd-e67b83e742e0`
Slug: `isometric-pixorama-brand-world`

## Intent

A dense, optimistic brand language that turns product screens into navigable isometric pixel districts: sky-cyan civic space, modular signage palettes, chunky sprite-like controls, and map tiles that organize content without becoming nostalgic pastiche.

## 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": "#FFD43B",
  "background": "#7FE7FF",
  "border": "#10202A",
  "error": "#FF4A3D",
  "info": "#00A7FF",
  "muted": "#4E6C75",
  "primary": "#005BFF",
  "secondary": "#FF2E88",
  "success": "#20D66B",
  "surface": "#FFF8D6",
  "text": "#10202A",
  "warning": "#FF9F1C"
}

Typography:

{
  "base_size": "16px",
  "body_font": "Atkinson Hyperlegible",
  "google_fonts_url": "https://fonts.googleapis.com/css2?family=Atkinson+Hyperlegible:wght@400;700&family=JetBrains+Mono:wght@500;700&family=Space+Grotesk:wght@500;700&display=swap",
  "heading_font": "Space Grotesk",
  "letter_spacing": "-0.015em",
  "line_height": 1.45,
  "mono_font": "JetBrains Mono",
  "scale_ratio": 1.25
}

## Visual character to preserve

- Use a 12px bitmap planning grid with square-corner panels, 2px hard borders, and visible 1px internal gridlines for dense but controlled placement.
- Build the primary composition around a large CSS isometric tile field using skewed diamond blocks, stacked z-index layers, and signpost labels as navigation anchors.
- Apply a sky-cyan background with saturated signage strips in magenta, amber, lime, and cobalt assigned to semantic neighborhoods rather than scattered accents.
- Render controls as sprite modules with offset black under-shadows, no blur, no gradients, stepped focus rings, and small 8-bit corner tabs.
- Use crisp bitmap-style type treatments through mono uppercase labels, tight all-caps captions, and larger geometric headings that stay readable in product contexts.

## ShadSync visual profile

{
  "family": "system",
  "material": "flat",
  "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/isometric-pixorama-brand-world/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: Anchor every screen with a specific city-like artifact such as a route map, kiosk wall, district builder, or inventory street.; Assign bright colors to named modules or neighborhoods so the palette communicates structure.; Use crisp 2px borders, hard shadows, and stepped interaction states consistently across controls.
- Do not: Do not use pixel art as loose icon confetti around otherwise generic SaaS layouts.; Do not mix rounded glassmorphism, soft shadows, or blur with the hard bitmap material logic.; Do not sacrifice readability for faux 8-bit typography in body copy or important data.

## 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 IsometricPixoramaBrandWorldShadcnKit() {
  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">Isometric Pixorama Brand World</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": "Desktop >= 1100px uses map-plus-kiosks; tablet 720-1099px stacks kiosks below the map; mobile < 720px turns the map into a scrollable tile strip with compact signage cards.",
  "grid": "12px base grid with an asymmetric 7/5 desktop split: dominant isometric map left, stacked operations kiosks right, and a bottom ticker for live city events.",
  "whitespace": "Whitespace is civic plaza space: a few 48-64px gaps around the map contrast with 4-12px gaps inside dense sprite modules."
}
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-019e69a6-68f3-7121-94fd-e67b83e742e0",
    "name": "Isometric Pixorama Brand World",
    "slug": "isometric-pixorama-brand-world"
  },
  "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 a 12px bitmap planning grid with square-corner panels, 2px hard borders, and visible 1px internal gridlines for dense but controlled placement.",
    "Build the primary composition around a large CSS isometric tile field using skewed diamond blocks, stacked z-index layers, and signpost labels as navigation anchors.",
    "Apply a sky-cyan background with saturated signage strips in magenta, amber, lime, and cobalt assigned to semantic neighborhoods rather than scattered accents.",
    "Render controls as sprite modules with offset black under-shadows, no blur, no gradients, stepped focus rings, and small 8-bit corner tabs.",
    "Use crisp bitmap-style type treatments through mono uppercase labels, tight all-caps captions, and larger geometric headings that stay readable in product contexts."
  ],
  "visualProfile": {
    "family": "system",
    "material": "flat",
    "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": "Isometric Pixorama Brand World 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": [
      "Anchor every screen with a specific city-like artifact such as a route map, kiosk wall, district builder, or inventory street.",
      "Assign bright colors to named modules or neighborhoods so the palette communicates structure.",
      "Use crisp 2px borders, hard shadows, and stepped interaction states consistently across controls."
    ],
    "dont": [
      "Do not use pixel art as loose icon confetti around otherwise generic SaaS layouts.",
      "Do not mix rounded glassmorphism, soft shadows, or blur with the hard bitmap material logic.",
      "Do not sacrifice readability for faux 8-bit typography in body copy or important data."
    ]
  }
}