reflex-rosencharts 0.1.1

A Reflex custom component port of the rosencharts charting library (D3.js + Tailwind), usable from pure Python.

reflex-rosencharts

A port of the rosencharts charting library (43 React/TSX components built with D3.js + Tailwind) to a custom component for Reflex, so the charts can be used from pure Python.

Status: scaffold + SDD plan. The charts are implemented in phases according to specs/plans/implementation-plan.md.

Why?

rosencharts is not an npm package: it's a set of .tsx components to copy and paste, with hardcoded data and Tailwind styling. This project wraps them as local Reflex components (rx.asset + library="$/public..."), parametrizes them to receive data from rx.State, and exposes them as Python functions:

import reflex as rx
import reflex_rosencharts as rxc

class State(rx.State):
    sales: list[dict] = [{"date": "2023-05-01", "value": 6}, {"date": "2023-05-02", "value": 8}]

def index() -> rx.Component:
    return rxc.line_chart(data=State.sales)

Charts (43 across 8 families)

Family	#	Examples
Area	4	area_chart, area_chart_gradient
Bar	12	bar_chart_horizontal, bar_chart_benchmark
Line	8	line_chart, line_chart_multiple
Pie/Donut	8	pie_chart, donut_chart_center_text
Scatter	4	scatter_chart, scatter_chart_interactive
Treemap	3	treemap_chart, treemap_chart_images
Radar	2	radar_chart, radar_chart_rounded
Other	2	bubble_chart, funnel_chart

Full catalog and props: specs/api/component-api-v1.md.

Development

Managed with uv:

uv sync                 # install dependencies
uv run reflex run       # start the demo app / gallery

Specifications (SDD)

The project follows Spec-Driven Design. The specs are the primary artifact:

• PRD — the what and the who-for
• API Spec — public Python API (functions, props)
• Technical Design — wrapping pattern and architecture
• Data Model — per-chart data schemas
• Implementation Plan — phases by family

The original code (reference, read-only) lives in reference/rosencharts/.

License and attribution

MIT. This project is a port of rosencharts by Filsommer (MIT). See LICENSE and NOTICE.