# Summary

[Introduction](./introduction.md)

# Getting Started

- [Installation](./getting-started/installation.md)
- [Your First Image](./getting-started/first-image.md)
- [Build Modes](./getting-started/build-modes.md)

# The KDL Spec Language

- [Spec Overview](./spec/overview.md)
- [Metadata & Distro](./spec/metadata.md)
- [Repositories & Publishers](./spec/repositories.md)
- [Packages](./spec/packages.md)
- [Overlays](./spec/overlays.md)
- [Customizations](./spec/customizations.md)
- [Targets](./spec/targets.md)
- [Builder Configuration](./spec/builder.md)

# Composability

- [Base Specs (Build Caching)](./composability/base.md)
- [Includes (Shared Steps)](./composability/includes.md)
- [Profiles (Conditional Variants)](./composability/profiles.md)
- [Multi-Stage Pipelines](./composability/pipelines.md)

# Distro Guide

- [illumos Overview](./distros/illumos-overview.md)
- [OmniOS](./distros/omnios.md)
- [Ubuntu](./distros/ubuntu.md)
- [Adding a New Distro](./distros/adding-distro.md)

# Output Formats

- [QCOW2 VM Images](./formats/qcow2.md)
- [OCI Container Images](./formats/oci.md)
- [Tar Artifacts](./formats/artifact.md)
- [OCI Registry Push](./formats/registry.md)

# Architecture

- [Design Overview](./architecture/overview.md)
- [Two-Phase Build Pipeline](./architecture/pipeline.md)
- [Crate Structure](./architecture/crates.md)
- [Remote Builder VMs](./architecture/builder-vm.md)

# Migration

- [From omnios-image-builder](./migration/from-image-builder.md)
- [From Packer (oi-packer)](./migration/from-packer.md)

# Reference

- [CLI Reference](./reference/cli.md)
- [KDL Spec Reference](./reference/spec-reference.md)
- [Example Specs](./reference/examples.md)
