Guide
Start with Getting started, then read the topics you need. The API reference covers every type in detail.
Getting started
Install stucco, render your first page, and serve it with Axum.
Components
Every stucco component is a Rust value that renders semantic HTML. Builders set options, Render produces markup, and the page collects the CSS each component needs.
Forms
Build forms from labelled fields, read a submission, validate it, and show it again with every value kept and every error explained.
Collections
Turn a list of records into a searchable, filterable, sortable, paginated table that works through ordinary GET requests.
Theming
Start from a preset, build your own theme, or derive one from a seed. Every theme is checked for WCAG contrast before it builds, and components only use semantic tokens, so any theme works with every component.
Command line
The stucco command starts new apps, and generates themes in a terminal or a build script using the same engine as your app and the playground.
Progressive enhancement
Pages work as plain HTML first. When you want a faster interaction, answer the same request with a fragment and let a small script swap it in.
Recipes
Short answers to "how do I…?". Each one is a complete handler or a few lines you can drop into an app built with the [getting started](getting-started.html) setup.
The Atelier workspace
Atelier pairs a warm plaster canvas and terracotta accents with serif display headings and system sans serif text. Fine rules separate groups; tables and forms stay quiet. The [orders showcase](../gallery/showcase.html) renders the same composition as the landing preview, in both schemes.
Signature directions and complete screens
Atelier, Precision, Prism, Play, Grove, Relay and Marquee coordinate typography, density, surfaces and motion. They are additional recipes; existing presets and Theme::seeded keep their original mappings.