
Scaffold a new Cumulocity application using the @c8y/websdk Angular schematic without human interaction. Covers Angular CLI installation, app generation, schematic setup, AI tools configuration, dev server, and build commands. Triggers: new app, scaffold, create application, ng add websdk, setup cumulocity app, new cumulocity project.
Complete guide to internationalizing a Cumulocity Web SDK application. Covers all approaches to annotating and translating text (gettext, translate pipe, translate directive, TranslateService), extracting strings, creating and updating .po files, overriding existing translations, and adding brand-new languages. Triggers: i18n, internationalization, add language, translate, translation, localization, l10n, new language, po file, gettext, TranslateService, language switcher.
Analyze Angular / Cumulocity Web SDK code for anti-patterns, bugs, and quality issues. Use when reviewing components, services, or modules for code quality, maintainability, performance, and correctness. Covers TypeScript best practices, Angular idioms, C8Y SDK usage patterns, and project-specific conventions. Triggers: code review, anti-pattern, quality check, refactor suggestion, style guide, bug analysis.
Step-by-step guide to migrate a Cumulocity Web SDK application to a target version. Detects breaking changes with the ui-breaking-changes-cli, scaffolds a reference app at the target version with the new-app skill, compares key configuration files (app.ts, bootstrap.ts, angular.json, etc.), and finishes with a code-quality-analysis review. Triggers: migrate app, upgrade version, breaking changes, sdk upgrade, migrate cumulocity, upgrade websdk.
Step-by-step guide for migrating a Cumulocity Web SDK project from 1019 to 1020 (Angular 17). Covers @c8y dependency updates, zone.js import fix, angular.json buildTarget rename, Angular 17 ng update, ngx-bootstrap and CDK upgrades, loginOptions removal from main.ts, and adding the @c8y/options devDependency.
Step-by-step guide for migrating a Cumulocity Web SDK project from 1020 to 1021 (Angular 18). Covers @c8y dependency updates, Angular 18 ng update, ngx-bootstrap and CDK upgrades, and the removal of brandingEntry in favour of angular.json styles arrays.
Step-by-step guide for migrating a Cumulocity Web SDK project from 1021 to 1022 (Angular 19). Covers Angular 19 ng update, standalone-by-default breaking change, @c8y dependency updates, ngx-bootstrap and CDK upgrades, main.ts/bootstrap.ts adjustments, dashboard route rootContext requirement, login app separation, and removed deprecated Angular widget modules.
Step-by-step guide for migrating a Cumulocity Web SDK project from 1022 to 1023 (Angular 20). Covers Angular 20 ng update, @c8y dependency updates, ngx-bootstrap and CDK upgrades, TypeScript 5.9.3 requirement, and breaking changes including global time context API redesign, scoped TranslateService per plugin, QueriesUtil type additions, and removal of BulkSingleOperationsListModule.
Curated list of breaking changes, removals, and migration-critical announcements in the Cumulocity Web SDK, scraped from the official changelogs at https://cumulocity.com/docs/{year}/change-logs/ and mapped to LTS SDK versions from the websdk-version-map skill. Use this before upgrading to understand what will break and what action is required. Source URLs are provided per entry for traceability.
# Skill: REST API Breaking Changes (API CHANGE log) ## Overview Source: https://cumulocity.com/docs/change-logs/?component=.component-rest-api Only entries tagged **API CHANGE** are listed — these are breaking or behaviour-altering changes. Entries are newest-first. --- ### `history` field removed from the Alarm API **Date:** December 4, 2025 The deprecated `history` field has been permanently removed from the Alarm API. It previously always returned an empty list and is no longer inclu
Reference table mapping Cumulocity Web SDK release years to LTS aliases, primary minor versions, and support status. Use this to quickly look up which SDK version corresponds to a given year or LTS alias, and to determine which upgrade skill to apply.
Step-by-step guide for migrating a Cumulocity Web SDK project from 1018 to 1019 (Angular 16). Covers the mandatory switch from c8ycli to ng-cli, project scaffolding, source file migration, package.json alignment, cumulocity.config.ts setup, tsconfig review, and common pitfalls.
Recommends and support the best approach for migrating PKI certificates when moving from another platform or PKI to Cumulocity. Use when a developer or architect asks about how to migrate existing PKI certificates to Cumulocity, how to handle certificate rotation during migration, or best practices for PKI management in Cumulocity.
# Skill: @c8y/client API Usage ## Overview `@c8y/client` is the TypeScript SDK that wraps the **Cumulocity IoT REST API** (https://cumulocity.com/api/core/2025/). Every service class in the library corresponds to one API domain (inventory, alarms, events, measurements, …). The library handles authentication, base URL resolution, response parsing, and pagination — you never construct raw HTTP calls yourself. The declaration files are at: ``` node_modules/@c8y/client/lib/src/ alarm/ event/
Recommends the best Cumulocity microservice chassis / framework for a given project. Use when a developer or architect asks which microservice chassis to use, which framework to pick for a Cumulocity microservice, how to choose between NestJS, Nitro, Spring Boot, .NET, or Python for a microservice, or needs a chassis decision for TypeScript, JavaScript, Java, C#, or Python on Cumulocity.
# Skill: @c8y/client Migration Analysis Methodology ## Purpose This skill describes the **correct, step-by-step process** for auditing a Cumulocity Angular codebase when preparing a Web SDK version upgrade. Following this order avoids incorrect assumptions, wasted searches, and inaccurate effort estimates. --- ## Step 1 — Read the Breaking Changelogs First **Always start here before touching any source code.** Read both skill files in full before analyzing the codebase: 1. `skills/c8y-cli
Guides developers to scaffold new projects e.g. to develop plugins, and implement clean, consistent HTML layouts aligned with the Cumulocity Codex design system foundations.
Step-by-step guide for upgrading a Cumulocity Web SDK project from a version below 1018 to 1018 (Angular 15). Covers dependency updates, TypeScript version, Node version requirements, and the migration from deprecated HOOK token providers to function hooks.