Packages
Trellis ships as a multi-package SDK. The core engine renders templates; the rest of the packages add server integrations, static site generation, CSS tooling, hot reload, and a scaffolding CLI. Each package is published independently on pub.dev and you add only the ones you need.
If you have not rendered a template yet, start with
Getting Started and the
Syntax Reference – these package guides assume you know the
tl:* basics and focus on what each package adds.
The core
- trellis – the template engine. Configuration, loaders, fragments, validation, custom processors, and the public API.
Server integrations
Pick the one that matches your HTTP framework. All three expose the same shape: a way to reach the engine, response helpers, HTMX detection, and security headers.
- trellis_shelf – Shelf middleware, HTMX helpers, CSRF, and security defaults.
- trellis_dart_frog – Dart Frog provider middleware, response helpers, and security middleware.
- trellis_relic – Serverpod Relic response helpers, HTMX detection, and security headers.
Sites, CSS, and tooling
- trellis_site – static site generator: Markdown content, layouts, taxonomies, feeds, and navigation.
- trellis_css – Dart-native SASS compilation
and fragment-scoped CSS via
tl:scope. - trellis_dev – SSE-based browser hot reload for template development.
- trellis_cli – the
trelliscommand: project scaffolding, static-site builds, local preview, and theme management.
Authoring a theme for trellis_site? See the
Theme Authoring guide.
-
trellis (core engine)
trellis is the template engine at the heart of the SDK: a natural HTML template engine for Dart. Templates are valid HTML that browsers render as prototypes…
-
trellis_shelf
trellis_shelf wires the Trellis engine into a Shelf server: middleware that injects the engine, response helpers that render pages and fragments, HTMX…
-
trellis_dart_frog
trellis_dart_frog integrates the Trellis engine with Dart Frog: a provider middleware, response helpers, HTMX detection utilities, and security middleware…
-
trellis_relic
trellis_relic integrates the Trellis engine with Serverpod Relic: response helpers, HTMX detection, and security headers.
-
trellis_site
trellis_site turns Markdown content and Trellis HTML layouts into a complete static site. This page is the package reference. For the guided workflow,…
-
trellis_css
trellis_css adds CSS tooling to the Trellis engine: Dart-native SASS compilation and fragment-scoped CSS via the tl:scope processor.
-
trellis_dev
trellis_dev provides live reload for Trellis template development. When a template file changes on disk, all connected browser tabs refresh automatically…
-
trellis_cli
trellis_cli provides the trellis command: project scaffolding, static-site building, local preview, and theme management. It ties the SDK together –…