The kiln CLI#

Kiln ships a command-line tool that wraps the common workflows. Because a Kiln site is defined in Swift, kiln drives your project’s own executable (via swift run) rather than reading a config file. Two conventions follow from that:

• your build writes to ./site, and

• your content lives in ./Content.

Stick to those and every command works with no flags. See Installation to get the binary.

kiln new#

Scaffold a new documentation project. Interactive by default — it prompts for the site name, URL, default language, and any additional languages (from Kiln’s built-in locale list):

kiln new my-docs

Every prompt has a matching flag, so it’s fully scriptable too:

kiln new my-docs \
  --name "My Docs" \
  --url https://docs.example.com \
  --default-language en \
  --language de --language fr \
  --non-interactive

--language is repeatable and also accepts comma-separated codes (--language de,fr). Unknown locale codes are rejected with the list of valid ones.

kiln serve#

Build the site and serve it locally, rebuilding automatically when you edit a file:

kiln serve                     # build, serve ./site at http://127.0.0.1:8080, watch for changes
kiln serve --port 3000         # change the port
kiln serve --directory public  # serve a different output directory
kiln serve --no-watch          # build + serve once, no rebuild-on-change
kiln serve --no-build          # serve the existing output without building first

The watcher polls for changes (skipping .build, .git, .swiftpm, and the output directory) and re-runs the build. Reload your browser to see updates.

kiln build#

Build the site by running your project’s executable:

kiln build              # writes the static site (to ./site by convention)
kiln build --release    # build in release configuration

Reference#