Buf example projects

This repo houses example projects for learning how to use Buf. For more information, we recommend checking out the official docs.

Version

The examples in this repo use v2 buf.yaml and v2 buf.gen.yaml configurations. All examples require the buf CLI at version v1.32.0 or higher.

Projects

Project	Directory	Category
Buf workspace	workspace	Code organization
Linting Protobuf sources	linting	Maintenance
Breaking change detection	breaking-change-detection	Maintenance
Remote plugin execution	plugin-execution-remote	Code generation
Local plugin execution	plugin-execution-local	Code generation
Generating code stubs using managed mode	managed-mode	Code generation
Limit output types for buf build	limit-output-types	CLI
Buf on GitHub Actions	github-actions	CI/CD

Several of these projects available as modules on the Buf Schema Registry under the buf-examples organization.