# Project Descriptor (project.toml)

**Canonical:** https://apis.io/apis/buildpacks-io/project-descriptor-spec/  
**Provider:** buildpacks-io — https://apis.io/providers/buildpacks-io/  
**Documentation:** https://github.com/buildpacks/spec/blob/main/extensions/project-descriptor.md

Project Descriptor (project.toml) is one of 8 APIs that [buildpacks-io](https://apis.io/providers/buildpacks-io/) publishes on the [APIs.io](https://apis.io/) network. This API exposes 1 JSON Schema definition. Tagged areas include Cloud Native Buildpacks, Project Descriptor, and App Surface. The published artifact set on APIs.io includes API documentation and 1 JSON Schema.

The Project Descriptor extension defines project.toml — the optional app-root file letting developers declare their builder image, include/exclude globs, buildpack overrides (pre/group/post), and build-time env vars. Read by `pack build` and other platforms before invoking the lifecycle.

## Machine-readable artifacts (2)

- **Documentation** — https://github.com/buildpacks/spec/blob/main/extensions/project-descriptor.md
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/buildpacks-io/refs/heads/main/json-schema/buildpacks-project-toml-schema.json

## Other buildpacks-io APIs (7)

- [Buildpack Specification](https://apis.io/apis/buildpacks-io/buildpack-spec/)
- [Platform Specification](https://apis.io/apis/buildpacks-io/platform-spec/)
- [Distribution Specification](https://apis.io/apis/buildpacks-io/distribution-spec/)
- [Image Extension Specification](https://apis.io/apis/buildpacks-io/image-extension-spec/)
- [Service Bindings Extension](https://apis.io/apis/buildpacks-io/service-bindings-spec/)
- [buildpacks-io Buildpacks API](https://apis.io/apis/buildpacks-io/buildpacks-io-buildpacks-api/)
- [buildpacks-io Search API](https://apis.io/apis/buildpacks-io/buildpacks-io-search-api/)

## Tags

Cloud Native Buildpacks, Project Descriptor, App Surface

---

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