Spiral year chart
A year of weeks, wound into one coil.
Definition · Updated Nov 2, 2026
A spiral year chart winds 52 weeks around a coil, so a whole year reads as one shape and busy and quiet stretches stand out. Notes mark launches and holidays. Use it for weekly activity where the yearly rhythm matters.
Pay once. Every update included.
Live preview
Sample data: active workspaces per week over one year, with a 9-week streak above 2K
- Data shape
- One value per week of a year
- Good for
- Weekly activity, seasonal rhythm
- Avoid when
- Exact week-to-week comparison matters
- Sizes
- XS, S, M and L, re-laid out from the data
Anatomy
Inspect it like the Figma file.
The same layers, names and tokens as the component. Select one to read its size, fill and style.
Layers
051 / Spiral year
- Layer
- peak
- Type
- Ellipse
- Size
- 18 × 18
- Stroke
- text/strong
- Group
- Marks · 53
Layers
051 / Spiral year
- Layer
- peak
- Type
- Ellipse
- Size
- 18 × 18
- Stroke
- text/strong
- Group
- Marks · 53
Layers
051 / Spiral year
- Layer
- peak
- Type
- Ellipse
- Size
- 18 × 18
- Stroke
- text/strong
- Group
- Marks · 53
Sizes
Re-laid out, never scaled.
The same data at XS, S, M and L. Every size is redrawn from the data, so text and line weights never shrink.
M against S
Width360 px480 px
Plot328 px440 px
Labels811
Marks5353
Height212 px246 px
Same tokens at every size: text styles, 1 px lines and mark radius stay put.
When to use
The rhythm of a year.
Three signs it fits, and three signs another type fits better.
Is the yearly rhythm the point?
Only the trend matters.
Yes: Keep the spiral year
Does it cover one year?
Monthly values in one ring.
Yes: Keep the spiral year
Code and Figma
One name in Figma and in code.
Every Figma property is a prop with the same name and values. One command installs it.
Figma
chart/051-spiral-workspaces
npx shadcn add @chartory/spiral-yearimport { SpiralYear } from "@/components/chartory/spiral-year"import { activeWorkspaces } from "./active-workspaces"export function ActiveWorkspaces() { return ( <SpiralYear data={activeWorkspaces} size="m" legend={true} /> )}Hearth widget
Spiral year as a widget.
The chart in a Hearth card with a hero number and two blocks. One token set, light and dark.
EmberPreset
ChartoryDefault preset
Pick the blocks, the size and the preset for your own widget.
Read the Hearth widget docsFAQ
Spiral year questions.
What people ask before they put a spiral year in a dashboard.
Something else?
hello@usechartory.comNamed moments, such as the start, a launch and the new year, plus the busiest and quietest weeks. They sit in the centre caption and the side list, not on the coil.
By each week's share of the busiest week, on a six-step ramp. The legend names three of the steps: quiet, typical and busy. The side list adds the streak (9 weeks above 2K in the sample).
One data object in the sample’s shape: one value per week of a year. The docs page lists every field and links its JSON Schema; the sample data comes with the component, so you can start from it and swap in your own.
Series take the preset’s data colours in order, and states such as up, down or warning take its status colours. Change the preset in Figma or in code to recolour every chart at once.
XS, S, M and L, in light and dark. Each size is laid out again from the data, so text and lines keep their size.
Yes. It plays in when it scrolls into view, and when the data changes every mark moves from its old place to its new one. With reduced motion on, it does not move.
Yes. The React component is free in the public registry in Hearth, no token needed; Signal comes with Code and Complete. The Figma component comes with Figma and Complete.
Ask for it by name. The MCP server tells the agent what data it needs and runs the same command: npx shadcn add @chartory/spiral-year. You review the diff.
Related types
Other ways to show change over time.
The same question, a different shape of answer. Every type ships in Figma and in code.
Same family
Change over time
Trends, levels and seasons across days, months or years.