# Nixpacks Build Plan

**Canonical:** https://apis.io/apis/nixpacks/build-plan/  
**Provider:** Nixpacks — https://apis.io/providers/nixpacks/  
**Documentation:** https://nixpacks.com/docs/how-it-works

Nixpacks Build Plan is one of 5 APIs that [Nixpacks](https://apis.io/providers/nixpacks/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include Build Plan, JSON, Phases, and Reproducible Builds. The published artifact set on APIs.io includes API documentation and an API reference.

The Nixpacks build plan is the JSON representation of how a source directory will be turned into a container image. A plan declares the list of providers used, top-level `variables`, `staticAssets`, `buildImage`, and an ordered set of phases (`setup`, `install`, `build`, plus any provider- or user-defined phases) along with a `start` phase. Each phase carries `cmds`, `nixPkgs`, `nixLibs`, `nixOverlays`, `nixpkgsArchive`, `aptPkgs`, `dependsOn`, `cacheDirectories`, `onlyIncludeFiles`, and `paths`. Plans can be saved and replayed via `nixpacks build --plan plan.json` to guarantee reproducible image builds.

## Machine-readable artifacts (2)

- **Documentation** — https://nixpacks.com/docs/how-it-works
- **Reference** — https://nixpacks.com/docs/configuration/file

## Other Nixpacks APIs (4)

- [Nixpacks CLI](https://apis.io/apis/nixpacks/cli/)
- [Nixpacks Configuration File (nixpacks.toml)](https://apis.io/apis/nixpacks/configuration-file/)
- [Nixpacks Language Providers](https://apis.io/apis/nixpacks/providers/)
- [Nixpacks GitHub Action](https://apis.io/apis/nixpacks/github-action/)

## Tags

Build Plan, JSON, Phases, Reproducible Builds

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/nixpacks/build-plan/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/nixpacks/.