# build system

notes on zig's build system, drawn from studying [ghostty](https://github.com/ghostty-org/ghostty) (terminal emulator) and [bun](https://github.com/oven-sh/bun) (javascript runtime). both are large, production zig projects with sophisticated builds.

## notes

- [organization](./organization.md) - structuring build.zig for large projects
- [dependencies](./dependencies.md) - vendored vs system libs, lazy deps, pinning
- [codegen](./codegen.md) - generating zig source at build time
- [cross-compilation](./cross-compilation.md) - targeting multiple platforms