websdk-1022-upgrade

Migrate Cumulocity Web SDK projects from 1021 to 1022 with Angular 19 updates.

5|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Cumulocity-IoT/cumulocity-skills --skill websdk-1022-upgrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: websdk-1022-upgrade
Source: https://github.com/Cumulocity-IoT/cumulocity-skills/tree/main/skills/websdk-1022-upgrade
Command: npx skills add https://github.com/Cumulocity-IoT/cumulocity-skills --skill websdk-1022-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive guide to upgrade your Cumulocity Web SDK projects from version 1021 to 1022, ensuring compatibility with Angular 19 and addressing critical breaking changes.

Core Features & Use Cases

  • Angular 19 Migration: Guides you through the ng update process for Angular 19.
  • Standalone Components: Details the "standalone by default" breaking change and how to manage it.
  • Dependency Updates: Lists required updates for @c8y/* packages, ngx-bootstrap, and @angular/cdk.
  • Bootstrapping Adjustments: Explains changes needed in main.ts and bootstrap.ts.
  • Breaking Changes: Covers dashboard route requirements, login app separation, and removed deprecated modules.
  • Use Case: You need to upgrade a custom Cumulocity application from Web SDK 1021 to 1022 to leverage new features and security updates. This Skill provides the exact steps and code modifications required.

Quick Start

Follow the step-by-step guide to upgrade your Web SDK project from version 1021 to 1022.

Frequently Asked Questions about websdk-1022-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade my Cumulocity Web SDK project from version 1021 to 1022?

Upgrading Cumulocity Web SDK from 1021 to 1022 requires running automated `ng update` for Angular 19, aligning `@c8y/*` and `ngx-bootstrap` dependency versions, and refactoring application bootstrapping in `main.ts` and `bootstrap.ts`.

What breaking changes are introduced in Angular 19 for Cumulocity Web SDK?

Angular 19 breaking changes for Cumulocity Web SDK include standalone components becoming default, requiring explicit `standalone: false` declarations for NgModule components, and the removal of deprecated Angular widget modules.

Why do my dashboard routes fail after upgrading to Web SDK 1022?

Dashboard routes fail after upgrading to Web SDK 1022 due to new route requirements; you must refactor dashboard routes to explicitly include `rootContext: ViewContext.Dashboard` to resolve the breaking change.

Do I need to update ngx-bootstrap and @angular/cdk for Web SDK 1022?

Yes, you must update `ngx-bootstrap` and `@angular/cdk` dependencies during your Web SDK 1022 migration to ensure version compatibility with Angular 19 and the updated `@c8y/*` packages.

How does the login application separation affect Cumulocity Web SDK 1022 migration?

The login application separation in Cumulocity Web SDK 1022 requires adjusting application bootstrapping configuration in `main.ts` and `bootstrap.ts` to accommodate the newly separated login application structure.