NeuronaHealth Design System
A comprehensive design system for healthcare applications. Built with accessibility, consistency, and scalability in mind.
Packages
| Package | Version | Description |
|---|---|---|
@neuronahealth/design-tokens |
1.0.0 | Brand design tokens — colors, typography, spacing, shadows, animations |
@neuronahealth/ui-components |
2.0.0 | 46 React components built on Radix UI primitives |
Key Features
Healthcare-specific semantic tokens for emergency, urgent, routine, and AI triage contexts.
Colors
The NeuronaHealth color system includes brand colors, semantic healthcare colors, UI semantic colors, and chart colors. All colors support both light and dark themes.
Brand Colors
Accent Colors
Healthcare Semantic Colors
Purpose-built colors for healthcare contexts: emergency, urgent, routine, and AI triage statuses.
UI Semantic Colors
Core UI colors for backgrounds, foregrounds, borders, and interactive states. Toggle the theme to see dark mode values.
Chart Colors
Status Colors
Status indicators for user presence and availability states.
Gradients
Brand gradients for text and decorative elements.
Typography
NeuronaHealth uses Inter for body text and Sora for display/heading text. JetBrains Mono is available for code.
Font Families
Font Sizes
Font Weights
Line Heights
Letter Spacing
Spacing
A consistent spacing scale based on 4px increments. Used for margins, padding, and gaps.
Border Radius
Border radius tokens for consistent corner rounding across the design system.
Shadows
Elevation and shadow tokens for creating visual hierarchy and depth.
Animations
Animation durations, easings, and keyframe presets for consistent motion design.
Durations
Animation Presets
Breakpoints
Responsive breakpoint tokens for layout adaptation across device sizes.
| Name | Min Width | Typical Device |
|---|---|---|
xs |
320px | Small phones |
sm |
480px | Large phones |
md |
768px | Tablets |
lg |
992px | Small laptops |
xl |
1280px | Desktops |
2xl |
1536px | Large desktops |
3xl |
1920px | 4K screens |
Z-Index
Z-index scale for consistent layering and stacking contexts.
| Name | Value | Usage |
|---|---|---|
hide |
-1 | Hidden behind base layer |
base |
0 | Default layer |
dropdown |
10 | Dropdown menus |
sticky |
20 | Sticky headers |
fixed |
30 | Fixed position elements |
modal-backdrop |
40 | Modal overlay backgrounds |
modal |
50 | Modal dialogs |
popover |
60 | Popover menus |
tooltip |
70 | Tooltips |
toast |
80 | Toast notifications |
top |
90 | Highest priority UI |
max |
999 | Absolute maximum |
Button
46 componentsButtons trigger actions. Use variants to indicate different types of actions.
Variants
Sizes
States
With Icons
Loading State
Full Width
Button Group
Badge
Badges display short status descriptors.
Variants
Sizes
With Dot Indicator
Removable
Healthcare Status Badges
Specialized badges for healthcare contexts indicating patient urgency levels.
Status Variants
Input
Text inputs allow users to enter and edit text.
Default
States
Validation States
This field is required
Looks good!
With Labels
We'll never share your email.
Sizes
Textarea
Multi-line text input for longer content.
Default
States
Card
Cards group related content and actions.
Default
Card Title
Card description text
This is the card content area. Cards can contain any type of content including text, images, and actions.
Interactive Card
Hoverable Card
Hover to see the interaction
This card has a hover effect that lifts it slightly.
Card with Header Only
Simple Header Card
Alert
Alerts display important messages to users.
Variants
With Close Button
Avatar
Avatars represent users or entities.
Sizes
With Status Indicator
Avatar Group
Checkbox
Checkboxes allow users to select multiple options.
Default
Switch
Switches toggle the state of a single setting.
Default
Progress
Progress bars show completion status.
Default
Colors
Sizes
Indeterminate
Skeleton
Skeletons show placeholder content while loading.
Default
Separator
Separators divide content sections.
Default
Tabs
Tabs organize content into separate views.
Default
Pills Variant
Underline Variant
Table
Tables display data in rows and columns.
Default
| Name | Status | Date |
|---|---|---|
| John Smith | Active | 2024-01-15 |
| Jane Doe | Pending | 2024-01-14 |
| Bob Wilson | Inactive | 2024-01-13 |
Striped Rows
| Patient | Department | Status |
|---|---|---|
| Sarah Johnson | Cardiology | Stable |
| Michael Chen | Emergency | Critical |
| Emily Davis | Orthopedics | Observation |
Hoverable Rows
| Medication | Dosage | Frequency |
|---|---|---|
| Aspirin | 81mg | Once daily |
| Metformin | 500mg | Twice daily |
| Lisinopril | 10mg | Once daily |
Dense Table
| Time | Event | User |
|---|---|---|
| 10:30 AM | Appointment created | Dr. Smith |
| 10:15 AM | Lab results uploaded | System |
| 09:45 AM | Patient checked in | Reception |
Healthcare Examples
Real-world examples showing how components are used in healthcare contexts.
Patient Cards
Appointment Card
Upcoming Appointment
TomorrowStatus Indicators
Medical Alert Card
Form Example
Complete form with validation states and various input types.
Patient Registration Form
All Components
Complete list of 46 components in the NeuronaHealth UI system.
| Component | Description | Category |
|---|---|---|
| Accordion | Vertically stacked interactive panels | Disclosure |
| Alert Dialog | Modal dialog for critical actions | Overlay |
| Alert | Displays important messages | Feedback |
| Aspect Ratio | Constrains content to a ratio | Layout |
| Avatar | Represents users or entities | Data Display |
| Badge | Short status descriptors | Data Display |
| Breadcrumb | Navigation path indicator | Navigation |
| Button | Triggers actions | Form |
| Calendar | Date selection widget | Form |
| Card | Groups related content | Layout |
| Carousel | Slides through content | Data Display |
| Chart | Data visualization | Data Display |
| Checkbox | Multi-select input | Form |
| Collapsible | Toggle content visibility | Disclosure |
| Command | Command palette menu | Overlay |
| Context Menu | Right-click menu | Overlay |
| Dialog | Modal dialog window | Overlay |
| Drawer | Side panel drawer | Overlay |
| Dropdown Menu | Dropdown action menu | Overlay |
| Form | Form handling with validation | Form |
| Hover Card | Card that appears on hover | Overlay |
| Input OTP | One-time password input | Form |
| Input | Text input field | Form |
| Label | Form field label | Form |
| Menubar | Horizontal menu bar | Navigation |
| Navigation Menu | Complex navigation | Navigation |
| Pagination | Page navigation | Navigation |
| Popover | Floating content panel | Overlay |
| Progress | Progress indicator | Feedback |
| Radio Group | Single selection group | Form |
| Resizable | Resizable panels | Layout |
| Scroll Area | Custom scrollable area | Layout |
| Select | Dropdown selection | Form |
| Separator | Visual divider | Layout |
| Sheet | Side panel overlay | Overlay |
| Sidebar | App sidebar layout | Navigation |
| Skeleton | Loading placeholder | Feedback |
| Slider | Range input slider | Form |
| Sonner | Toast notifications | Feedback |
| Switch | Toggle switch | Form |
| Table | Data table | Data Display |
| Tabs | Tabbed content | Navigation |
| Textarea | Multi-line text input | Form |
| Toggle Group | Toggle button group | Form |
| Toggle | Two-state button | Form |
| Tooltip | Hover information | Overlay |