Skip to main content

System status

Memory 2.4 GB of 3.8 GB
Disk 98 GB of 116 GB

Over 80%: clear old logs and images before it fills.

Health
Every check passed
CPU load
0.42 on 2 cores
Signed in
12 online
Guests
48 online
Queue
3 waiting, 0 failed

Messages 3 unread

HR Team

4 members · 2 online

Today
Jessy Ellis

Next week we close the project. Any questions before we do?

You

That is excellent news.

Read

Tom Brennan

I have been through the features — cannot wait to demo them.

You

Haven't seen the build yet — looking now.

You

Checking the build now.

Delivered

Jessy is typing…

Jane Perez wants to join

1 day ago · Design Team

Notifications 3 new

  • Today
  • Priya Raman asked you to approve access to Northwind Trading

    Unread. · Members

    Nora O’Brien

    nora@northwind.example · Member

  • Sam Okafor attached a file to Q3 forecast

    Unread. · Finance

    q3-forecast.xlsx

    Spreadsheet · 248 KB

  • Three variants are below their reorder point

    Unread. · Inventory

    Restock before the weekend

    Due 16 August 2026

    Stock Urgent
  • Earlier
  • Your email address is verified

    · Security

  • Marta Kowalski mentioned you in Autumn drop

    · Marketing

  1. UI kit
  2. Charts

Charts

One hook, one JSON attribute, nine chart types and a sparkline mode. Colours come from the resolved tokens rather than a palette in the config, so switching preset or mode re-themes every chart on the page in place — try it while you read.

How a chart is declared

An empty element with data-av-chart and a data-av-chart-options JSON payload. The vendor is lazy-loaded when the element scrolls into view, so a page with a chart below the fold pays nothing for it until it is needed.

A chart is an image, so give it a description

Every chart here carries role="img" and an aria-label that states the actual figures. A canvas of SVG paths is unreadable to a screen reader and to anyone who cannot distinguish the series colours; the label is the chart, for them. Write what the chart says, not that it is a chart.

Area

The default type. moneyAxis runs the y-axis through Intl, so the ticks match the currency formatting everywhere else on the page.

Trend

Something over time. Area for one series, line once there are several — stacked translucent fills stop being readable at about two.

Multi-series line

More than two series takes the categorical ramp. The brand pair is two colours, and Apex would otherwise cycle it.

Sparkline

No axes, no grid, no legend — a shape in a table cell or a stat card.

Sessions

31,204

Conversion

3.9%

Comparison

Bars compare quantities across categories. Go horizontal the moment the labels are words rather than dates — rotated axis labels are a design admitting it ran out of room.

Stacked bar

Negative values stack downwards, which is what makes churn readable against new business.

Horizontal bar

horizontal: true moves moneyAxis to the x-axis with it.

Composition

Parts of a whole. labels replaces categories here — and it must be absent rather than undefined on the other types, because Apex reads .length off it while laying out a bar and throws.

Donut and pie

Four slices is about the ceiling. Past that a horizontal bar is easier to read and easier to label.

Radial bar

For a small number of independent percentages — progress against separate targets, not slices of one total.

Specialist

Same hook, same theming. These take a different series shape, which is the only thing that changes.

Candlestick

Each point is { x, y: [open, high, low, close] }.

Heatmap

Each series is a row; each point is { x, y }. Good for density over two dimensions — day against hour.

Radar

Several measures on one subject. Two series is the readable limit — the shapes overlap.

Treemap

Area is the quantity, so a treemap reads share and outliers at once where a pie only reads share. Tiles take the categorical ramp and label themselves — enableShades is off deliberately, because Apex derives a shade from the resolved colour and that takes the tile out of the token system.

Mixed / combo

Two units on one chart: revenue as columns against margin as a line. Each series carries its own "type" and "mixed": true tells the wrapper to build the stroke width per series — a scalar width would draw a 2.5px outline around every column, which reads as a rendering fault rather than a style.

Funnel

A bar chart Apex tapers. It is only ever horizontal — left vertical it renders as an ordinary column chart with no taper and no error, which is the kind of bug that ships. Bands are distributed across the categorical ramp and labelled in place, so the legend is off.

Options

Everything the wrapper reads. Anything not listed here is passed through to ApexCharts untouched.

Chart options
KeyDefaultEffect
typeareaAny ApexCharts type.
height300Pixels.
series[]Required. Shape depends on the type.
categories[]X-axis labels.
labelsabsentFor donut, pie and radial bar. Must be absent, never undefined.
stackedfalseStack the series.
horizontalfalseRotate a bar chart. Moves moneyAxis with it.
moneyAxisfalseFormat the value axis as currency via Intl.
legendtrueSet false for a single series.
sparklinefalseStrip axes, grid and internal offsets so the shape fills its box.
colorsfrom tokensOverride. Rarely right — the default re-themes with the preset.

Why the colours are not in the config

The wrapper reads the resolved custom properties at render time and subscribes to theme changes, so a preset or mode switch re-themes every chart in place rather than leaving a blue line on a warm page. Both the first render and the re-theme go through one buildOptions(): when those drifted apart, a theme change silently dropped the axis categories and the value formatter, and the chart came back looking fine and reading wrong.

Two other things the module does that a page never sees. A chart is destroyed the moment its element leaves the document, by a MutationObserver rather than on the next scan — an Apex chart keeps its own resize observer, re-measures a parent that no longer exists, and writes NaN into the SVG geometry, which is one console error per attribute on every navigation away. And mount() re-checks isConnected after awaiting the vendor, because the element can be gone by the time a lazy import resolves.

Dashboard Orders Products Customers Account Settings

Keyboard shortcuts