Bundle Development

This section covers everything you need to build, test, and publish Massdriver bundles.

What's in this section

• Bundle YAML Specification - Complete reference for the massdriver.yaml file format
• Runtimes and Applications - Publish runtimes that applications run on, with no IaC in the application repo
• Schema Design - JSON Schema patterns and Massdriver annotations for building parameter forms
• Dependencies & Resources - How bundles consume and produce resources for type-safe infrastructure composition
• Provisioners - Configure OpenTofu, Terraform, Helm, and Bicep provisioning steps
• Publishing - Version, template, and publish bundles to the registry

Quick start

1. Create a bundle using the CLI:

   mass bundle new my-bundle

2. Define your schema in massdriver.yaml with parameters, dependencies, and resources

3. Write your IaC in the provisioner directory (e.g., src/ for OpenTofu)

4. Test locally with development releases:

   mass bundle publish --development

5. Publish a stable release when ready:

   mass bundle publish

Learning path

If you're new to bundle development, start with the Getting Started tutorials, then return here for the complete reference documentation.

For conceptual background on why bundles exist and their design principles, see Concepts: Bundles.