# `mix tinfoil.build`
[🔗](https://github.com/joshrotenberg/tinfoil/blob/v0.2.22/lib/mix/tasks/tinfoil.build.ex#L1)

Build a single tinfoil target end-to-end.

Runs `mix release` with the appropriate `BURRITO_TARGET` for the
requested target, then tars and checksums the output. Designed to
be called once per CI matrix entry — the generated workflow invokes
it that way.

## Examples

    mix tinfoil.build --target darwin_arm64
    MIX_ENV=prod mix tinfoil.build --target linux_x86_64

## Flags

  * `--target`       — required, the tinfoil target atom to build
  * `--skip-release` — skip `mix release` and package an existing
                       `burrito_out/<app>_<burrito_name>` binary
  * `--output-dir`   — directory for the archive (default `_tinfoil`)
  * `--tag`          — the release tag to check mix.exs against, e.g.
                       `v1.2.3`. Defaults to `GITHUB_REF_NAME`. Needed
                       under `trigger: :workflow_call`, where that env
                       var holds the calling workflow's branch.
  * `--skip-version-check` — skip the git tag vs mix.exs version check

---

*Consult [api-reference.md](api-reference.md) for complete listing*
