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 withcdktn 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
cdktftocdktn.