Advanced User Guide

The Tutorial covers everything most forms need. The pages here go further, each on its own, so read the ones you need.

Styling

• Material Design 3: the filled variant, the dark scheme and changing the colors.

Validation

• Live Validation (HTMX): check fields on the server while the user types.
• Rule-Based Validation: FormValidator and ready-made rules such as PhoneRule, alongside the model's own validation.

More kinds of forms

• Data Tables (CSV Import): import a CSV into an editable, validated table.
• Forms Built at Runtime: create a form whose fields come from data, with create_model().
• JSON API and JSON Schema: one model for an HTML form and a JSON API, and standard JSON Schema output.

Rendering

• Assets and Self-Contained Forms: where the CSS and JavaScript come from, and forms with no external files.
• Render Timing and Logging: measure rendering and turn on the library's logs.
• Layout Primitives: grids, cards and tabs for HTML you've already rendered.

Extending the library

• Plugin Hooks and Custom Composites: register your own inputs and composite controls.
• AI Assistants and Agent Skills: five agent skills, installed with uvx library-skills, that teach coding assistants to build, create, convert, upgrade and document forms with the installed version.