back to gallery
design language·apsis

Apsis

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
Apsis is a review-board language for operational telemetry. It reads dense flight data like a long-form dossier rather than a consumer app: a narrative headline zone, a central evidence field, and supporting telemetry rails. Every reading carries a coordinate; every finding carries a rule. It privileges calm dark contrast, disciplined annotation, and publication-grade hierarchy over neon spectacle. A faithful refinement of Mission-Control Review — same idea, same charcoal field and signal-ink palette family — brought up to standard in its radius system, accent discipline, button and form systems, and no-JS motion gate.
values
Operational clarity over cinematic clutterEditorial hierarchy that turns telemetry into a readable narrativeEvery reading located: a coordinate rail and per-section coordinates orient the pageEvidence-first annotation, rule-connected to the chart or table it explainsHigh-contrast charcoal surfaces with accessibility-aware restraintAccent spent only as signal ink — cyan reads, amber marks thresholds, red flags a real fault
anti-values
×Arcade cyberpunk glow without information structure×White or muddy pastel grounds, gradient washes, neon spectacle×Soft generic SaaS cards that erase the technical gravity×Floating helper text divorced from the evidence it explains×Accent colour spent on decoration rather than a real status×The oversized italic-serif AI-startup default headline
tokens
colors15 items
bg
#081017
surface
#101A24
surface_2
#16242F
recess
#050B11
text
#E7F1F7
muted
#8A9BAE
border
#233545
rule
#1B2A38
accent
#9BE7FF
accent_2
#F6B756
on_accent
#061019
success
#79E3A0
warning
#F6B756
error
#FF6D6D
info
#67C6FF
typography8 items
base size
17px
body font
IBM Plex Sans
heading font
Space Grotesk
mono font
IBM Plex Mono
heading weight
600
heading transform
none
letter spacing
-0.02em
google fonts url
https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=IBM+Plex+Sans:wght@400;500;600;700&family=Space+Grotesk:wght@500;600;700&display=swap
radii5 items
none
0
sm
0
md
16px
lg
24px
full
9999px
shadows3 items
sm
inset 0 0 0 1px rgba(155,231,255,0.06)
md
0 24px 60px rgba(0,0,0,0.42)
lg
0 48px 120px rgba(0,0,0,0.55)
spacing2 items
base
8px
scale
4, 8, 12, 16, 24, 32, 48, 64
surfaces3 items
treatment
flat clipped-notch technical plates over a charcoal field; a 2px cyan status bar across each plate top; no glass, no gradient washes
card style
Squared plates with one clipped corner notch (top-right or bottom-left) built with clip-path, a faint vertical surface gradient (#16242F to #101A24), a hairline #233545 border, and a 2px cyan top status bar — engineered review sheets, never rounded consumer cards.
bg pattern
faint 64px blueprint grid over a deep charcoal #081017 field
borders4 items
default width
1px
accent width
0
style
solid
character
Precise aerospace drafting hairlines (#233545) for structure only; colour is carried by signal-ink status dots and the cyan top status bar, never by an accent edge on a card.
motion3 items
duration
180ms
easing
cubic-bezier(0.22, 1, 0.36, 1)
philosophy
Deliberate. The settled, fully-rendered page is the default and is visible with no JavaScript; reveals are layered on top behind an .mtn class on <html> and respect prefers-reduced-motion.
rules
composition
Compose screens like review boards: a narrative headline zone, a central evidence field, and supporting telemetry rails, oriented by a left datum rail of coordinate ticks. Let the conclusion stay dominant; rails support the decision thread without competing. Never box navigation into a pill or floating card.
hierarchy
Use large Space Grotesk deck titles for story-level conclusions and compact IBM Plex Mono for metric-level readouts, coordinates, and procedural metadata, so operators distinguish narrative from instrument at a glance. Cyan reads; amber marks thresholds and active coordinates; red flags a real fault.
density
High density but heavily gridded: telemetry strips and ledgers can be tight as long as labels, separators, status dots, and contrast keep them scannable; every dense cluster has a quieter band or annotation nearby.
signature
A left datum coordinate rail; clipped-notch technical plates with a 2px cyan top status bar; section headers of amber mono coordinate overline + title + rule into the grid; telemetry strips of evenly spaced readout cells with signal-ink status dots; and rule-connected editorial annotations inside the grid.
layout
grid
A persistent left datum rail (or sidebar nav on the dashboard) plus a dominant central content stack; content caps and centres around 1320-1480px and only the landing hero spans 100vw.
whitespace
Intentional and editorial: tight within telemetry strips and ticks, generous around section transitions and above every title, used to separate evidence clusters from narrative conclusions.
density

Light and spacious at the masthead and hero, denser through telemetry strips, ledgers, and command forms, quieter again at the audit footer.

responsive
Renders from ~390px mobile to 2560px+ ultra-wide; tablet drops the datum rail to a top bar, mobile collapses to a single stacked stream, hides non-essential nav and table columns, makes controls full width, and never overflows horizontally; grids shrink with minmax(0,1fr) + min-width:0.
breakpoints
mobile
390px
tablet
768px
desktop
1200px
reflow
1100px and 960px and 680px
guidance
do
  • Orient the page with a left datum rail and per-section amber coordinates; give every reading a location.
  • Build modules as clipped-notch plates with a cyan top status bar; pad above every title.
  • Lead with the narrative conclusion in Space Grotesk; set readouts, coordinates, and timestamps in IBM Plex Mono.
  • Keep cyan as the read, amber for thresholds and active coordinates, red for a real fault; hold accents like highlighters.
  • Group numbers into telemetry strips with evenly spaced cells and signal-ink status dots.
  • Rule-connect annotations into the chart or table they explain; let findings live inside the grid.
  • Explicitly style every form control with a visible cyan focus ring; render the settled state with no JavaScript.
avoid
  • Do not default to a white or muddy ground, or flood panels with neon gradients.
  • Do not use rounded consumer-product cards, in-between radii, or nested cards.
  • Do not give a plate a lone accent edge; colour rides the top status bar and status dots, not a side edge.
  • Do not box navigation into a pill or floating rounded card.
  • Do not spend accent on decoration, hide operational metadata behind minimalism, or use the oversized italic-serif AI-default headline.
  • Do not use emoji on buttons or symbol glyphs in copy; use inline SVG primitives.
imagery
pairs with

datum

summary
Spacecraft and orbital subjects rendered as mission-control review plates in the Datum technique: the subject crisp and dominant on a deep charcoal field over a faint blueprint grid, dressed with hairline cyan dimension rules and calibration ticks, amber coordinate crosshairs, sparse monospace readouts and status dots in the margins, and clipped corner notches framing the plate.
subjects
orbital spacecraft / deep-space orbiterhigh-gain dish antenna and solar arrayslaunch vehicle stack in sectionorbital trajectory / apsis diagramground-station antennareaction-wheel and thruster assemblies
usage
One full-bleed landing hero in the Datum technique composed with a calm left third for the overlay; elsewhere keep imagery to plate previews and feature studies with leader-line callouts. End every prompt with NO text, NO letters, NO logos.
katagami spec
# Apsis

## Philosophy

Apsis is a review-board language for operational telemetry. It reads dense flight data like a long-form dossier rather than a consumer app: a narrative headline zone, a central evidence field, and supporting telemetry rails. Every reading carries a coordinate; every finding carries a rule. It privileges calm dark contrast, disciplined annotation, and publication-grade hierarchy over neon spectacle. A faithful refinement of Mission-Control Review — same idea, same charcoal field and signal-ink palette family — brought up to standard in its radius system, accent discipline, button and form systems, and no-JS motion gate.

### Values

- Operational clarity over cinematic clutter
- Editorial hierarchy that turns telemetry into a readable narrative
- Every reading located: a coordinate rail and per-section coordinates orient the page
- Evidence-first annotation, rule-connected to the chart or table it explains
- High-contrast charcoal surfaces with accessibility-aware restraint
- Accent spent only as signal ink — cyan reads, amber marks thresholds, red flags a real fault

### Anti-Values

- Arcade cyberpunk glow without information structure
- White or muddy pastel grounds, gradient washes, neon spectacle
- Soft generic SaaS cards that erase the technical gravity
- Floating helper text divorced from the evidence it explains
- Accent colour spent on decoration rather than a real status
- The oversized italic-serif AI-startup default headline

### Visual Character

- A continuous left datum rail carries coordinate ticks (LAT / REV / LON) down the page, giving every section a fixed location in the flight.
- Every major module is a clipped-notch plate — squared corners with one clipped notch and a 2px cyan top status bar — so containers read like engineered review sheets, never soft consumer cards.
- Section headers pair an amber monospace coordinate overline with the title and a horizontal rule that continues into the grid, turning each panel title into a measured coordinate reference.
- Numeric readouts cluster into telemetry strips with evenly spaced cells, thin separators, and tiny signal-ink status dots for instrument-panel rhythm; Space Grotesk decks carry conclusions while IBM Plex Mono carries readouts.
- Editorial annotations sit inside the grid, rule-connected by a left signal-ink rule to the chart or table they explain — commentary as structure, not floating helper text.

## Tokens

### Colors

| Name | Value |
|------|-------|
| bg | `#081017` |
| surface | `#101A24` |
| surface_2 | `#16242F` |
| recess | `#050B11` |
| text | `#E7F1F7` |
| muted | `#8A9BAE` |
| border | `#233545` |
| rule | `#1B2A38` |
| accent | `#9BE7FF` |
| accent_2 | `#F6B756` |
| on_accent | `#061019` |
| success | `#79E3A0` |
| warning | `#F6B756` |
| error | `#FF6D6D` |
| info | `#67C6FF` |

### Typography

- **Base Size**: 17px
- **Body Font**: IBM Plex Sans
- **Heading Font**: Space Grotesk
- **Mono Font**: IBM Plex Mono
- **Heading Weight**: 600
- **Heading Transform**: none
- **Letter Spacing**: -0.02em
- **Google Fonts Url**: https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=IBM+Plex+Sans:wght@400;500;600;700&family=Space+Grotesk:wght@500;600;700&display=swap

### Radii

- **None**: 0
- **Sm**: 0
- **Md**: 16px
- **Lg**: 24px
- **Full**: 9999px

### Shadows

- **Sm**: inset 0 0 0 1px rgba(155,231,255,0.06)
- **Md**: 0 24px 60px rgba(0,0,0,0.42)
- **Lg**: 0 48px 120px rgba(0,0,0,0.55)

### Spacing

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

### Surfaces

- **Treatment**: flat clipped-notch technical plates over a charcoal field; a 2px cyan status bar across each plate top; no glass, no gradient washes
- **Card Style**: Squared plates with one clipped corner notch (top-right or bottom-left) built with clip-path, a faint vertical surface gradient (#16242F to #101A24), a hairline #233545 border, and a 2px cyan top status bar — engineered review sheets, never rounded consumer cards.
- **Bg Pattern**: faint 64px blueprint grid over a deep charcoal #081017 field

### Borders

- **Default Width**: 1px
- **Accent Width**: 0
- **Style**: solid
- **Character**: Precise aerospace drafting hairlines (#233545) for structure only; colour is carried by signal-ink status dots and the cyan top status bar, never by an accent edge on a card.

### Motion

- **Duration**: 180ms
- **Easing**: cubic-bezier(0.22, 1, 0.36, 1)
- **Philosophy**: Deliberate. The settled, fully-rendered page is the default and is visible with no JavaScript; reveals are layered on top behind an .mtn class on <html> and respect prefers-reduced-motion.

## Rules

### Composition

Compose screens like review boards: a narrative headline zone, a central evidence field, and supporting telemetry rails, oriented by a left datum rail of coordinate ticks. Let the conclusion stay dominant; rails support the decision thread without competing. Never box navigation into a pill or floating card.

### Hierarchy

Use large Space Grotesk deck titles for story-level conclusions and compact IBM Plex Mono for metric-level readouts, coordinates, and procedural metadata, so operators distinguish narrative from instrument at a glance. Cyan reads; amber marks thresholds and active coordinates; red flags a real fault.

### Density

High density but heavily gridded: telemetry strips and ledgers can be tight as long as labels, separators, status dots, and contrast keep them scannable; every dense cluster has a quieter band or annotation nearby.

### Signature

A left datum coordinate rail; clipped-notch technical plates with a 2px cyan top status bar; section headers of amber mono coordinate overline + title + rule into the grid; telemetry strips of evenly spaced readout cells with signal-ink status dots; and rule-connected editorial annotations inside the grid.

## Layout

### Grid

A persistent left datum rail (or sidebar nav on the dashboard) plus a dominant central content stack; content caps and centres around 1320-1480px and only the landing hero spans 100vw.

### Whitespace

Intentional and editorial: tight within telemetry strips and ticks, generous around section transitions and above every title, used to separate evidence clusters from narrative conclusions.

### Density

Light and spacious at the masthead and hero, denser through telemetry strips, ledgers, and command forms, quieter again at the audit footer.

### Responsive

Renders from ~390px mobile to 2560px+ ultra-wide; tablet drops the datum rail to a top bar, mobile collapses to a single stacked stream, hides non-essential nav and table columns, makes controls full width, and never overflows horizontally; grids shrink with minmax(0,1fr) + min-width:0.

### Breakpoints

- **Mobile**: 390px
- **Tablet**: 768px
- **Desktop**: 1200px
- **Reflow**: 1100px and 960px and 680px

## Guidance

### Do

- Orient the page with a left datum rail and per-section amber coordinates; give every reading a location.
- Build modules as clipped-notch plates with a cyan top status bar; pad above every title.
- Lead with the narrative conclusion in Space Grotesk; set readouts, coordinates, and timestamps in IBM Plex Mono.
- Keep cyan as the read, amber for thresholds and active coordinates, red for a real fault; hold accents like highlighters.
- Group numbers into telemetry strips with evenly spaced cells and signal-ink status dots.
- Rule-connect annotations into the chart or table they explain; let findings live inside the grid.
- Explicitly style every form control with a visible cyan focus ring; render the settled state with no JavaScript.

### Don't

- Do not default to a white or muddy ground, or flood panels with neon gradients.
- Do not use rounded consumer-product cards, in-between radii, or nested cards.
- Do not give a plate a lone accent edge; colour rides the top status bar and status dots, not a side edge.
- Do not box navigation into a pill or floating rounded card.
- Do not spend accent on decoration, hide operational metadata behind minimalism, or use the oversized italic-serif AI-default headline.
- Do not use emoji on buttons or symbol glyphs in copy; use inline SVG primitives.

### Accessibility

High-contrast light text and signal ink on charcoal, all clearing WCAG AA; status carried by colour AND label/shape; mono readouts stay 14.5px+, body 17px+; visible 2px cyan focus rings with offset; touch targets at least 44px; every form control explicitly styled with no browser defaults; the fully-rendered state is visible with no JavaScript and motion respects prefers-reduced-motion.

## Imagery Direction

### Pairs With

datum

### Summary

Spacecraft and orbital subjects rendered as mission-control review plates in the Datum technique: the subject crisp and dominant on a deep charcoal field over a faint blueprint grid, dressed with hairline cyan dimension rules and calibration ticks, amber coordinate crosshairs, sparse monospace readouts and status dots in the margins, and clipped corner notches framing the plate.

### Subjects

- orbital spacecraft / deep-space orbiter
- high-gain dish antenna and solar arrays
- launch vehicle stack in section
- orbital trajectory / apsis diagram
- ground-station antenna
- reaction-wheel and thruster assemblies

### Usage

One full-bleed landing hero in the Datum technique composed with a calm left third for the overlay; elsewhere keep imagery to plate previews and feature studies with leader-line callouts. End every prompt with NO text, NO letters, NO logos.
DESIGN.md
---
version: "alpha"
name: "Apsis"
description: "Agent-curated design language exported from Katagami as DESIGN.md."
colors:
  bg: "#081017"
  surface: "#101A24"
  surface_2: "#16242F"
  recess: "#050B11"
  text: "#E7F1F7"
  muted: "#8A9BAE"
  border: "#233545"
  rule: "#1B2A38"
  accent: "#9BE7FF"
  accent_2: "#F6B756"
  on_accent: "#061019"
  success: "#79E3A0"
  warning: "#F6B756"
  error: "#FF6D6D"
  info: "#67C6FF"
typography:
  headline-lg:
    fontFamily: "Space Grotesk"
    fontSize: "2.075rem"
    fontWeight: 700
    lineHeight: 1.1
    letterSpacing: "-0.02em"
  headline-md:
    fontFamily: "Space Grotesk"
    fontSize: "1.66rem"
    fontWeight: 600
    lineHeight: 1.15
    letterSpacing: "-0.02em"
  body-md:
    fontFamily: "IBM Plex Sans"
    fontSize: "17px"
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: "-0.02em"
  label-md:
    fontFamily: "IBM Plex Mono"
    fontSize: "0.75rem"
    fontWeight: 600
    lineHeight: 1
    letterSpacing: "0.08em"
rounded:
  none: "0px"
  sm: "0px"
  md: "16px"
  lg: "24px"
  full: "9999px"
spacing:
  base: "8px"
  xs: "4px"
  sm: "8px"
  md: "12px"
  lg: "16px"
  xl: "24px"
  2xl: "32px"
  3xl: "48px"
  4xl: "64px"
components:
  color-reference-bg:
    backgroundColor: "{colors.bg}"
  color-reference-surface:
    backgroundColor: "{colors.surface}"
  color-reference-surface_2:
    backgroundColor: "{colors.surface_2}"
  color-reference-recess:
    backgroundColor: "{colors.recess}"
  color-reference-text:
    backgroundColor: "{colors.text}"
  color-reference-muted:
    backgroundColor: "{colors.muted}"
  color-reference-border:
    backgroundColor: "{colors.border}"
  color-reference-rule:
    backgroundColor: "{colors.rule}"
  color-reference-accent:
    backgroundColor: "{colors.accent}"
  color-reference-accent_2:
    backgroundColor: "{colors.accent_2}"
  color-reference-on_accent:
    backgroundColor: "{colors.on_accent}"
  color-reference-success:
    backgroundColor: "{colors.success}"
  color-reference-warning:
    backgroundColor: "{colors.warning}"
  color-reference-error:
    backgroundColor: "{colors.error}"
  color-reference-info:
    backgroundColor: "{colors.info}"
  button-primary:
    backgroundColor: "{colors.accent}"
    textColor: "#000000"
    typography: "{typography.label-md}"
    rounded: "{rounded.md}"
    padding: "{spacing.md}"
  card-surface:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.text}"
    rounded: "{rounded.md}"
    padding: "{spacing.md}"
  input-default:
    backgroundColor: "{colors.surface}"
    textColor: "{colors.text}"
    rounded: "{rounded.md}"
    height: "44px"
---

# Apsis

## Overview

Apsis is a review-board language for operational telemetry. It reads dense flight data like a long-form dossier rather than a consumer app: a narrative headline zone, a central evidence field, and supporting telemetry rails. Every reading carries a coordinate; every finding carries a rule. It privileges calm dark contrast, disciplined annotation, and publication-grade hierarchy over neon spectacle. A faithful refinement of Mission-Control Review — same idea, same charcoal field and signal-ink palette family — brought up to standard in its radius system, accent discipline, button and form systems, and no-JS motion gate.

### Values

- Operational clarity over cinematic clutter
- Editorial hierarchy that turns telemetry into a readable narrative
- Every reading located: a coordinate rail and per-section coordinates orient the page
- Evidence-first annotation, rule-connected to the chart or table it explains
- High-contrast charcoal surfaces with accessibility-aware restraint
- Accent spent only as signal ink — cyan reads, amber marks thresholds, red flags a real fault

### Anti-Values

- Arcade cyberpunk glow without information structure
- White or muddy pastel grounds, gradient washes, neon spectacle
- Soft generic SaaS cards that erase the technical gravity
- Floating helper text divorced from the evidence it explains
- Accent colour spent on decoration rather than a real status
- The oversized italic-serif AI-startup default headline

### Visual Character

- A continuous left datum rail carries coordinate ticks (LAT / REV / LON) down the page, giving every section a fixed location in the flight.
- Every major module is a clipped-notch plate — squared corners with one clipped notch and a 2px cyan top status bar — so containers read like engineered review sheets, never soft consumer cards.
- Section headers pair an amber monospace coordinate overline with the title and a horizontal rule that continues into the grid, turning each panel title into a measured coordinate reference.
- Numeric readouts cluster into telemetry strips with evenly spaced cells, thin separators, and tiny signal-ink status dots for instrument-panel rhythm; Space Grotesk decks carry conclusions while IBM Plex Mono carries readouts.
- Editorial annotations sit inside the grid, rule-connected by a left signal-ink rule to the chart or table they explain — commentary as structure, not floating helper text.

## Colors

Use the YAML color tokens as the normative palette. The prose below names the roles agents should preserve when generating UI.

| Token | Value |
|-------|-------|
| bg | `#081017` |
| surface | `#101A24` |
| surface_2 | `#16242F` |
| recess | `#050B11` |
| text | `#E7F1F7` |
| muted | `#8A9BAE` |
| border | `#233545` |
| rule | `#1B2A38` |
| accent | `#9BE7FF` |
| accent_2 | `#F6B756` |
| on_accent | `#061019` |
| success | `#79E3A0` |
| warning | `#F6B756` |
| error | `#FF6D6D` |
| info | `#67C6FF` |

## Typography

- **Headline-Lg**: Space Grotesk, 2.075rem, weight 700, line-height 1.1.
- **Headline-Md**: Space Grotesk, 1.66rem, weight 600, line-height 1.15.
- **Body-Md**: IBM Plex Sans, 17px, weight 400, line-height 1.5.
- **Label-Md**: IBM Plex 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`

### Grid

A persistent left datum rail (or sidebar nav on the dashboard) plus a dominant central content stack; content caps and centres around 1320-1480px and only the landing hero spans 100vw.

### Whitespace

Intentional and editorial: tight within telemetry strips and ticks, generous around section transitions and above every title, used to separate evidence clusters from narrative conclusions.

### Density

Light and spacious at the masthead and hero, denser through telemetry strips, ledgers, and command forms, quieter again at the audit footer.

### Responsive

Renders from ~390px mobile to 2560px+ ultra-wide; tablet drops the datum rail to a top bar, mobile collapses to a single stacked stream, hides non-essential nav and table columns, makes controls full width, and never overflows horizontally; grids shrink with minmax(0,1fr) + min-width:0.

### Breakpoints

- **Mobile**: 390px
- **Tablet**: 768px
- **Desktop**: 1200px
- **Reflow**: 1100px and 960px and 680px

## Elevation & Depth

### Shadows

- **Sm**: inset 0 0 0 1px rgba(155,231,255,0.06)
- **Md**: 0 24px 60px rgba(0,0,0,0.42)
- **Lg**: 0 48px 120px rgba(0,0,0,0.55)

## Shapes

### Rounded

- **None**: `0px`
- **Sm**: `0px`
- **Md**: `16px`
- **Lg**: `24px`
- **Full**: `9999px`

### Surfaces

- **Treatment**: flat clipped-notch technical plates over a charcoal field; a 2px cyan status bar across each plate top; no glass, no gradient washes
- **Card Style**: Squared plates with one clipped corner notch (top-right or bottom-left) built with clip-path, a faint vertical surface gradient (#16242F to #101A24), a hairline #233545 border, and a 2px cyan top status bar — engineered review sheets, never rounded consumer cards.
- **Bg Pattern**: faint 64px blueprint grid over a deep charcoal #081017 field

### Borders

- **Default Width**: 1px
- **Accent Width**: 0
- **Style**: solid
- **Character**: Precise aerospace drafting hairlines (#233545) for structure only; colour is carried by signal-ink status dots and the cyan top status bar, never by an accent edge on a card.

## Components

### Composition

Compose screens like review boards: a narrative headline zone, a central evidence field, and supporting telemetry rails, oriented by a left datum rail of coordinate ticks. Let the conclusion stay dominant; rails support the decision thread without competing. Never box navigation into a pill or floating card.

### Hierarchy

Use large Space Grotesk deck titles for story-level conclusions and compact IBM Plex Mono for metric-level readouts, coordinates, and procedural metadata, so operators distinguish narrative from instrument at a glance. Cyan reads; amber marks thresholds and active coordinates; red flags a real fault.

### Density

High density but heavily gridded: telemetry strips and ledgers can be tight as long as labels, separators, status dots, and contrast keep them scannable; every dense cluster has a quieter band or annotation nearby.

### Signature

A left datum coordinate rail; clipped-notch technical plates with a 2px cyan top status bar; section headers of amber mono coordinate overline + title + rule into the grid; telemetry strips of evenly spaced readout cells with signal-ink status dots; and rule-connected editorial annotations inside the grid.

## 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-019ef9d9-e63a-7a40-8f99-2194688f7650/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 Orient the page with a left datum rail and per-section amber coordinates; give every reading a location.
- Do Build modules as clipped-notch plates with a cyan top status bar; pad above every title.
- Do Lead with the narrative conclusion in Space Grotesk; set readouts, coordinates, and timestamps in IBM Plex Mono.
- Do Keep cyan as the read, amber for thresholds and active coordinates, red for a real fault; hold accents like highlighters.
- Do Group numbers into telemetry strips with evenly spaced cells and signal-ink status dots.
- Do Rule-connect annotations into the chart or table they explain; let findings live inside the grid.
- Do Explicitly style every form control with a visible cyan focus ring; render the settled state with no JavaScript.
- Don't Do not default to a white or muddy ground, or flood panels with neon gradients.
- Don't Do not use rounded consumer-product cards, in-between radii, or nested cards.
- Don't Do not give a plate a lone accent edge; colour rides the top status bar and status dots, not a side edge.
- Don't Do not box navigation into a pill or floating rounded card.
- Don't Do not spend accent on decoration, hide operational metadata behind minimalism, or use the oversized italic-serif AI-default headline.
- Don't Do not use emoji on buttons or symbol glyphs in copy; use inline SVG primitives.

### Accessibility

High-contrast light text and signal ink on charcoal, all clearing WCAG AA; status carried by colour AND label/shape; mono readouts stay 14.5px+, body 17px+; visible 2px cyan focus rings with offset; touch targets at least 44px; every form control explicitly styled with no browser defaults; the fully-rendered state is visible with no JavaScript and motion respects prefers-reduced-motion.

## Imagery Direction

### Pairs With

datum

### Summary

Spacecraft and orbital subjects rendered as mission-control review plates in the Datum technique: the subject crisp and dominant on a deep charcoal field over a faint blueprint grid, dressed with hairline cyan dimension rules and calibration ticks, amber coordinate crosshairs, sparse monospace readouts and status dots in the margins, and clipped corner notches framing the plate.

### Subjects

- orbital spacecraft / deep-space orbiter
- high-gain dish antenna and solar arrays
- launch vehicle stack in section
- orbital trajectory / apsis diagram
- ground-station antenna
- reaction-wheel and thruster assemblies

### Usage

One full-bleed landing hero in the Datum technique composed with a calm left third for the overlay; elsewhere keep imagery to plate previews and feature studies with leader-line callouts. End every prompt with NO text, NO letters, NO logos.
shadcn/ui theme
```json
{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "apsis",
  "type": "registry:theme",
  "title": "Apsis shadcn Theme",
  "cssVars": {
    "theme": {},
    "light": {
      "background": "#081017",
      "foreground": "#E7F1F7",
      "card": "#101A24",
      "card-foreground": "#E7F1F7",
      "popover": "#101A24",
      "popover-foreground": "#E7F1F7",
      "primary": "#E7F1F7",
      "primary-foreground": "#111111",
      "secondary": "#f4f4f5",
      "secondary-foreground": "#111111",
      "muted": "#8A9BAE",
      "muted-foreground": "#E7F1F7",
      "accent": "#9BE7FF",
      "accent-foreground": "#111111",
      "destructive": "#FF6D6D",
      "border": "#233545",
      "input": "#233545",
      "ring": "#9BE7FF",
      "chart-1": "#E7F1F7",
      "chart-2": "#f4f4f5",
      "chart-3": "#9BE7FF",
      "chart-4": "#79E3A0",
      "chart-5": "#F6B756",
      "sidebar": "#101A24",
      "sidebar-foreground": "#E7F1F7",
      "sidebar-primary": "#E7F1F7",
      "sidebar-primary-foreground": "#111111",
      "sidebar-accent": "#67C6FF",
      "sidebar-accent-foreground": "#ffffff",
      "sidebar-border": "#233545",
      "sidebar-ring": "#9BE7FF",
      "radius": "16px"
    },
    "dark": {
      "background": "#0f1115",
      "foreground": "#f8fafc",
      "card": "#181b22",
      "card-foreground": "#f8fafc",
      "popover": "#181b22",
      "popover-foreground": "#f8fafc",
      "primary": "#E7F1F7",
      "primary-foreground": "#111111",
      "secondary": "#252a33",
      "secondary-foreground": "#f8fafc",
      "muted": "#252a33",
      "muted-foreground": "#a1a1aa",
      "accent": "#9BE7FF",
      "accent-foreground": "#111111",
      "destructive": "#FF6D6D",
      "border": "#303642",
      "input": "#303642",
      "ring": "#9BE7FF",
      "chart-1": "#E7F1F7",
      "chart-2": "#f4f4f5",
      "chart-3": "#9BE7FF",
      "chart-4": "#79E3A0",
      "chart-5": "#F6B756",
      "sidebar": "#181b22",
      "sidebar-foreground": "#f8fafc",
      "sidebar-primary": "#E7F1F7",
      "sidebar-primary-foreground": "#111111",
      "sidebar-accent": "#9BE7FF",
      "sidebar-accent-foreground": "#111111",
      "sidebar-border": "#303642",
      "sidebar-ring": "#9BE7FF",
      "radius": "16px"
    }
  },
  "meta": {
    "source": "katagami",
    "languageId": "en-019ef9d9-e63a-7a40-8f99-2194688f7650",
    "slug": "apsis",
    "componentManifest": [
      "button",
      "card",
      "input",
      "textarea",
      "select",
      "dialog",
      "sheet",
      "tabs",
      "badge",
      "separator",
      "checkbox",
      "switch",
      "slider",
      "tooltip",
      "dropdown-menu",
      "table"
    ],
    "installCommand": "npx shadcn@latest add button card input textarea select dialog sheet tabs badge separator checkbox switch slider tooltip dropdown-menu table",
    "nativeTokenNames": {
      "colors": [
        "accent",
        "accent_2",
        "bg",
        "border",
        "error",
        "info",
        "muted",
        "on_accent",
        "recess",
        "rule",
        "success",
        "surface",
        "surface_2",
        "text",
        "warning"
      ],
      "typography": [
        "base_size",
        "body_font",
        "google_fonts_url",
        "heading_font",
        "heading_transform",
        "heading_weight",
        "letter_spacing",
        "mono_font"
      ],
      "radii": [
        "full",
        "lg",
        "md",
        "none",
        "sm"
      ],
      "shadows": [
        "lg",
        "md",
        "sm"
      ],
      "spacing": [
        "base",
        "scale"
      ],
      "surfaces": [
        "bg_pattern",
        "card_style",
        "treatment"
      ],
      "borders": [
        "accent_width",
        "character",
        "default_width",
        "style"
      ],
      "motion": [
        "duration",
        "easing",
        "philosophy"
      ]
    }
  }
}
```
in the wild

embodiments

bespoke marketing landingopen full page ↗
landing · apsis
DESIGN.md

at a glance

Typography

headline-lgSpace Grotesk · 33px · 700

The quick brown fox jumps

headline-mdSpace Grotesk · 27px · 600

The quick brown fox jumps

body-mdIBM Plex Sans · 17px · 400

The quick brown fox jumps

label-mdIBM Plex Mono · 12px · 600

The quick brown fox jumps

shadcn/ui

implementation kit

built with

Agent-generated

remix lane

try a remix

Keep Apsisand swap a palette and an art style onto it — the landing & dashboard recolor live. The Studio does the same with all three lanes free.

UI language · fixed
Apsis
Palette
Art style
Landing Page
live preview · recolored + filled
lineage

Family

1 descendant
related

More like this