Chartlark docs
1. Data
The first row is column names. Paste cells copied from Google Sheets, Excel or Numbers, open a CSV, TSV or JSON file, link a Google Sheet (shared as "Anyone with the link can view"; the tab in the link is the one read), or link a JSON file on GitHub or npoint. Up to 1,000 rows.
Numbers are read the way spreadsheets show them: $1,200, 12%, (300) for negatives, 1.2k, and comma decimals like 3,5. Empty cells, dashes and words are gaps, never zeros, and the panel tells you how many it found.
2. Chart types
| Type | Columns | Options |
|---|---|---|
| Column, Bar | Categories, then one or more series | Grouped, stacked or 100% |
| Line, Area | Categories, then series | Straight or smooth, points; areas overlap, stack or fill 100% |
| Pie, Donut | Slices and one value column | More than eight slices are grouped as "Other"; negative values are left out and reported |
| Scatter, Bubble | X, Y, optional bubble size, colour by and point labels | Bubble area follows the size value |
| Combo | Series as bars, plus the ones you tick as lines | Bars and lines share one axis. Two very different scales read better as two charts, so there is no second axis. |
Up to eight series per chart: past eight, colours can't stay apart, so the panel asks you to split the chart.
3. Your colours and type
Under "Your colours and text styles", pick Paint styles or Colour variables. Styles and variables with names like Chart, Data viz or Series are used first, in order; change any series with its menu. You can also set the background, text, axis text and gridlines from them. "Add a library's colours" imports one colour collection from a library enabled in the file. On a dark chart, a variable collection with a mode named Dark switches to it.
Title and label text can use your text styles. If a style's font isn't available on your computer, Chartlark uses Inter and says so.
Patterns and area washes can't sit on a paint style (a style replaces every fill on a layer), so those layers get the style's colour as a value and the panel tells you. Colour variables keep patterns linked.
4. Editing and refreshing
Each chart frame remembers its settings and its data (only the columns it uses when the data is large). Select the chart, or anything inside it, and click Edit: change anything, then Update chart re-draws the same frame in place, keeping its position and any name you gave it. Insert copy makes a second chart instead.
Charts made from a Google Sheet or JSON link show Refresh data, and Refresh all re-draws every linked chart on the page. Each insert, update or refresh is one undo step.
5. Layers
The chart is a frame with vertical auto layout: Header (title and subtitle), Legend (wrapping auto layout), and Plot. Inside Plot: Gridlines, Y axis, X axis, one group per series (Bars: Revenue, Line: Visits), and Value labels. Bars are rectangles with rounded data ends, slices are ellipses with arcs, lines and areas are vectors. Every layer is named after its category or value.
6. Accessibility
Before you insert, the panel checks text contrast (4.5:1), mark contrast against the background (3:1, WCAG 1.4.11), and every touching pair of colours as seen with red-blind and green-blind vision (pie, scatter and bubble check every pair). Pattern fills (diagonal, cross-hatch, dots and more, on every series after the first) keep series apart for colour-blind readers and in greyscale print. Labels never use the series colour, so they stay readable.
What it doesn't do yet
- No second Y axis, on purpose.
- Maps, heatmaps, candlesticks, Sankey and radar charts aren't included.
- Label boxes are sized for Inter-like fonts; very wide fonts may need a wider chart.
- Paint styles from libraries can't be listed by plugins (Figma doesn't allow it); library colour variables can.
Questions: hello@greatwork.company.