trunco 1.0.0

An agile, powerful Python framework for creating dynamic UIs with seamless web integration.

Trunco

Trunco is a Python framework for building dynamic, reusable HTML components. It integrates with Django, Flask, FastAPI, and other web frameworks, with optional DaisyUI and 0build (formerly Franken UI) kits.

Features

• Component-based architecture — composable Python objects render to HTML
• Optional integrations — Alpine.js, HTMX, UIKit helpers built in
• UI kits — trunco.daisy and trunco.zbuild with unified short imports (Form, Button, Alert, …)
• Custom themes — register your own color schemes like DaisyUI/Tailwind
• Zero runtime dependencies — core install is dependency-free

Installation

uv pip install trunco

Quickstart

from trunco.daisy import Form, FormControl, Input, Button, Alert, Page

form = Form(action="/save")
form.add_child(FormControl(label="Email", field=Input(placeholder="[e-mail]")))
form.add_child(Button(label="Save", color="primary"))
form.add_child(Alert(message="Ready", color="info"))

print(Page(form, theme_name="light").render())

Swap kits by changing one import:

import trunco.daisy as ui   # or: import trunco.zbuild as ui

Documentation

The docs site is built with Trunco and deployed to GitHub Pages.

uv pip install -e .
uv run python docs/serve.py   # preview at http://127.0.0.1:8000
uv run python docs/build.py   # build only → docs/_site/

Resource	Location
Live docs	GitHub Pages (after deploy)
Site source	docs/src/
Build script	docs/build.py
Legacy markdown	docs/archive/

Examples

Runnable examples in examples/:

uv run python examples/01_core_basics.py
uv run python examples/04_daisy_kit.py
uv run python examples/07_kit_swap.py

Development

uv sync
uv pip install -e .
uv run pytest
uv run python docs/build.py

License

MIT — see LICENSE.