NG-ZORRO Developer Guidelines

Pairs with angular-developer , that skill provides Angular fundamentals (signals, DI, routing, forms, SSR, accessibility). This skill focuses on NG-ZORRO specifics. Install both for the best experience.

Compatibility

• Tracks: ng-zorro-antd@22.0.0, aligned with Angular ^22.0.0. NG-ZORRO follows Angular's major version, the major number of ng-zorro-antd always matches @angular/core.
• v21 → v22 (real breaking changes): v22 removes long-deprecated inputs and changes date-component setup. The headline items: date-related components no longer ship a default date adapter (call provideNzDateFnsAdapter() explicitly, and date-fns is now v4); all components moved to OnPush; and a batch of deprecated APIs were removed (nz-button nzSearch, nz-cascader nzDisplayWith, nz-input nzAutosize + nz-input-group slots + nzStepperless, nz-modal nzOnOk/nzOnCancel input usage, nz-upload nzTransformFile, nz-tooltip cdkConnectedOverlayPush, plus dropdown/collapse/message/transfer removals). See migration.md.
• Works for: NG-ZORRO v17 → v22 projects. The skill assumes the v21/v22 API surface, the migration.md reference covers the module → standalone shift, the i18n provider change, the v22 removals, and the per-version deprecations.
• Angular: v17 or newer (standalone components and the new control flow); v22 for ng-zorro-antd@22. v22 is the closest match.
• Zoneless / OnPush: NG-ZORRO officially supports zoneless change detection and ChangeDetectionStrategy.OnPush, the components are signal-aware and use markForCheck() internally where needed.
• SSR: First-class. Works under Angular Universal / @angular/ssr.
• Internationalisation: provideNzI18n(en_US) at the root, swap locales at runtime via NzI18nService.
• Not supported: NG-ZORRO v16 and below (Angular v16 and below, NgModule-only patterns, no signals support).

If the project's ng-zorro-antd major doesn't match @angular/core, the install will fail npm peer checks. Tell the user to upgrade Angular first, then NG-ZORRO, in lockstep, see migration.md.

1. Check the project's NG-ZORRO version before answering. Major versions track Angular and pick up real changes, the i18n provider became provideNzI18n in v17, full standalone-class exports landed in v18, dynamic theme is still experimental in v21. package.json is the source of truth.