spaday 0.13.0

Reactive web-component UIs configured in Python, executed in the browser.

Browse the standalone examples or open the interactive notebook. Python runs in Pyodide, so nothing needs to be installed locally.

Overview

Construct a UI as a tree of typed Python components from opt-in packages or any library that ships a Custom Elements Manifest. Attach behavior as declarative data: an action DSL (toggle a prop, send a model edit, call an endpoint) and reactive bindings (a control two-way-bound to a state field, or a prop computed from others). spaday's JavaScript runtime renders the tree to real web components and interprets that behavior client-side — so a toggle or a derived value updates with no round-trip to Python.

That UI state is a transports model, so it syncs over any connection (WebSocket, SSE, Jupyter comm) and any codec; the same tree drops into a web app or a Jupyter notebook unchanged.

Like transports, spaday is a Rust core with thin bindings: the component tree, the diff engine, the CEM parser, the action interpreter, and the reactive engine live in Rust and compile to PyO3 (Python authors the tree) and wasm (the browser runs it). One core, two bindings.

from spaday import Widget, element

# a checkbox two-way-bound to a state field, rendered in a Jupyter cell
ui = element("input", type="checkbox").bind("checked", "on", mode="two-way")
w = Widget(ui, state={"on": True})
w  # flip the switch → w.state["on"] flips in Python; set w.state → the switch follows

Install

pip install spaday            # core: author + serialize component trees
pip install "spaday[widget]"  # + the Jupyter / anywidget host

Component ecosystem

Install only the integrations an application uses. Each package provides typed Python components and registers its browser assets with spaday:

Design Systems

• spaday-blueprint — BlueprintUI.
• spaday-calcite — Calcite Design System.
• spaday-fluent — Fluent UI.
• spaday-lion — Lion.
• spaday-spectrum — Adobe Spectrum Web Components.
• spaday-ui5 — UI5.
• spaday-vaadin — vaadin.
• spaday-webawesome — WebAwesome.

Individual Components

• spaday-codemirror — CodeMirror 6 code editor.
• spaday-dagre — interactive directed-graph rendering with dagre layout.
• spaday-diffs — read-only file comparisons and patches with line selection and annotations from Pierre Diffs.
• spaday-lightweight-charts — reactive TradingView Lightweight Charts.
• spaday-perspective — live Perspective workspaces and datagrids.
• spaday-regular-layout — serializable resizable panel layouts.
• spaday-regular-table — viewport-virtualized high-performance data tables.
• spaday-studio — AI-native visual development environment.
• spaday-trees — virtualized project and repository trees from Pierre.
• spaday-vega — Vega and Vega-Lite visualizations.

The spaday-shoelace compatibility package installs spaday-webawesome.

Select an installed integration by its entry-point name, for example serve(page, packages=["trees"]).

Documentation

• Tutorial — build your first interactive UI, step by step (in a notebook).
• How-to guides — author a component tree, add behavior and reactivity, serve and embed an app, theme it and ship your own variant, use it in a notebook, run Python UI logic in Pyodide, sync to a server over transports, wrap an imperative JS library, generate typed classes from a manifest.
• API reference — the Python surface.
• How spaday works — the architecture and the reasoning behind it.
• How spaday compares to alternatives — Streamlit, Dash, Panel, a JS frontend, and when to pick which.