A charting library for Typst built entirely with native primitives (rect, circle, line, polygon, place). No external dependencies required.
All 50+ chart types across 7 pages — see examples/showcase.typ for the source:
| File | Description |
|---|---|
examples/demos/ |
19 per-chart demo files, each a 2×2 grid (light/dark + variations) |
examples/showcase.typ |
Compact 7-page showcase of all chart types (dark theme) |
examples/demo.typ |
Comprehensive demo with all features, themes, and data loading |
Shared datasets in data/ used by both demo and showcase:
data/sales.json— SaaS startup metricsdata/codebase.json— Open source project statsdata/league.json— Soccer league datadata/rpg.json— D&D campaign trackerdata/words.json— Data visualization vocabulary
just demos # Compile all per-chart demos
just showcase # Compile the showcase
just demo # Compile the comprehensive demo- 50+ chart types for data visualization
- JSON data input — load data directly from JSON files
- Theme system — preset themes, custom overrides, and
with-theme()for document-wide defaults - Smart label placement — automatic fit detection, font shrinking, and greedy deconfliction for overlapping labels
- Layout primitives — shared utilities for label density, font scaling, and label placement
- Annotations — overlay reference lines, bands, and labels on Cartesian charts
- Customizable — colors, sizes, labels, legends
- Pure Typst — no packages or external tools needed
bar-chart- Vertical bar charthorizontal-bar-chart- Horizontal bar chartgrouped-bar-chart- Side-by-side grouped barsstacked-bar-chart- Stacked bar segmentsgrouped-stacked-bar-chart- Groups of stacked segments side by sidelollipop-chart- Vertical stem + dot (cleaner bar alternative)horizontal-lollipop-chart- Horizontal stem + dotdiverging-bar-chart- Left/right bars from center axis
line-chart- Single line with pointsmulti-line-chart- Multiple series comparisondual-axis-chart- Two independent Y-axesarea-chart- Filled area under linestacked-area-chart- Stacked area series
pie-chart- Pie chart with legendpie-chart(donut mode) - Donut/ring chartradar-chart- Spider/radar chart
scatter-plot- X/Y point plottingmulti-scatter-plot- Multi-series scatterbubble-chart- Scatter with size dimension, smart label deconfliction (inside/outside with leaders)multi-bubble-chart- Multi-series bubble chart
gauge-chart- Semi-circular dial gaugeprogress-bar- Horizontal progress barcircular-progress- Ring progress indicatorring-progress- Concentric fitness rings (Apple Watch style)progress-bars- Multiple comparison bars
sparkline- Tiny line chart for tables and textsparkbar- Tiny bar chartsparkdot- Tiny dot chart
heatmap- Grid heatmap with color scalecalendar-heatmap- GitHub-style activity gridcorrelation-matrix- Symmetric correlation display
histogram- Auto-binned frequency distributionwaterfall-chart- Bridge/waterfall chart with pos/neg/total segmentsfunnel-chart- Conversion funnel with percentages, auto external labels for narrow sectionsbox-plot- Box-and-whisker distribution plottreemap- Nested rectangles for hierarchical dataslope-chart- Two-period comparison with connecting linesbullet-chart- Compact gauge with qualitative ranges and targetbullet-charts- Multiple bullet charts stacked vertically
waffle-chart- 10×10 grid of colored squares for proportionssunburst-chart- Multi-level hierarchical pie with nested ringsparliament-chart- Semicircle dot layout for seat visualization
bump-chart- Multi-period ranking chartdumbbell-chart- Before/after dot comparisons with connecting linesradial-bar-chart- Circular bars radiating from center
violin-plot- Kernel density estimation with mirrored polygon
sankey-chart- Flow diagram with curved bands between nodesgantt-chart- Timeline bar chart for project schedulingtimeline-chart- Vertical event timeline with alternating layoutchord-diagram- Circular flow diagram with chord bands
metric-card- KPI tile with value, delta, and sparklinemetric-row- Horizontal row of metric cardsword-cloud- Weighted text layout sized by importance
Overlay reference lines, bands, and labels on bar, line, and scatter charts:
h-line- Horizontal reference line (target, average, threshold)v-line- Vertical reference lineh-band- Horizontal shaded region (goal zone, range)label- Text label at a data point
#import "@preview/primaviz:0.4.1": *#import "@preview/primaviz:0.4.1": *
// Load data from JSON
#let data = json("mydata.json")
// Create a bar chart
#bar-chart(
(
labels: ("A", "B", "C", "D"),
values: (25, 40, 30, 45),
),
width: 300pt,
height: 200pt,
title: "My Chart",
)
// Create a pie chart
#pie-chart(
(
labels: ("Red", "Blue", "Green"),
values: (30, 45, 25),
),
size: 150pt,
donut: true,
)
// Create a radar chart
#radar-chart(
(
labels: ("STR", "DEX", "CON", "INT", "WIS", "CHA"),
series: (
(name: "Fighter", values: (18, 12, 16, 10, 13, 8)),
(name: "Wizard", values: (8, 14, 12, 18, 15, 11)),
),
),
size: 200pt,
title: "Character Comparison",
)Every chart function accepts an optional theme parameter. Themes control colors, font sizes, grid lines, backgrounds, and other visual properties.
#import "@preview/primaviz:0.4.1": *
#bar-chart(data, theme: themes.dark)Use with-theme() to set a default theme for all charts in a block — no need to pass theme: to every chart. Explicit per-chart theme: parameters still override.
// Block wrapper
#with-theme(themes.dark)[
#bar-chart(data) // uses dark theme
#pie-chart(data2) // uses dark theme
#line-chart(data3, theme: themes.minimal) // explicit override wins
]
// Or as a show rule for the entire document
#show: with-theme.with(themes.dark)Pass a dictionary with only the keys you want to change. Unspecified keys fall back to the default theme:
#bar-chart(data, theme: (show-grid: true, palette: (red, blue, green)))| Preset | Description |
|---|---|
themes.default |
Tableau 10 color palette, no grid, standard font sizes |
themes.minimal |
Lighter axis strokes, grid enabled, regular-weight titles |
themes.dark |
Dark background (#1a1a2e), vibrant neon palette (cyan, pink, purple, ...) |
themes.presentation |
Larger font sizes across the board for slides and projectors |
themes.print |
Grayscale palette with grid lines, optimized for black-and-white printing |
themes.accessible |
Okabe-Ito colorblind-safe palette |
(
labels: ("Jan", "Feb", "Mar"),
values: (100, 150, 120),
)(
labels: ("Q1", "Q2", "Q3"),
series: (
(name: "Product A", values: (100, 120, 140)),
(name: "Product B", values: (80, 90, 110)),
),
)(
x: (1, 2, 3, 4, 5),
y: (10, 25, 15, 30, 20),
size: (5, 10, 8, 15, 12), // for bubble chart
)(
rows: ("Row1", "Row2", "Row3"),
cols: ("Col1", "Col2", "Col3"),
values: (
(1, 2, 3),
(4, 5, 6),
(7, 8, 9),
),
)The default theme uses Tableau 10 colors. You can access colors from any theme via the get-color function:
#import "@preview/primaviz:0.4.1": get-color, themes
// Default palette
#get-color(themes.default, 0) // blue
#get-color(themes.default, 1) // orange
#get-color(themes.default, 2) // red
// Or use a theme preset
#get-color(themes.dark, 0) // cyanprimaviz/
src/
lib.typ # Public entrypoint — re-exports everything
theme.typ # Theme system and preset themes
util.typ # Shared utilities
validate.typ # Input validation helpers
charts/ # One module per chart family
bar.typ # bar, horizontal, grouped, stacked, grouped-stacked
line.typ # line, multi-line
dual-axis.typ # dual Y-axis
area.typ # area, stacked-area
pie.typ # pie, donut
radar.typ # spider/radar chart
scatter.typ # scatter, multi-scatter, bubble, multi-bubble
gauge.typ # gauge, progress-bar, circular-progress, progress-bars
rings.typ # ring-progress (fitness rings)
heatmap.typ # heatmap, calendar-heatmap, correlation-matrix
sparkline.typ # sparkline, sparkbar, sparkdot
waterfall.typ # bridge/waterfall chart
funnel.typ # conversion funnel
boxplot.typ # box-and-whisker plot
histogram.typ # auto-binned frequency distribution
treemap.typ # nested rectangles
lollipop.typ # lollipop, horizontal-lollipop
sankey.typ # flow diagram
bullet.typ # bullet-chart, bullet-charts
slope.typ # two-period comparison
diverging.typ # left/right diverging bars
gantt.typ # project timeline
waffle.typ # proportional grid
bump.typ # ranking chart
dumbbell.typ # before/after comparison
radial-bar.typ # circular bars
sunburst.typ # multi-level hierarchical pie
metric.typ # metric-card, metric-row
violin.typ # kernel density estimation
timeline.typ # vertical event timeline
parliament.typ # semicircle seat chart
chord.typ # circular flow diagram
wordcloud.typ # spiral-placement word cloud
primitives/ # Low-level drawing helpers
axes.typ # axis lines, ticks, labels, grid, cartesian-layout
layout.typ # density-skip, font-for-space, page-grid, label placement, deconfliction
annotations.typ # reference lines, bands, labels
container.typ # chart container wrapper
legend.typ # horizontal, vertical, draw-legend-auto
polar.typ # shared polar/radial helpers (arcs, slices, labels)
title.typ # title rendering
examples/
demos/ # Per-chart demo files (19 files, 2×2 grids)
demo-bar.typ # bar-chart, horizontal-bar-chart
demo-bar-multi.typ # grouped-bar, stacked-bar
demo-bar-advanced.typ # grouped-stacked, diverging
demo-line.typ # line-chart, multi-line-chart
demo-area.typ # area-chart, stacked-area-chart
demo-dual-axis.typ # dual-axis-chart (4 themes)
demo-pie.typ # pie-chart, donut
demo-radar.typ # radar-chart (4 variants)
demo-scatter.typ # scatter, multi-scatter, bubble
demo-gauge.typ # gauge, progress-bar, circular-progress
demo-heatmap.typ # heatmap, calendar-heatmap, correlation-matrix
demo-statistical.typ # histogram, box-plot, violin, waterfall
demo-comparison.typ # slope, dumbbell, lollipop, bullet
demo-flow.typ # sankey, gantt, timeline, chord
demo-misc.typ # waffle, parliament, radial-bar, sunburst
demo-dashboard.typ # metric-row, word-cloud, sparklines, progress-bars
demo-rings.typ # ring-progress, treemap
demo-bump.typ # bump-chart, funnel-chart
demo-themes.typ # theme comparison (all 6 presets + with-theme)
showcase.typ # 7-page compact showcase (dark theme)
demo.typ # Comprehensive demo with JSON data loading
data/ # Sample JSON data files
screenshots/
demo/ # Per-chart demo screenshots (demo-*.png)
showcase/ # Showcase page screenshots (showcase-*.png)
justfile # Common dev commands
Dev commands via just:
just demos # Compile all per-chart demos
just demo # Compile the comprehensive demo
just showcase # Compile the showcase
just watch # Live-reload during development
just watch-demo bar # Watch a specific demo (e.g., bar, pie, scatter)
just test # Run all compilation tests
just check # Full CI check (demo + demos + showcase + tests)
just screenshots # Regenerate screenshots (screenshots/demo/ + screenshots/showcase/)
just open # Compile and open the demo PDF
just dev # Watch with live-reload and open PDF
just clean # Clean generated artifacts
just release # Full release prep (check + screenshots)
just stats # Show project statsIssue tracking with beads.
MIT