Examples

The smallest Package that exercises akua's `helm.template` engine callable end-to-end.

The smallest possible akua Package. One local-path chart dep, an `Input` schema with two fields, raw-manifest output. Teaches the three regions of `package.k` — imports, schema, body — and the...

Two Helm charts composed into one Package. A webapp consumes a Postgres connection URL from a Secret the CloudNativePG operator creates — entirely by convention, no runtime late-binding required,...

The shape most production workspaces actually use — but importantly, **akua does not specify any of it beyond `Package.k`**. This example shows how a team builds their own "App + Environment"...

A workspace policy gate. Shows the policy stack end-to-end:

Shows where tests live and what each kind looks like:

Four source engines composed in one Package, with per-source output routing. Demonstrates:

One akua Package composing another. The reuser pins the base Package by OCI digest in `akua.toml`, imports its `Input` schema into its own schema (as a nested field), and renders the base's...

Package composition via `pkg.render` — an outer Package calls a reusable inner Package twice with different inputs and concatenates the results. Renders end-to-end today (pure KCL; no helm needed).

Smallest Package that exercises akua's `kustomize.build` engine callable end-to-end.

Composes a third-party Akua package (`./upstream/`) and applies a tenant overlay, drops a kind, and appends extras — the install-as-Package shape. Demonstrates the natural call form...

A Package whose dep is materialized into `.akua/vendor//` so render works without re-fetching from the canonical source. This example takes the offline guarantee literally — the canonical...

This example shows package composition across a local path dependency. The root `package.k` imports `pkgs.webserver` and calls `webserver.render(webserver.Input{...})`; the `webserver` sub-package...

This example covers `repo` dependencies: charts published through an `index.yaml` rather than OCI or a local path. `akua add` resolves the repository index, pins the selected chart archive digest in...