Skip to main content
We release CDK Terrain (CDKTN) regularly. This page always reflects the latest release. Each version has its own release notes in the sidebar, and versions with breaking changes have an upgrade guide. The CHANGELOG on GitHub lists every bug fix, feature, and deprecation.

Latest: v0.25 (2026-10-27)

v0.25 is a breaking release. Read the v0.25 release notes for every change, and follow the v0.25 upgrade guide to upgrade from v0.24. Synthesis validates against your declared targets only. Moved blocks, import blocks, terraform_data, and the cloud backend are checked against the targetVersions in cdktf.json, and synthesis no longer runs the Terraform or OpenTofu binary. A project that declares a Terraform floor below a feature’s minimum now fails synthesis. Learn more. Asset staging and bundling. TerraformAsset can exclude files, fold extra inputs into its hash, and run a bundler that builds the source into a directory or a single-file artifact before it’s staged. Learn more. Registry-aware provider resolution. A project that targets only OpenTofu resolves providers, versions, and generated documentation links from the OpenTofu Registry, without fully qualified provider sources. Learn more. Usage metrics with consent. The CLI no longer contacts HashiCorp Checkpoint. It reports aggregated usage metrics to the CDKTN project’s Sentry, behind a new sendUsageTelemetry flag in cdktf.json. Learn more. New TypeScript defaults and a Node.js 22.23.4 minimum. The CLI requires Node.js 22.23.4 or later. A new typescript-pnpm template manages the project with pnpm, the TypeScript template runs on tsx and TypeScript 6, and Yarn is deprecated. Learn more.

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. A later release makes each behavior the default and removes its flag; the upgrade guide for that release tells you what changes. To opt in on an existing project, set the flags to "true" in cdktf.json:

Earlier Releases

  • v0.24: function validation on by default, a Node.js 22.19 minimum, symlink-preserving assets, canonical asset hashes, and ephemeral resources, provider-defined functions, and write-only attributes.
  • v0.23: runtime support drops, mixins, declared targetVersions, function availability validation, and S3-native state locking.
  • v0.22: the first release as CDK Terrain, with packages renamed from cdktf to cdktn.