# OrganUI

> Interfaces for healthcare and life sciences. Components install as source with the shadcn CLI from the @organui registry at https://organui.com/r.

## Docs
- [Introduction](https://organui.com/docs.md): What OrganUI is and how its components reach your project.
- [Installation](https://organui.com/docs/installation.md): Set up a project and install components by name or address.
- [Theming](https://organui.com/docs/theming.md): The design tokens components read, and dark mode.
- [Base UI and Radix](https://organui.com/docs/base-ui.md): Install on either library, and the items that ship a copy for each.
- [Forms](https://organui.com/docs/forms.md): Use the clinical inputs in forms with React Hook Form, Zod and shadcn's Field.
- [Licences](https://organui.com/docs/licences.md): MIT code, and the licence each model and dataset keeps.
- [MCP](https://organui.com/docs/mcp.md): Browse and install components from an AI assistant, and read the docs as Markdown.
- [Changelog](https://organui.com/docs/changelog.md): What each release added and changed.
- [Next.js](https://organui.com/docs/installation/next.md): Create a Next.js app with shadcn and add OrganUI components.
- [Vite](https://organui.com/docs/installation/vite.md): Create a Vite app with shadcn and add OrganUI components.
- [Components](https://organui.com/docs/components.md): Every OrganUI component, grouped by category.

## Clinical
- [Body map](https://organui.com/docs/components/body-map.md): Pick regions on a front and back body outline to record where pain or symptoms are.
- [Dermatome map](https://organui.com/docs/components/dermatome-map.md): Front and back body map of the skin each spinal nerve supplies, C2 to S4-5, with ISNCSCI key sensory points.
- [ECG trace](https://organui.com/docs/components/ecg-trace.md): A recorded or live ECG rhythm strip on standard paper, with labelled P, QRS and T waves. Not for diagnostic use.
- [Growth chart](https://organui.com/docs/components/growth-chart.md): Child growth percentile curves for weight, length/height and head circumference from reference tables you supply, with plotted measurements, percentiles and z-scores.
- [Lab results table](https://organui.com/docs/components/lab-results.md): Lab values flagged against the reference ranges you pass, with text and icon flags and a trend sparkline.
- [Medication schedule](https://organui.com/docs/components/medication-schedule.md): A daily dosing timeline with dose tracking and interaction warnings from data you provide.
- [Vital signs](https://organui.com/docs/components/vital-signs.md): Heart rate, blood pressure, SpO₂ and temperature, each flagged against a configurable normal range.

## Imaging
- [Medical image viewer](https://organui.com/docs/components/image-viewer.md): Scroll through CT or MRI slices with window and level, zoom and pan, and read DICOM files in the browser.

## Molecular & cellular
- [Cell](https://organui.com/docs/components/cell.md): An animal cell with a quarter cut away, from an original OrganUI schematic model: 15 selectable organelles and structures and 4 named views. Model licensed CC0 1.0.
- [DNA helix](https://organui.com/docs/components/dna-helix.md): A procedural B-DNA double helix built from a sequence, with selectable base pairs and both strands listed below.
- [Molecule viewer](https://organui.com/docs/components/molecule-viewer.md): Load a PDB or mmCIF structure and explore it as a cartoon, ball and stick or spacefill model, with residue selection and a sequence strip.

## Organs
- [Organs](https://organui.com/docs/components/organs.md): Every organ as a picture, linking to its page.
- [Anatomy tree](https://organui.com/docs/components/anatomy-tree.md): Search, select and control visibility in hierarchical anatomy data.
- [Organ viewer](https://organui.com/docs/components/organ-viewer.md): Rotate, frame and select the structures of a GLB anatomy model, with ghosting and named views.
- [Adrenals](https://organui.com/docs/components/adrenals.md): The adrenals from the OrganUI adrenals explorer: 12 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Appendix](https://organui.com/docs/components/appendix.md): The vermiform appendix with the cecum, terminal ileum, iliac vessels and the muscles behind it: 7 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Bladder](https://organui.com/docs/components/bladder.md): The bladder from the OrganUI bladder explorer: 12 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Brain](https://organui.com/docs/components/brain.md): The brain from the OrganUI brain explorer: 19 selectable structures and 6 named views. Model licensed CC BY 4.0.
- [Breast](https://organui.com/docs/components/breast.md): Both breasts from the HuBMAP Human Reference Atlas: 16 selectable structures and 3 named views. Model licensed CC BY 4.0.
- [Diaphragm](https://organui.com/docs/components/diaphragm.md): The diaphragm with the structures that pass through it and the organs above and below: 13 selectable structures and 4 named views. Model licensed CC BY-SA 2.1 JP.
- [Ear](https://organui.com/docs/components/ear.md): The ear from the OrganUI ear explorer: 16 selectable structures and 3 named views. Model licensed CC BY-SA 4.0.
- [Esophagus](https://organui.com/docs/components/esophagus.md): The esophagus from the OrganUI esophagus explorer: 17 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Eye](https://organui.com/docs/components/eye.md): The eye from the OrganUI eye explorer: 21 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Gallbladder](https://organui.com/docs/components/gallbladder.md): The gallbladder from the OrganUI gallbladder explorer: 15 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Hair](https://organui.com/docs/components/hair.md): A hair follicle in a cut-away plug of scalp, from an original OrganUI schematic model: 14 selectable structures and 3 named views. Model licensed CC0 1.0.
- [Heart](https://organui.com/docs/components/heart.md): The heart from the OrganUI heart explorer: 11 selectable structures and 3 named views. Model licensed CC BY 4.0.
- [Intestines](https://organui.com/docs/components/intestines.md): The intestines from the OrganUI intestines explorer: 11 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Joints](https://organui.com/docs/components/joints.md): The joints and ligaments of the whole body, from Z-Anatomy: 197 selectable structures and 9 named views. Model licensed CC BY-SA 4.0.
- [Kidneys](https://organui.com/docs/components/kidneys.md): The kidneys from the OrganUI kidneys explorer: 6 selectable structures and 4 named views. Model licensed CC BY 4.0.
- [Larynx](https://organui.com/docs/components/larynx.md): The larynx from the OrganUI larynx explorer: 20 selectable structures and 4 named views. Model licensed CC BY-SA 2.1 JP.
- [Liver](https://organui.com/docs/components/liver.md): The liver from the OrganUI liver explorer: 7 selectable structures and 5 named views. Model licensed CC BY 4.0.
- [Lungs](https://organui.com/docs/components/lungs.md): The lungs from the OrganUI lungs explorer: 20 selectable structures and 4 named views. Model licensed CC BY-SA 2.1 JP.
- [Lymph node](https://organui.com/docs/components/lymph.md): The lymph node from the OrganUI lymph node explorer: 7 selectable structures and 3 named views. Model licensed CC BY 4.0.
- [Muscles](https://organui.com/docs/components/muscles.md): The muscles from the OrganUI muscles explorer: 177 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Nails](https://organui.com/docs/components/nails.md): A fingertip halved through the nail, from an original OrganUI schematic model: 14 selectable structures and 3 named views. Model licensed CC0 1.0.
- [Nerves](https://organui.com/docs/components/nerves.md): The peripheral nerves of the whole body, from the cranial nerves to the plexuses of the arms and legs: 41 selectable structures and 6 named views. Model licensed CC BY-SA 4.0.
- [Nose](https://organui.com/docs/components/nose.md): The nose from the OrganUI nose explorer: 22 selectable structures and 3 named views. Model licensed CC BY-SA 4.0.
- [Pancreas](https://organui.com/docs/components/pancreas.md): The pancreas from the OrganUI pancreas explorer: 15 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Parathyroid](https://organui.com/docs/components/parathyroid.md): The four parathyroid glands on the back of the thyroid: 9 selectable structures and 5 named views. Model licensed CC BY-SA 2.1 JP.
- [Pharynx](https://organui.com/docs/components/pharynx.md): The pharynx from the OrganUI pharynx explorer: 20 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Pineal](https://organui.com/docs/components/pineal.md): The pineal gland and its neighbours deep in the brain: the epithalamus, thalami, midbrain tectum and deep veins. 15 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Pituitary](https://organui.com/docs/components/pituitary.md): The pituitary gland in its setting: the hypothalamus above it, the optic chiasm, its portal blood supply, the cavernous sinus and the sphenoid bone. 19 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Prostate](https://organui.com/docs/components/prostate.md): The prostate from the OrganUI prostate explorer: 13 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Salivary glands](https://organui.com/docs/components/salivary-glands.md): The major salivary glands, from Z-Anatomy: 15 selectable structures and 3 named views. Model licensed CC BY-SA 4.0.
- [Skeleton](https://organui.com/docs/components/skeleton.md): The skeleton from the OrganUI skeleton explorer: 242 selectable structures and 8 named views. Model licensed CC BY-SA 2.1 JP.
- [Skin](https://organui.com/docs/components/skin.md): The skin from the OrganUI skin explorer: 13 selectable structures and 3 named views. Model licensed CC0 1.0.
- [Spinal cord](https://organui.com/docs/components/spinal-cord.md): The spinal cord from the OrganUI spinal cord explorer: 63 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Spleen](https://organui.com/docs/components/spleen.md): The spleen from the OrganUI spleen explorer: 9 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Stomach](https://organui.com/docs/components/stomach.md): The stomach from the OrganUI stomach explorer: 9 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Teeth](https://organui.com/docs/components/teeth.md): The teeth from the OrganUI teeth explorer: 33 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Thymus](https://organui.com/docs/components/thymus.md): The thymus from the OrganUI thymus explorer: 13 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Thyroid](https://organui.com/docs/components/thyroid.md): The thyroid from the OrganUI thyroid explorer: 18 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Tongue](https://organui.com/docs/components/tongue.md): The tongue from the OrganUI tongue explorer: 13 selectable structures and 3 named views. Model licensed CC BY-SA 2.1 JP.
- [Uterus](https://organui.com/docs/components/uterus.md): The uterus from the OrganUI uterus explorer: 27 selectable structures and 3 named views. Model licensed CC BY 4.0.
- [Vessels](https://organui.com/docs/components/vessels.md): The vessels from the OrganUI vessels explorer: 51 selectable structures and 6 named views. Model licensed CC BY-SA 2.1 JP.
- [Vestibular system](https://organui.com/docs/components/vestibular.md): The inner ear's balance organs: the vestibule and three semicircular canals, with the cochlea and vestibular nerve. 6 selectable structures and 4 named views. Model licensed CC BY-SA 4.0.

## AI Elements
- [AI Elements](https://organui.com/docs/ai-elements.md): Patterns for AI in clinical interfaces: disclosure, sources, reasoning and sign-off.
- [AI disclaimer](https://organui.com/docs/ai-elements/ai-disclaimer.md): Marks content as AI-generated: the model, when it ran, and whether a clinician has reviewed it.
- [AI note](https://organui.com/docs/ai-elements/ai-note.md): An AI-drafted clinical note whose claims cite the records they rely on, with unsupported claims marked for review.
- [Clinical citation](https://organui.com/docs/ai-elements/clinical-citation.md): A record cited in the sentence that relies on it: a lab result, note, image or guideline, opening on hover or focus like shadcn's Inline Citation.
- [Clinical sources](https://organui.com/docs/ai-elements/clinical-sources.md): The records an AI answer used, under one line that opens into the list, built on shadcn's Trace like its Sources.
- [Differential list](https://organui.com/docs/ai-elements/differential-list.md): Suggested diagnoses ranked by model confidence, as shadcn Items, each with the findings for and against it.
- [Clinician review](https://organui.com/docs/ai-elements/clinician-review.md): A clinician's sign-off on AI-generated content, built like shadcn's Confirmation: approve, or request changes or reject with a reason, recording who and when.

## Helpers
- [Helpers](https://organui.com/docs/helpers.md): Clinical calculations in TypeScript: ages, z-scores, reference ranges, units and body measurements.
- [Age](https://organui.com/docs/helpers/age.md): Age in months and years, age corrected for prematurity, and age formatted for charts.
- [Body measurements](https://organui.com/docs/helpers/body-measurements.md): Body mass index with its WHO category, and body surface area by the Mosteller, Du Bois or Haycock formula.
- [Clinical units](https://organui.com/docs/helpers/clinical-units.md): Converts laboratory values between conventional and SI units, and temperature, weight and length between systems.
- [Reference ranges](https://organui.com/docs/helpers/reference-ranges.md): Flags a value low, high or critical against its reference range, and prints the range as a report does.
- [Z-scores](https://organui.com/docs/helpers/z-scores.md): Z-scores and percentiles from LMS reference parameters, with WHO's restricted extrapolation.

## Utilities
- [Utilities](https://organui.com/docs/utilities.md): Tailwind utilities for clinical interfaces, in one install.
- [ecg-grid](https://organui.com/docs/utilities/ecg-grid.md): Utilities for drawing ECG paper behind a trace.
- [heartbeat](https://organui.com/docs/utilities/heartbeat.md): Utilities for pulsing an element like a heartbeat.
- [severity](https://organui.com/docs/utilities/severity.md): Theme colours for clinical severity: normal, info, warning and critical.

## Blocks
- [Explorer 01](https://organui.com/blocks#explorer-01): An organ viewer with an anatomy panel that docks beside it on wide screens and opens as a sheet on phones. Heart model licensed CC BY 4.0.
- [Explorer 02](https://organui.com/blocks#explorer-02): A full-height anatomy workspace with the tree in a sidebar and a details card to hide or isolate the selected structure. Heart model licensed CC BY 4.0.
- [Explorer 03](https://organui.com/blocks#explorer-03): One viewer that switches between several organs from a menu, here the heart, kidneys, stomach and pancreas. Models licensed CC BY 4.0 and CC BY-SA 2.1 JP.
- [Dashboard 01](https://organui.com/blocks#dashboard-01): One patient at a glance: vital signs, a live ECG, lab results with trends and the day's medicines, with fictional data to replace with your records.