Skip to content

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 trellis command: 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 –…