websdk-1023-upgrade

Upgrade Cumulocity Web SDK projects from 1022 to 1023 with Angular 20 migration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the complex process of upgrading a Cumulocity Web SDK project to version 1023, which includes a major jump to Angular 20, ensuring compatibility and leveraging new features.

Core Features & Use Cases

  • Automated Dependency Updates: Guides through updating Angular core, CLI, and Cumulocity-specific packages.
  • Compatibility Checks: Highlights necessary updates for TypeScript, ngx-bootstrap, and Angular CDK.
  • Breaking Change Mitigation: Details critical API changes in global time context, TranslateService scoping, QueriesUtil typing, and module removals, providing actionable steps.
  • Use Case: A developer needs to upgrade an existing Cumulocity application from Web SDK 1022 to 1023. This Skill provides a clear, step-by-step checklist, including commands to run and specific code changes to anticipate, minimizing manual effort and potential errors.

Quick Start

Run the websdk-1023-upgrade skill to update your project from Web SDK 1022 to 1023.

Frequently Asked Questions about websdk-1023-upgrade

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

FAQPage Schema
How do I upgrade my Cumulocity Web SDK project to version 1023?

To upgrade your Cumulocity Web SDK project to 1023, update Angular core, CLI, Cumulocity dependencies, TypeScript, ngx-bootstrap, and Angular CDK. You must also resolve breaking changes in the global time context API, TranslateService, QueriesUtil, and BulkSingleOperationsListModule.

What are the breaking changes when migrating to Angular 20 with Web SDK 1023?

Angular 20 migration in Web SDK 1023 introduces breaking changes to the global time context API, TranslateService scoping, QueriesUtil typing, and removes BulkSingleOperationsListModule. You must adjust your application code to maintain compatibility.

Do I need to update TypeScript and ngx-bootstrap for the Web SDK 1023 upgrade?

Yes, upgrading to Web SDK 1023 requires updating TypeScript and ngx-bootstrap to ensure compatibility with Angular 20. The upgrade process includes checking and aligning these dependencies alongside Angular CDK to prevent runtime conflicts.

What is the best way to handle BulkSingleOperationsListModule removal in Web SDK 1023?

The best way to handle the BulkSingleOperationsListModule removal in Web SDK 1023 is to identify its usages in your application and replace them with the alternative components or APIs provided in the new Angular 20 migration guide.

Why does the TranslateService scoping change during a Cumulocity Angular 20 migration?

The TranslateService scoping changes during a Cumulocity Angular 20 migration to standardize translation context handling across the Web SDK. This breaking change requires developers to update how translation modules are imported and configured in their applications.

Can I use my existing Angular CDK version with Cumulocity Web SDK 1023?

No, Cumulocity Web SDK 1023 requires an Angular CDK update to match the Angular 20 core framework. The upgrade process includes specific compatibility checks to ensure your Angular CDK version aligns with the new Cumulocity dependencies.