Home/Production/Angular Compatibility

Angular Compatibility

GridCraft supports Angular 19, 20, 21 and 22. Every version in that range is built before every release — twice per major. Nothing outside it is claimed.

Current release: 1.0.0. @gridcraft/angular is MIT-licensed.

The matrix

Two Angular versions per major — the exact lower bound the range promises, and the newest patch a fresh install gets today. Eight builds, all of them green before a version is published:

Angular@gridcraft/angular
19.0.0 (range floor)✔
latest 19.x✔
20.0.0 (range floor)✔
latest 20.x✔
21.0.0 (range floor)✔
latest 21.x✔
22.0.0 (range floor)✔
latest 22.x✔

Each cell installs the published tarball into a throwaway Angular application and runs a production build with strictTemplates on — the same thing your CI does, on the same bytes you download. Every build runs as its own job, so one red cell cannot hide another.

Why 19 is the floor

A concrete reason, not a policy preference:

  • The grid's templates use @let, which requires Angular 18.1. That rules out 17 and 18.0 outright.

Beyond that, 19 is the lowest version we build, so it is the lowest version we claim.

The upper bound is deliberate

The range ends at <23.0.0. When Angular 23 is released, installing GridCraft alongside it will fail rather than appear to work — until we have built against it and shipped a release that widens the range. That is a feature: an install error the day Angular 23 lands is better than a template compile error three weeks later.

// package.json — the range npm checks at install
"peerDependencies": {
  "@angular/common": ">=19.0.0 <23.0.0",
  "@angular/core":   ">=19.0.0 <23.0.0"
}

What happens if you go outside the range

npm stops you. That matters more than it sounds, because nothing inside the published artifact enforces the range. Angular libraries ship in a partially-compiled form and your own compiler finishes the job — and the version metadata in that format does not track template syntax. A too-old Angular therefore does not produce a polite "unsupported version" message. It produces a parse error pointing into a minified file inside node_modules:

X [ERROR] "as" expression is only allowed on the primary @if block
    node_modules/@gridcraft/…/fesm2022/….mjs@0:170457

That exact error is real — it is what an Angular 19 build produced before the version matrix existed and found it. The peer range is the only thing standing between a user and that message, which is why it is verified rather than asserted.

npm install @gridcraft/angular

# npm refuses the install if your Angular is outside the range — that refusal
# is the guard. It is not advisory.

TypeScript and Node

Neither is pinned. TypeScript is resolved by your Angular version — whatever @angular/compiler-cli accepts, the grid accepts, and the matrix above installs it the same way your project does, deliberately: pinning a TypeScript would test a combination no consumer has. Node matters only to your build; the grid ships no server-side runtime.

Zoneless and SSR

The grid is signals-based throughout and runs zoneless. It also runs with zone.js — the trial applications in the matrix use it, so both configurations are built on every version in the table. Server-side rendering is supported.

When the table changes

Adding a major to the range is a release, not an edit. The version is added to the matrix first, whatever breaks is fixed, and only then does the published range widen — never the other way round. If this page and your node_modules ever disagree, the peerDependencies in the package are the authority.