Skip to main content

Theming

Style the chart through the theme prop. Every field is optional — anything you omit keeps the library default. Most fields are colors; a few are numeric or boolean knobs for wick width and rounded candle/volume shapes.

<VroomChart
candles={candles}
theme={{
// colors
background: '#0d1117',
bull: '#26a69a',
bear: '#ef5350',
accentBull: '#26a69a',
accentBear: '#ef5350',
borderBull: '#1b7a70',
borderBear: '#c0392b',
wickBull: '#26a69a',
wickBear: '#ef5350',
grid: '#1f2630',
axisText: '#8b949e',
crosshair: '#c9d1d9',
crosshairTarget: '#ffffff',
// shape & size
wickWidth: 1,
wickRoundCap: true,
candleRadius: 2,
volumeRadius: 2,
}}
/>

Color formats

A color (VroomColor) is either:

  • a hex string'#0d1117' (6-digit RGB) or '#ff0d1117' (8-digit #aarrggbb with alpha), or
  • a packed ARGB number — e.g. 0xff0d1117.

Colors

FieldAffects
backgroundChart + axis-strip background
bullUp candle body fill
bearDown candle body fill
borderBullUp candle body border (see Candle borders)
borderBearDown candle body border (see Candle borders)
wickBullUp candle wick (defaults to bull)
wickBearDown candle wick (defaults to bear)
accentBullGeneric up color: rising price indicator, up volume bars, MACD histogram
accentBearGeneric down color: falling price indicator, down volume bars, MACD histogram
gridGridlines
axisTextPrice + time axis label text
crosshairCrosshair dashed lines
crosshairTargetThe hollow ring/dot at the crosshair intersection

Shape & size

These control candle geometry. All default to off (square bodies/bars, 1px butt-cap wicks), so charts are unchanged until you set them.

FieldTypeEffect
wickWidthnumber (px)Wick stroke width, for both up and down wicks. Default 1.
wickRoundCapbooleanRound the wick end caps. Default false.
candleRadiusnumber (px)Corner radius of candle bodies (all four corners). Default 0 (square).
volumeRadiusnumber (px)Corner radius of the top corners of volume bars. Default 0 (square).

Radii are clamped to the shape they round, so thin candles and short volume bars degrade gracefully instead of over-rounding.

Candle borders

borderBull / borderBear draw a 1px outline inside the candle body. Drawing it inside means a contrasting border never changes the candle's width, and hiding it leaves the candle exactly its normal size.

  • Hidden (default): omit the field, or set it to the body fill color. The border isn't drawn.
  • Visible: set a contrasting color (e.g. borderBull: '#ffffff') to outline the body from within.

See VroomTheme for the canonical field list.