spaday-webawesome 0.5.0

Typed WebAwesome components and self-contained browser assets for spaday

Documentation

• Build an interactive WebAwesome page — guided first page.
• Generate a bound form — task-focused model form guide.
• API reference — catalog, helpers, and assets.
• Why WebAwesome is a peer package — ownership and loading model.

Quick example

from spaday import serve
from spaday_webawesome import WaButton, WaCard

page = WaCard(WaButton().text("Run"))
serve(page, packages=["webawesome"])

The package also exports Tabs, plus form() and FormField for generating bound WebAwesome controls from pydantic models or JSON Schema.

Installing the package does not inject assets. Select it explicitly with packages=["webawesome"] or pass the exported package descriptor.

Generic controls

All 13 generic controls in spaday.ui render as Web Awesome elements when a page selects this package. The mapping is exported as DESIGN; for_design("webawesome", pill=True) sets a Web Awesome prop on one control. The shared conformance page checks value updates, options, validation state, and dialog behavior in a browser. Web Awesome progress bars use percentages, so their generic value is normalized against the generic max.

Browser examples

• Open the standard app (source).
• Open the complete component gallery (source).

Both run Python locally through Pyodide; no install or server is required.

Run examples locally

python -m pip install -e ".[examples]"
python -m spaday_webawesome.example
python -m spaday_webawesome.gallery

Open http://127.0.0.1:8012 for the standard operations-console app or http://127.0.0.1:8013 for the component gallery. The standard app includes server-updated metrics and an order preview that round-trips to Python. The gallery includes every generated Web Awesome component and a highlighted Python snippet for each component family.

Both pass the local package descriptor directly, so they do not install or resolve the integration from GitHub.