DS
Published-package documentation wired to the real DS runtime so the same routes reveal how tenant and engine reshape identical component contracts.
Rottay / modernPublished package
Premium Docs

Design System Showroom

Primary
#FFFFFF
Rottay
Radius
14px
Surface shape
DensitynormalPlatform Flagship
NavigatorLibrary map
8 sections212 routes
Foundations first, then primitives, patterns, structures, and surfaces. Keep this rail legible enough to scan without hunting.
Foundations4 documented routes
4
Tokens
Themes
109
93
24
36
3
1
2
Runtime fingerprintToken readout from the active provider chain.
Live DS
Runtime
PlatformRottay
Rottay / ModernPlatform Flagship
Primary
#FFFFFFSecondary #A0A0A5
Radius
Compact runtime evidence across 3+ token signals.
Published DS package · Pattern Library · Rottay / modernShared route metadata for the active runtime, kept inline so the shell reads like a thin header band.
Palette
#FFFFFFRottay
Chrome
Modernrenderer posture
Radius
14pxsurface shape
Density
normalPlatform Flagship
Patterns/Charts/WaterfallChart
Flow3 variantsRuntime-driven docs

WaterfallChart

Running total chart with increase, decrease, and total bars
Ordered transitions or stage weights where movement matters more than isolated points.
How to read this page
Use the sidebar showroom controls to change engine and tenant, then judge whether the chart still reads clearly without extra editorial staging around it.

Choose this when

3 items
Live preview

Validate the chart in the active showroom runtime

Sidebar engine and tenant drive thisFlow
This preview should stand on the chart itself: legibility, token use, spacing, and interaction rhythm all need to hold without extra local storytelling chrome.
Loading chart preview...The interactive chart canvas mounts client-side so the docs page stays stable while the preview runtime boots.
ImportPublished package entrypoint, ready to copy.
tsx
1 line
Consumption
Runtime-aware snippet
import { WaterfallChart } from '@rottay/design-system';
UsagePaste-ready example that shows the base contract first.
tsx
11 lines
Consumption
Runtime-aware snippet
<WaterfallChart
  data={[
    { label: 'Revenue', value: 420 },
    { label: 'COGS', value: -200 },
    { label: 'Net Profit', value: 140, type: 'total' },
  ]}
  showValues
  showConnectors
  height={300}
  animate
/>
API surface

Props

24 rows
WaterfallChart propsProp contracts stay readable across dark-first and light-first tenants.
24 props1 required23 optional
Fast readStart with required props, then scan defaults before dropping to per-row details.
Contract postureThis reference stays intentionally concise so the primitive contract remains scannable.
data
Required
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Optional
Related charts

Continue within Flow

Browse all
FunnelChartFlow
Stage-based funnel for conversion pipelines
SankeyChartFlow
Flow diagram showing weighted relationships between nodes
Engines
Icons
Primitives93 documented routes
Display
Inputs
Feedback
Layout
Navigation
Overlay
PatternsCurrent section
49
Data
Forms
Visualization
Calendar View
Structures24 documented routes
Headers
Workspace
Shell
Record
Dashboard
Feedback
Surfaces36 documented routes
Admin
Data
Experience
Forms
Operations
Workspace
Verticals3 documented routes
Platform
Bit Hire
Evnto
Playground1 documented routes
Playground
Developers2 documented routes
Developers
14pxxl 18px
Density
normalBorder-light cards
Accent
Badge
roundedtop bar · solid dividers
PatternsVisualizationChartsWaterfall

Waterfall

Active profilePlatform Flagship
Runtime postureRottay / modern
D3-backed chart recipes with token-aware styling.
Runtime controls
TenantRottay
EngineModern
TierChartA specialized visualization pattern.
FamilyFlowStart with step continuity.
Best forexplaining stagesCompare against basic charts.
explaining stages
showing deltas
mapping transitions

Review checklist

3 items
step continuity
loss visibility
cumulative reasoning

Compare against

2 items
basic charts
temporal charts
ImportTSX
Quick copy
UsageTSX
Quick copy
Name
Type
Default
Required
Description
WaterfallDataPoint[]
none
Ordered increases, decreases, and totals.
increaseColor
string
none
Color for increase bars.
decreaseColor
string
none
Color for decrease bars.
totalColor
string
none
Color for total bars.
showConnectors
boolean
true
Displays connectors between bars.
showValues
boolean
true
Displays values on bars.
formatValue
(value: number) => string
none
Formats displayed values.
orientation
"vertical" | "horizontal"
"vertical"
Chart direction.
legend
boolean
none
Displays the family legend.
margin
ChartMargin
none
Insets around the SVG drawing area.
compact
ChartCartesianCompactConfig
none
Configures compact rendering but does not activate it.
compactMode
boolean
false
Activates compact rendering explicitly.
autoCompact
boolean
false
Activates compact rendering below compactBreakpoint.
compactBreakpoint
number
640
Container-width threshold for autoCompact.
width
number | string
none
Chart container width; falls back to the family default.
height
number
none
Chart height; falls back to the family default.
className
string
none
Additional class name applied to the chart wrapper.
style
CSSProperties
none
Inline styles applied to the chart wrapper.
loading
boolean
false
Displays the governed loading state.
title
string
none
Accessible chart title displayed above the plot.
subtitle
string
none
Supporting text displayed below the title.
animate
boolean
none
Overrides the active tenant animation personality.
responsive
boolean
true
Measures and follows the container width.
tooltip
boolean
none
Enables the family tooltip behavior.
dataRequired
WaterfallDataPoint[]none
Ordered increases, decreases, and totals.
increaseColorOptional
stringnone
Color for increase bars.
decreaseColorOptional
stringnone
Color for decrease bars.
totalColorOptional
stringnone
Color for total bars.
showConnectorsOptional
booleantrue
Displays connectors between bars.
showValuesOptional
booleantrue
Displays values on bars.
formatValueOptional
(value: number) => stringnone
Formats displayed values.
orientationOptional
"vertical" | "horizontal""vertical"
Chart direction.
legendOptional
booleannone
Displays the family legend.
marginOptional
ChartMarginnone
Insets around the SVG drawing area.
compactOptional
ChartCartesianCompactConfignone
Configures compact rendering but does not activate it.
compactModeOptional
booleanfalse
Activates compact rendering explicitly.
autoCompactOptional
booleanfalse
Activates compact rendering below compactBreakpoint.
compactBreakpointOptional
number640
Container-width threshold for autoCompact.
widthOptional
number | stringnone
Chart container width; falls back to the family default.
heightOptional
numbernone
Chart height; falls back to the family default.
classNameOptional
stringnone
Additional class name applied to the chart wrapper.
styleOptional
CSSPropertiesnone
Inline styles applied to the chart wrapper.
loadingOptional
booleanfalse
Displays the governed loading state.
titleOptional
stringnone
Accessible chart title displayed above the plot.
subtitleOptional
stringnone
Supporting text displayed below the title.
animateOptional
booleannone
Overrides the active tenant animation personality.
responsiveOptional
booleantrue
Measures and follows the container width.
tooltipOptional
booleannone
Enables the family tooltip behavior.
Charts
18
Kanban Board
Map View
Timeline
Tree View
Communication
Feedback
Workflow
Navigation
Commerce
Customization
Identity
Shell