# BuildCharts

> A framework for defining and generating CI/CD pipelines using declarative metadata.

## Docs

- [Build stages](https://buildcharts.dev/charts/define-build-stages.md): Model build, test, package, and image stages with target definitions.
- [Handle dependencies](https://buildcharts.dev/charts/handle-dependencies.md): Reuse generated stages inside Dockerfiles using Bake target contexts.
- [Exporting build artifacts](https://buildcharts.dev/charts/using-outputs.md): Export build artifacts for local workflows and CI.
- [Command-line interface](https://buildcharts.dev/cli.md): Available BuildCharts CLI commands and how to use them.
- [Comparisons](https://buildcharts.dev/comparisons.md): How BuildCharts compares to related build and CI/CD approaches.
- [Considerations](https://buildcharts.dev/considerations.md): Build-time dependencies and environment considerations.
- [Charts](https://buildcharts.dev/core-features/charts.md): Reusable, versioned pipeline templates distributed as OCI artifacts.
- [Docker builds](https://buildcharts.dev/core-features/docker-builds.md): BuildCharts uses BuildKit to execute generated builds.
- [Generate](https://buildcharts.dev/core-features/generate.md): What buildcharts generate does and the files it produces.
- [Lock files](https://buildcharts.dev/core-features/lock-files.md): Repeatable chart resolution and controlled updates.
- [Metadata](https://buildcharts.dev/core-features/metadata.md): Repository metadata for build generation.
- [Plugins](https://buildcharts.dev/core-features/plugins.md): Built-in plugins that extend generation before and after HCL creation.
- [Scaffolding](https://buildcharts.dev/core-features/scaffolding.md): Get started by automatically creating build metadata.
- [Summary](https://buildcharts.dev/core-features/summary.md): Create build summaries using Docker build history.
- [Examples](https://buildcharts.dev/examples.md): Sample repositories for common BuildCharts targets and plugins.
- [How it works](https://buildcharts.dev/how-it-works.md): Inputs, validation rules, generated files, and Bake outputs in the BuildCharts flow.
- [Getting started](https://buildcharts.dev/index.md): Generate pipelines using declarative metadata and OCI-hosted build charts.
- [Install](https://buildcharts.dev/install.md): Install the BuildCharts CLI and verify that your environment is ready.
- [NuGetAuthenticate@v1](https://buildcharts.dev/plugins/nuget-authenticate.md): Inject Azure Artifacts credentials into generated builds.
- [TestcontainersDinD@v1](https://buildcharts.dev/plugins/testcontainers-dind.md): Provide an isolated Docker daemon for Testcontainers-based builds.
- [.NET](https://buildcharts.dev/quickstart/dotnet.md): Get started with BuildCharts in .NET repositories using the built-in chart set.
- [GitHub Actions](https://buildcharts.dev/quickstart/github-actions.md): Run BuildCharts in GitHub Actions with Buildx Bake.
- [Use buildx history](https://buildcharts.dev/troubleshooting/buildx-history.md): Inspect BuildCharts runs, replay logs, and debug builds with docker buildx history.
- [Common issues](https://buildcharts.dev/troubleshooting/common-issues.md): Diagnose the most common BuildCharts setup, validation, and generation failures.

## OpenAPI Specs

- [openapi](https://buildcharts.dev/api-reference/openapi.json)