# dash-mui-charts — MUI X charts for Dash

> dash-mui-charts — 13 Plotly Dash components wrapping MUI X: LineChart, BarChart, CandlestickChart, PieChart, ScatterChart, CompositeChart, Heatmap, SparklineChart, LiveTradingChart, TreeView, SimpleTreeView, TreeViewPro and TimeClock. Interactive documentation with live examples, dark mode and MUI X Pro features. By Pip Install Python.

dash-mui-charts is a Plotly Dash component library of 13 components wrapping
MUI X Charts, MUI X Tree View, and MUI X Date & Time Pickers for Python
developers. Every component ships with full Python type hints and exposes
its interactions (clicks, selections, zoom, edits) as Dash callback
properties. Built by Pip Install Python; MIT licensed.

## Install

```bash
pip install dash-mui-charts
```

## Components

Charts (MUI X Charts):

- **LineChart** — line/area charts, biaxial axes, zoom/pan, brush selection,
  reference lines (Community / Pro). Docs: /linechart-basic
- **BarChart** — vertical/horizontal bars, stacking, bar labels, dataset
  mode, zoom/brush (Community / Pro). Docs: /barchart-basic
- **CandlestickChart** — OHLC candlesticks with volume overlay, reference
  lines, click events (Community / Pro). Docs: /candlestick
- **PieChart** — pie, donut, and nested pies (Community). Docs: /pie
- **ScatterChart** — scatter/point charts, z-axis color mapping, voronoi
  interaction (Community). Docs: /scatter
- **CompositeChart** — layer scatter + line plots on one surface, multi-axis
  (Community / Pro). Docs: /composite
- **Heatmap** — matrix/grid visualization with color scales (Pro).
  Docs: /heatmap
- **SparklineChart** — compact inline charts for dashboards and tables
  (Community). Docs: /sparkline
- **LiveTradingChart** — real-time streaming charts (Community / Pro).
  Docs: /live-trading

Tree View (MUI X Tree View):

- **TreeView** — data-driven RichTreeView: selection, expansion, inline
  label editing, disabling (Community). Docs: /tree-basic
- **SimpleTreeView** — lightweight JSX-driven tree for navigation sidebars
  (Community). Docs: /tree-simple
- **TreeViewPro** — drag-and-drop reordering, lazy loading, per-item
  slider + kebab menu controls (Pro). Docs: /tree-pro

Date & Time Pickers (MUI X Date Pickers):

- **TimeClock** — inline clock-face time picker, string in/out values
  (Community). Docs: /time-clock

## Community vs Pro

Community features work with no license. MUI X Pro features — LineChart /
BarChart / CompositeChart zoom, pan, slider, brush and toolbar; Heatmap;
TreeViewPro reordering, lazy loading and per-item controls — require an
MUI X Pro license key passed via the `licenseKey` prop (the demo app reads
it from the `MUI_PRO_API_KEY` environment variable).

## Quick start

```python
from dash import Dash, html
from dash_mui_charts import LineChart

app = Dash(__name__)

app.layout = html.Div([
    LineChart(
        id='my-chart',
        height=400,
        series=[
            {'data': [1, 4, 2, 5, 7], 'label': 'Series A'},
        ],
        xAxis=[{'data': [1, 2, 3, 4, 5]}],
    )
])

if __name__ == '__main__':
    app.run(debug=True)
```

## More documentation pages

- LineChart: /linechart-pro, /linechart-brush, /linechart-referencelines,
  /linechart-highlighting, /highlighting-sync, /linechart-zoom-preview,
  /linechart-tick-hover, /crosshair
- BarChart: /barchart-dataset, /barchart-stacking, /barchart-interaction,
  /barchart-reference, /barchart-pro
- Pie / Heatmap / Sparkline explorers: /pie-props, /heatmap-props,
  /sparkline-style, /sparkline-style-advanced
- CompositeChart: /composite-v120, /composite-render-bp
- Tree View: /tree-selection, /tree-expansion, /tree-editing, /tree-icons,
  /tree-disabled, /tree-pro
- TimeClock: /time-clock-lab
- Release history: /changelog

