CLI Compiler

Installation

curl -fsSL https://waltzing.awesomike.com/install | bash --binary compiler

Basic Usage

waltzing -i templates -o out

Multiple Input Directories

You can specify multiple input directories with the -i flag. Each directory can optionally have an alias using the = syntax:

waltzing -i src/templates -i vendor=pkg/templates -o out

With aliasing:

  • -i src/templates - Templates available at root (e.g., @import /layouts/base.wtz)
  • -i vendor=pkg/templates - Templates namespaced under vendor (e.g., @import /vendor/components/button.wtz)

This is useful for separating your own templates from third-party or shared template libraries while avoiding path collisions.

Options

  • -i, --input - Input directory (supports alias=path for namespacing)
  • -o, --output - Output directory
  • --streaming - Generate streaming functions
  • --async - Generate async streaming functions
  • --with-axum - Enable Axum helpers
  • --with-uuid - Enable UUID support
  • --watch - Watch for changes and recompile automatically