Skip to content

spec: add streamgraph-basic specification - #864

Merged
github-actions[bot] merged 1 commit into
mainfrom
specification/streamgraph-basic
Dec 14, 2025
Merged

spec: add streamgraph-basic specification#864
github-actions[bot] merged 1 commit into
mainfrom
specification/streamgraph-basic

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

New Specification: streamgraph-basic

Closes #856


specification.md

streamgraph-basic: Basic Stream Graph

Description

A streamgraph (also known as a stacked area chart with a centered baseline) displaying the composition of multiple categories over time with smooth, flowing curves. Unlike traditional stacked area charts, streamgraphs use a symmetric baseline centered around the x-axis, creating an organic, river-like appearance that emphasizes the overall shape and relative proportions of each category while minimizing the visual distortion of individual layers.

Applications

  • Music listening trends showing genre popularity over months
  • Topic popularity evolution in social media or news
  • Market share changes among competitors over time
  • Resource allocation across teams or projects over quarters

Data

  • time (datetime/numeric) - continuous time axis for the x-dimension
  • category (categorical) - distinct categories/series to stack
  • value (numeric) - magnitude for each category at each time point
  • Size: 10-100 time points with 3-8 categories
  • Example: monthly streaming hours by music genre over two years

Notes

  • Use smooth interpolation (spline/basis) for flowing curves
  • Center the baseline symmetrically around the x-axis
  • Use distinct, harmonious colors for each category
  • Include a legend to identify categories
  • Consider color palette that works well for adjacent areas

Next: Add approved label to the issue to merge this PR.


🤖 spec-create workflow

@github-actions
github-actions Bot merged commit 9ed2551 into main Dec 14, 2025
4 checks passed
@github-actions
github-actions Bot deleted the specification/streamgraph-basic branch December 14, 2025 19:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[streamgraph-basic] Basic Stream Graph

0 participants