Design Documentation

The Cellular Ripple Effect — Style Guide

The visual system behind the atlas: a dark biological blueprint built for scientific precision. Every value below is read from the live design tokens and palette functions, so this page reflects the application exactly as it renders.

01

Design Intent

A living blueprint of human therapeutic potential — not a dashboard.

    The experience should feel
  • Scientific and precise — measured type, exact geometry
  • Biological — organic hues, cell-like pulse and membrane lines
  • Immersive — full-bleed dark field, chrome kept to the edges
  • Trustworthy and systems-oriented — hierarchy always legible
    Never
  • Dashboard or business-intelligence aesthetics
  • Pie charts, bar charts, or decorative data ornament
  • Gamification or cartoon animation
  • Hardcoded colors — all values come from tokens
02

Color

All color is defined in OKLCH as semantic tokens. Components reference tokens, never literal values.

Surfaces
Background
oklch(0.16 0.03 250)
Deep indigo field
Card / Popover
oklch(0.19 0.03 250)
Panels, rails, readouts
Muted
oklch(0.22 0.025 250)
Inactive rows
Secondary
oklch(0.24 0.03 250)
Raised controls
Border
oklch(0.94 0.01 90 / 0.08)
Hairline separation
Ink
Foreground
oklch(0.94 0.01 90)
Warm white type
Muted Foreground
oklch(0.65 0.02 90)
Labels, captions
Ink Dim
oklch(0.94 0.01 90 / 0.45)
Dimmed / filtered-out
Signature colors
MSC Core
oklch(0.78 0.14 75)
Primary — amber cell body
Core Glow
oklch(0.88 0.16 75)
Halo and pulse rings
Membrane
oklch(0.72 0.12 200)
Accent — cyan boundaries
Blueprint Grid
oklch(0.94 0.01 90 / 0.06)
Ring guides, graticule
Therapeutic area hues — 18 body systems

Generated by wedgeColor(hue) at fixed lightness 0.70 and chroma 0.11, spread evenly around the hue wheel from a 20° offset so no wedge reads as pure red.

Aging & Longevity20°
Cardiovascular40°
Dermatological60°
Endocrine80°
Gastrointestinal100°
General / Other120°
Genetic / Congenital140°
Hematologic160°
Immune / Autoimmune180°
Infectious Disease200°
Musculoskeletal220°
Neurological240°
Oncology260°
Psychiatric / Mental Health280°
Renal / Urinary300°
Reproductive320°
Respiratory340°
Sensory (Eye/Ear)0°
Merged grouping — 13 therapeutic domains
NeurologyOrthopedicsImmunologyOncologyCardiologyPulmonologyDermatologyGastroenterologyHematologyEndocrinologyReproductive HealthRare DiseaseAging & Longevity
Fill opacity scale
Wedge rest
alpha 0.18
Wedge hover
alpha 0.42
Category rest
alpha 0.09
Category hover
alpha 0.32
Condition rest
alpha 0.22
Condition hover
alpha 0.55
03

Typography

Jost Variable throughout — a geometric sans with razor-sharp light weights. Numerals are tabular; caps styles carry wide tracking.

Display
Jost · 300 · 36px · -0.015em
The Cellular Ripple Effect
Page title
Jost · 300 · 24px · -0.01em
An Atlas of Therapeutic Potential
Section heading
Jost · 500 · 20px
Disease Category
Eyebrow / caps
ripple-caps · 500 · 10px · 0.18em
Therapeutic Areas
Ring label (SVG)
Jost · 400 · 16px · white
THERAPEUTIC AREA
Body
Jost · 300 · 14px · 1.6

Mesenchymal stem cells exert therapeutic influence across progressively larger scales of human biology.

Condition label
Jost · 200 · 6–9px · 0.01em
Amyotrophic Lateral SclerosisKnee OsteoarthritisCrohn's DiseaseIdiopathic Pulmonary Fibrosis
Numerals
ripple-mono · tabular-nums · 0.02em
1,300+ · 325 · 18 · 13
04

Spacing & Layout

Chrome floats at the edges of a full-bleed field. Panels use hairline borders, translucent card fills, and backdrop blur so the map remains the subject.

Panel padding
24px
p-6
Panel inner
12–16px
p-3 / p-4
Row rhythm
8px
gap-2
Section gap
32px
pt-8
Pill padding
12px / 4px
px-3 py-1
Radius
8px / full
--radius: 0.5rem
Panel

border-border · bg-card/70 · backdrop-blur · rounded-md

Pill control · rounded-full
Inactive row

bg-muted

05

Interaction States

The interactive atlas responds to hover and wheel zoom only. Rotation, dragging, and click-selection are deliberately absent.

Segment rest
Wedge fill 0.18 · stroke 0.70 · stroke-width 0.5
Segment hover
Fill 0.42 · stroke 1.0 · width 1.2 · glow filter · scale 1.04 outward
Category hover
Fill 0.32 · stroke 0.95 · scale 1.03 — a subtler echo of the wedge
Filtered out
Non-matching nodes dim to ink-dim opacity; nothing is removed from the map
MSC core
Scale 1.14 on hover · pulse rings accelerate to 3.8s · halo 0.20 → 0.48 · label type grows 10 → 14px and reveals the indication count
MSC
Control rest / hover
Muted label warms to full foreground; active state inverts to amber fill
ActiveRest
Zoom
Wheel only · scale clamped 0.6 – 4.0 · no drag, no rotation, no click-selection
0.6 ≤ scale ≤ 4.0
Hover readout
Follows the cursor: condition, disease category, and body system — names only, no counts
Knee OsteoarthritisMusculoskeletal
06

Scientific Visualization Conventions

The rules that keep the atlas readable as a hierarchy rather than a decoration.

Ring order — inside out
r100MSC CoreCenter — amber nucleus, pulse halo
r210Therapeutic AreaRing 2 — wedge division
r300Disease CategoryRing 3 — nested per wedge
r530ConditionRing 4 — individual indications
    Rules
  • Angular span is proportional to condition count — a wedge's width encodes how many indications it holds. No values are normalized or padded.
  • Color encodes therapeutic area only. Category and condition rings inherit their parent wedge hue at lower alpha, so lineage is readable at a glance.
  • Condition labels in the lower hemisphere (0°–180° normalized) are flipped 180° so every label reads upright.
  • The white dot halo outside the condition labels represents the wider indication space, clustered in proportion to each category's weight.
  • Ring headers name the level, not the segment — individual segment names surface only on hover.
  • Presentation Mode is fully static: no hover, no zoom, every condition label visible, A3 landscape print with exact color reproduction.
07

Data Provenance

Three JSON sources drive every node, so visual structure is never authored by hand.

Ontology
Knowledge graph — wedges, categories, conditions
Layout
Radial spatial model — ring and segment order
Metadata
Statistics and filter vocabularies

The sources describe 325 named conditions across 18 body systems. Presentation Mode states the broader addressable figure of 1,300+ indications, with the dot halo standing in for the unnamed remainder.