Skip to main content
We release CDK Terrain (CDKTN) regularly. The CHANGELOG on Github contains details about bug fixes, new features, and deprecations.

What’s New

  • Function availability validation — the Fn bindings cover Terraform and OpenTofu, and synthesis validates function usage against your project’s declared targetVersions.
  • S3-native state locking — the S3Backend can now lock state with a native lock file via the useLockfile field, removing the need for a separate DynamoDB table.

Feature Flags

Some new behaviors ship behind feature flags to preserve backwards compatibility for existing projects. Projects created with cdktn init get all current flags enabled in the context section of their cdktf.json; existing projects can opt in by adding the entries manually. In the next major release these behaviors become the default.
FlagBehavior when enabled
failOnConstructsOutsideOfStacksSynthesis throws if constructs are scoped directly to the App instead of a TerraformStack.
validateFunctionVersionsFunctions used through Fn are validated at synth time against the project’s declared targetVersions, without executing any binary. Learn more.

Upgrade Guides

CDKTN includes upgrade guides for releases that have breaking changes.