websdk-1021-upgrade

Upgrade Cumulocity Web SDK projects from 1020 to 1021 with Angular 18.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a clear, step-by-step process to upgrade your Cumulocity Web SDK projects from version 1020 to 1021, ensuring compatibility with Angular 18 and resolving common migration issues.

Core Features & Use Cases

  • Dependency Management: Guides you through updating @c8y/* packages to the correct versions.
  • Angular & Library Updates: Facilitates the ng update process for Angular 18 and updates for ngx-bootstrap and @angular/cdk.
  • Configuration Migration: Details the removal of brandingEntry and the migration to angular.json for global styles.
  • Use Case: You need to upgrade an existing Cumulocity application from Web SDK 1020 to 1021 to leverage new features and maintain security. This skill walks you through every necessary code and configuration change.

Quick Start

Follow the steps in this skill to upgrade your project from Web SDK 1020 to 1021.

Frequently Asked Questions about websdk-1021-upgrade

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

FAQPage Schema
How do I upgrade Cumulocity Web SDK from 1020 to 1021?

Upgrading Cumulocity Web SDK from 1020 to 1021 involves updating `@c8y/*` dependencies, running Angular update schematics for Angular 18, and migrating global styles from `brandingEntry` to `angular.json`.

What Node.js and TypeScript versions are required for Angular 18 migration?

Angular 18 migration requires ensuring Node.js, TypeScript, and RxJS compatibility. You must verify your environment meets the version requirements before running the Angular update schematics.

Does upgrading to Web SDK 1021 require migrating the brandingEntry configuration?

Yes, upgrading to Web SDK 1021 requires migrating the `brandingEntry` configuration. You must remove `brandingEntry` and migrate your global styles configuration to `angular.json`.

How do I update ngx-bootstrap and @angular/cdk for Cumulocity Web SDK 1021?

To update `ngx-bootstrap` and `@angular/cdk` for Web SDK 1021, run the `ng update` process. This facilitates upgrading to Angular 18 and ensures library compatibility with the new SDK version.

Why does my Cumulocity Web SDK build fail after upgrading to Angular 18?

A Cumulocity Web SDK build may fail after upgrading to Angular 18 due to incompatible `@c8y` dependencies, outdated `ngx-bootstrap` or `@angular/cdk` versions, or an unmigrated `brandingEntry` configuration.