## Links

- GitHub: https://github.com/pip-install-python/dash-mui-charts
- PyPI: https://pypi.org/project/dash-mui-charts/
- MUI X Charts: https://mui.com/x/react-charts/

## Other sizes of this document

- [/llms-small.txt](https://muicharts.2plot.dev/llms-small.txt): compact briefing — start here if context is tight. (11.2 KB, ~2.9k tok)
- [/llms.txt](https://muicharts.2plot.dev/llms.txt): this document — the index you are reading. (21.6 KB, ~5.5k tok)
- [/llms-full.txt](https://muicharts.2plot.dev/llms-full.txt): every page's prose in one document — 43 pages. (761.8 KB, ~195.0k tok)

## Access policy

- Terms: these documents are free to fetch. A free account unlocks any gated document.
- Identity: agents may present a key by appending `?key=<value>` to any document URL.
- Rate: prefer ONE `/llms-full.txt` fetch over N per-page fetches. On 429, honour `Retry-After` and back off exponentially.
- Coordination: start at https://2plot.dev/llms.txt — one index enumerates every site; do not rediscover the network by crawling it.
- Crawler policy (mirrors /robots.txt): allowed: GPTBot, ClaudeBot, CCBot, Google-Extended, FacebookBot, Omgili, ByteSpider, Amazonbot, Applebot-Extended, meta-externalagent, AI2Bot, Diffbot, Timpibot, ImagesiftBot, ChatGPT-User, Claude-User, Claude-SearchBot, PerplexityBot, OAI-SearchBot, Perplexity-User, Googlebot, Bingbot, Slurp, DuckDuckBot, GoogleOther, Google-InspectionTool, Storebot-Google, AdsBot-Google.
- Accounting: every document read is logged with the requesting vendor (verified against published IP ranges where the operator publishes them). See https://2plot.dev/llms.txt

## Pages

Every page in this application. Each has a Markdown version at the `llms.txt` URL beside it.

- [dash-mui-charts — MUI X charts for Dash](https://muicharts.2plot.dev/): dash-mui-charts — 13 Plotly Dash components wrapping MUI X: LineChart, BarChart, CandlestickChart, PieChart, ScatterChart, CompositeChart, Heatmap, SparklineChart, LiveTradingChart, TreeView, SimpleTreeView, TreeViewPro and TimeClock. Interactive documentation with live examples, dark mode and MUI X Pro features. By Pip Install Python.
  - Machine-readable: https://muicharts.2plot.dev/llms.txt (21.6 KB, ~5.5k tok)
- [API Reference](https://muicharts.2plot.dev/api): Every prop of all 13 dash-mui-charts components — generated from the components' own metadata, so it always matches the installed version.
  - Machine-readable: https://muicharts.2plot.dev/api/llms.txt (58.6 KB, ~15.0k tok)
- [Bar Chart - Basic](https://muicharts.2plot.dev/barchart-basic): BarChart basics for Dash: multi-series vertical, stacked and horizontal bars, bar labels, rounded corners, custom colors and negative values.
  - Machine-readable: https://muicharts.2plot.dev/barchart-basic/llms.txt (5.5 KB, ~1.4k tok)
- [Bar Chart - Dataset](https://muicharts.2plot.dev/barchart-dataset): BarChart dataset mode: pass table-format data once and reference columns by dataKey, with stacked series and bar/category gap control.
  - Machine-readable: https://muicharts.2plot.dev/barchart-dataset/llms.txt (3.8 KB, ~962 tok)
- [Bar Chart - Interaction](https://muicharts.2plot.dev/barchart-interaction): BarChart interaction in Dash: bar and axis click callbacks, series highlighting, axis highlight modes, and axis vs item tooltip triggers.
  - Machine-readable: https://muicharts.2plot.dev/barchart-interaction/llms.txt (8.1 KB, ~2.1k tok)
- [Bar Chart - Pro](https://muicharts.2plot.dev/barchart-pro): BarChart Pro features with a MUI X license key: zoom with slider, zoom plus toolbar, and stacked bars with zoom on 52 weeks of data.
  - Machine-readable: https://muicharts.2plot.dev/barchart-pro/llms.txt (4.7 KB, ~1.2k tok)
- [Bar Chart - Reference Lines](https://muicharts.2plot.dev/barchart-reference): BarChart reference lines and styling: target and threshold markers, vertical reference lines, skip animation, hidden legend and custom color palettes.
  - Machine-readable: https://muicharts.2plot.dev/barchart-reference/llms.txt (6.0 KB, ~1.5k tok)
- [Bar Chart - Stacking](https://muicharts.2plot.dev/barchart-stacking): BarChart stacking options: standard, normalized (expand) and diverging stack offsets, multiple stack groups, and horizontal stacked bars.
  - Machine-readable: https://muicharts.2plot.dev/barchart-stacking/llms.txt (5.4 KB, ~1.4k tok)
- [Candlestick Chart](https://muicharts.2plot.dev/candlestick): CandlestickChart OHLC demos: array and dataset formats, volume overlay, candle styling, support/resistance reference lines and click events.
  - Machine-readable: https://muicharts.2plot.dev/candlestick/llms.txt (8.0 KB, ~2.1k tok)
- [Changelog](https://muicharts.2plot.dev/changelog): Version history of dash-mui-charts, rendered from CHANGELOG.md.
  - Machine-readable: https://muicharts.2plot.dev/changelog/llms.txt (77.8 KB, ~19.9k tok)
- [Composite Chart (0.0.8)](https://muicharts.2plot.dev/composite): CompositeChart demos layering scatter and line series on one surface: trend overlays, reference lines, multi-axis charts and Pro zoom with slider preview.
  - Machine-readable: https://muicharts.2plot.dev/composite/llms.txt (23.1 KB, ~5.9k tok)
- [Composite Render BP](https://muicharts.2plot.dev/composite-render-bp): Best-practice CompositeChart rendering for stacked discharge/temperature/pressure dashboards across 7d-live to 1yr+ date ranges (~2k to 150k+ points).
  - Machine-readable: https://muicharts.2plot.dev/composite-render-bp/llms.txt (41.8 KB, ~10.7k tok)
- [CompositeChart v1.2.0](https://muicharts.2plot.dev/composite-v120): CompositeChart v1.2.0 demos: the axis tooltip fix, the highlightedAxis output, and cross-chart crosshair sync up to a 3-chart stacked dashboard.
  - Machine-readable: https://muicharts.2plot.dev/composite-v120/llms.txt (23.9 KB, ~6.1k tok)
- [Crosshair Explorer](https://muicharts.2plot.dev/crosshair): CompositeChart crosshair tracking with live coordinate readout, right-click alert placement, and a synced three-chart dashboard with HoverCard-managed alerts.
  - Machine-readable: https://muicharts.2plot.dev/crosshair/llms.txt (23.8 KB, ~6.1k tok)
- [Heatmap](https://muicharts.2plot.dev/heatmap): Heatmap (MUI X Pro) demos: activity grids, a correlation matrix, continuous and piecewise color scales, custom cell styling and click interaction.
  - Machine-readable: https://muicharts.2plot.dev/heatmap/llms.txt (11.3 KB, ~2.9k tok)
- [Heatmap Props](https://muicharts.2plot.dev/heatmap-props): Interactive Heatmap props playground (MUI X Pro): live controls for color scale, dimensions, cell style, interactions and margins on a 5x5 grid.
  - Machine-readable: https://muicharts.2plot.dev/heatmap-props/llms.txt (22.1 KB, ~5.7k tok)
- [Highlighting Sync](https://muicharts.2plot.dev/highlighting-sync): Synchronized highlighting across charts: hover one to highlight matching data in others — LineChart + PieChart and two LineCharts sharing highlightedItem state.
  - Machine-readable: https://muicharts.2plot.dev/highlighting-sync/llms.txt (27.3 KB, ~7.0k tok)
- [LineChart Basics](https://muicharts.2plot.dev/linechart-basic): Fundamentals of the LineChart Dash component: grid, area and stacked-area charts, curve interpolation, dual y-axes, and click-event callbacks.
  - Machine-readable: https://muicharts.2plot.dev/linechart-basic/llms.txt (18.3 KB, ~4.7k tok)
- [LineChart Brush](https://muicharts.2plot.dev/linechart-brush): Pro brush range selection on LineChart: drag to select a region, overlay types (none, default, values with % change), brushConfig and axis highlight options.
  - Machine-readable: https://muicharts.2plot.dev/linechart-brush/llms.txt (13.8 KB, ~3.5k tok)
- [LineChart Highlighting](https://muicharts.2plot.dev/linechart-highlighting): Controlled highlighting on LineChart: set highlightedItem and highlightedAxis from Dash callbacks, plus per-series highlightScope highlight/fade behavior.
  - Machine-readable: https://muicharts.2plot.dev/linechart-highlighting/llms.txt (17.2 KB, ~4.4k tok)
- [LineChart Pro](https://muicharts.2plot.dev/linechart-pro): MUI X Pro features on LineChart: zoom and pan with a slider, zoom configuration options, biaxial zoom, and controlled zoom state via Dash callbacks.
  - Machine-readable: https://muicharts.2plot.dev/linechart-pro/llms.txt (16.4 KB, ~4.2k tok)
- [LineChart Reference Lines](https://muicharts.2plot.dev/linechart-referencelines): Horizontal and vertical reference lines on LineChart: targets, thresholds, label alignment, dash styles, multi-axis axisId, and dynamic updates via callbacks.
  - Machine-readable: https://muicharts.2plot.dev/linechart-referencelines/llms.txt (31.6 KB, ~8.1k tok)
- [LineChart Ticks & Hover](https://muicharts.2plot.dev/linechart-tick-hover): Best practices for LineChart tooltips, reference lines, ticks and grid across week, quarter and year date ranges, with fixes for alignment at large ranges.
  - Machine-readable: https://muicharts.2plot.dev/linechart-tick-hover/llms.txt (43.9 KB, ~11.2k tok)
- [Zoom Preview (0.0.8)](https://muicharts.2plot.dev/linechart-zoom-preview): LineChart Pro zoom slider with a miniature full-dataset preview, zoomInteractionConfig for fine-grained zoom/pan control, and enhanced axis tick styling.
  - Machine-readable: https://muicharts.2plot.dev/linechart-zoom-preview/llms.txt (22.2 KB, ~5.7k tok)
- [Live Trading Chart](https://muicharts.2plot.dev/live-trading): LiveTradingChart real-time candlestick simulation with OHLCV data, volume bars, forecast band, swing-point alert labels, and slider-controlled parameters.
  - Machine-readable: https://muicharts.2plot.dev/live-trading/llms.txt (12.2 KB, ~3.1k tok)
- [Pie Chart](https://muicharts.2plot.dev/pie): PieChart demos: basic pie, donut, arc labels, styled slices, half-pie gauge, and an interactive example with clickData and highlightedItem callbacks.
  - Machine-readable: https://muicharts.2plot.dev/pie/llms.txt (9.1 KB, ~2.3k tok)
- [Pie Chart Props](https://muicharts.2plot.dev/pie-props): Interactive playground for nested two-ring PieCharts on Titanic survival data with live controls for dimensions, radii, ring gap, labels and highlighting.
  - Machine-readable: https://muicharts.2plot.dev/pie-props/llms.txt (33.4 KB, ~8.6k tok)
- [Privacy](https://muicharts.2plot.dev/privacy): What dash-mui-charts records when you read the documentation, and what it does not.
  - Machine-readable: https://muicharts.2plot.dev/privacy/llms.txt (3.5 KB, ~898 tok)
- [Scatter Chart](https://muicharts.2plot.dev/scatter): ScatterChart demos: two-series scatter, custom marker sizes, z-axis color mapping, log-scale axes, click events, dataset-driven series and axis styling.
  - Machine-readable: https://muicharts.2plot.dev/scatter/llms.txt (11.8 KB, ~3.0k tok)
- [SparklineChart](https://muicharts.2plot.dev/sparkline): SparklineChart demos: line, area and bar sparklines for KPI cards and tables, synced multi-metric hover, custom curves and callback-driven data.
  - Machine-readable: https://muicharts.2plot.dev/sparkline/llms.txt (23.7 KB, ~6.1k tok)
- [Sparkline Style](https://muicharts.2plot.dev/sparkline-style): Interactive SparklineChart styling playground: tweak color, plot type, curve, area, size and highlights with a live preview and generated code.
  - Machine-readable: https://muicharts.2plot.dev/sparkline-style/llms.txt (25.8 KB, ~6.6k tok)
- [Sparkline Advanced](https://muicharts.2plot.dev/sparkline-style-advanced): Advanced SparklineChart demo: a liquid glass (glassmorphism) stock card with reveal animation, hover opacity effects and real-time value display.
  - Machine-readable: https://muicharts.2plot.dev/sparkline-style-advanced/llms.txt (8.7 KB, ~2.2k tok)
- [Terms](https://muicharts.2plot.dev/terms): The terms dash-mui-charts's documentation and component library are offered under.
  - Machine-readable: https://muicharts.2plot.dev/terms/llms.txt (2.6 KB, ~665 tok)
- [Time Clock](https://muicharts.2plot.dev/time-clock): TimeClock demos mirroring the MUI docs: basic usage, controlled vs uncontrolled values, disabled/readOnly, view configuration and 12h/24h format.
  - Machine-readable: https://muicharts.2plot.dev/time-clock/llms.txt (10.7 KB, ~2.7k tok)
- [TimeClock Lab](https://muicharts.2plot.dev/time-clock-lab): TimeClock experiments: live recoloring, a liquid-glass theme, a stopwatch, and two-way pairings with DMC TimeInput, TimePicker, TimeGrid and DateTimePicker.
  - Machine-readable: https://muicharts.2plot.dev/time-clock-lab/llms.txt (36.7 KB, ~9.4k tok)
- [Tree Basic](https://muicharts.2plot.dev/tree-basic): TreeView basics for Dash: data-driven items, defaultExpandedItems, click and focus tracking, and custom getItemId/getItemLabel accessors.
  - Machine-readable: https://muicharts.2plot.dev/tree-basic/llms.txt (8.4 KB, ~2.1k tok)
- [Tree Disabled](https://muicharts.2plot.dev/tree-disabled): TreeView disabled items: disabledItems blocking selection, checkbox propagation that skips them, disabledItemsFocusable, and disabled parent nodes.
  - Machine-readable: https://muicharts.2plot.dev/tree-disabled/llms.txt (4.8 KB, ~1.2k tok)
- [Tree Editing](https://muicharts.2plot.dev/tree-editing): Inline TreeView label editing: isItemEditable for all items, editableItems for a subset, and editedItemLabel callbacks with an edit history log.
  - Machine-readable: https://muicharts.2plot.dev/tree-editing/llms.txt (5.8 KB, ~1.5k tok)
- [Tree Expansion](https://muicharts.2plot.dev/tree-expansion): TreeView expansion control: content vs iconContainer triggers, controlled expandedItems with expand/collapse-all buttons, and expansion tracking.
  - Machine-readable: https://muicharts.2plot.dev/tree-expansion/llms.txt (5.6 KB, ~1.4k tok)
- [Tree Icons](https://muicharts.2plot.dev/tree-icons): TreeView appearance: custom expand/collapse/end icons, itemChildrenIndentation, fixed height with scrolling, and sx styling.
  - Machine-readable: https://muicharts.2plot.dev/tree-icons/llms.txt (6.7 KB, ~1.7k tok)
- [Tree Pro](https://muicharts.2plot.dev/tree-pro): TreeViewPro (MUI X Pro): drag-and-drop reordering, reorderable subsets, and per-item 0-100 sliders plus kebab action menus wired to Dash callbacks.
  - Machine-readable: https://muicharts.2plot.dev/tree-pro/llms.txt (25.8 KB, ~6.6k tok)
- [Tree Selection](https://muicharts.2plot.dev/tree-selection): TreeView selection modes: single, multi-select, checkbox selection, parent/descendant propagation, disabled selection, and controlled selectedItems.
  - Machine-readable: https://muicharts.2plot.dev/tree-selection/llms.txt (7.6 KB, ~1.9k tok)
- [Tree Simple](https://muicharts.2plot.dev/tree-simple): SimpleTreeView examples: itemId/label items, checkbox multi-select, per-item disabled flags, custom icons, and the iconContainer expansion trigger.
  - Machine-readable: https://muicharts.2plot.dev/tree-simple/llms.txt (13.0 KB, ~3.3k tok)

## About The 2plot network

Open-source Dash component libraries by Pip Install Python. Each component has its own documentation site and its own llms.txt; 2plot.dev indexes all of them, and 2plot.ai is the hub.

Network index: [https://2plot.dev](https://2plot.dev/llms.txt)

## Network

Other applications in this network. Same operator; each one serves its own `/llms.txt` in this format.

- [2plot.ai](https://2plot.ai): Network hub and account origin.
  - Machine-readable: https://2plot.ai/llms.txt
- [2plot.dev](https://2plot.dev): Package index for every open-source component in the network.
  - Machine-readable: https://2plot.dev/llms.txt
- [Documentation boilerplate](https://boilerplate.2plot.dev): The markdown-driven documentation template every satellite site is built from.
  - Machine-readable: https://boilerplate.2plot.dev/llms.txt
- [dash-leaflet2](https://leaflet.2plot.dev): Leaflet 2 maps as Dash components.
  - Machine-readable: https://leaflet.2plot.dev/llms.txt
- [dash-mui-scheduler](https://muischeduler.2plot.dev): MUI X Scheduler — calendars and event scheduling for Dash.
  - Machine-readable: https://muischeduler.2plot.dev/llms.txt
- [flexlayout-dash](https://flexlayout.2plot.dev): IDE-style dockable, resizable and floatable window panels.
  - Machine-readable: https://flexlayout.2plot.dev/llms.txt
- [dash-improve-my-llms](https://llms.2plot.dev): The AI/LLM and SEO package every site in this network is built on.
  - Machine-readable: https://llms.2plot.dev/llms.txt
- [dash-flows](https://flows.2plot.dev): Node-graph editors built on React Flow.
  - Machine-readable: https://flows.2plot.dev/llms.txt
- [dash-pannellum](https://pannellum.2plot.dev): 360° panorama and virtual-tour viewer.
  - Machine-readable: https://pannellum.2plot.dev/llms.txt
- [dash-emoji-mart](https://emojimart.2plot.dev): Emoji picker component.
  - Machine-readable: https://emojimart.2plot.dev/llms.txt
- [dash-email](https://email.2plot.dev): Email composition and delivery components.
  - Machine-readable: https://email.2plot.dev/llms.txt
- [dash-model-viewer](https://modelviewer.2plot.dev): 3D model viewer with AR support, built on Google's model-viewer.
  - Machine-readable: https://modelviewer.2plot.dev/llms.txt
- [dash-excalidraw](https://excalidraw.2plot.dev): Excalidraw virtual whiteboard and sketching canvas.
  - Machine-readable: https://excalidraw.2plot.dev/llms.txt

## Related projects

Projects by the same author on their own domains. Built on the same stack, but not part of the primary network.

- [Pirate's Bargain](https://piratesbargain.com): Deal aggregator built on the same Dash stack.
  - Machine-readable: https://piratesbargain.com/llms.txt
- [ai-agent.buzz](https://ai-agent.buzz): Agent tooling directory.
  - Machine-readable: https://ai-agent.buzz/llms.txt
- [2plot.media](https://2plot.media): Media and streaming, on the same Dash stack.
  - Machine-readable: https://2plot.media/llms.txt

## External references

Third-party documentation this project depends on or references. Not affiliated — listed so an agent can follow a dependency directly instead of searching for it.

- [Dash Mantine Components](https://www.dash-mantine-components.com): The UI component layer these docs are built with.
  - Machine-readable: https://www.dash-mantine-components.com/llms.txt
- [Plotly Dash documentation](https://dash.plotly.com): Upstream framework documentation.
  - Machine-readable: https://dash.plotly.com/llms.txt