Overview
This section provides a complete reference for configuring the AWS CDK Diff GitHub Action, including all available inputs, outputs, permissions, and validation rules.
What's covered
- Inputs — all four input parameters with detailed explanations and examples
- Outputs — both output values for use in subsequent workflow steps
- Validation — how the action validates input parameters
- Permissions — required GitHub Actions permissions
Quick reference
The action accepts four inputs:
- diff-file (required) — path to your CDK diff output file
- token (optional) — GitHub token for posting comments (defaults to
github.token) - header (optional) — custom header for the PR comment (useful for multi-environment setups)
- aws-region (optional) — AWS region to display in the comment
And provides two outputs:
- markdown — raw markdown output of the formatted diff
- empty — boolean indicating whether the diff contains changes
For detailed explanations, code examples, and use cases, see the Inputs & Outputs reference.
Usage patterns
Looking for practical examples? Check out:
- Usage Examples — practical examples for multi-environment setups, reusable workflows, conditional deployment, and more
- Install guide — best practices and troubleshooting