Migration guides

New versions include improvements but also breaking changes; they need to be applied step by step.


Up to 18.5.3 — safe baseline with theming and icon updates 18.6 — token update 18.22 — component attribute changes After — final upgrade to the latest version (with updated theming)


npm install @koobiq/cdk@18.5.3
npm install @koobiq/components@18.5.3
npm install @koobiq/icons@^9.0.0
npm install @koobiq/design-tokens@~3.7.3
npm install @koobiq/angular-luxon-adapter@18.5.3
npm install @koobiq/date-adapter^3.1.3
npm install @koobiq/date-formatter^3.1.3
npm install luxon
npm install @messageformat/core

The theming is now simpler and based on CSS variables. More details at this link.

See examples in the repository:

  • Install the new icon version:
npm install @koobiq/icons@9.1.0
  • To update icon names in templates, use the update tool (schematic):
ng g @koobiq/angular-components:new-icons-pack --project <your project>

  • Deprecated color tokens have been removed, and typography token names have been renamed.

The script will rename class and CSS variable names to the new ones and highlight places where outdated colors need to be removed or replaced:

ng g @koobiq/angular-components:css-selectors --fix=true --project <your project>
  • For manual control, add --fix=false. The script will highlight where to remove or replace colors and typography names:
ng g @koobiq/angular-components:css-selectors --fix=false --project <your project>

  • Component attribute names have changed:
    • KbqLoaderOverlay: compactsize
    • KbqEmptyState: bigsize
ng g @koobiq/angular-components:loader-overlay-size-attr --project <your project>
ng g @koobiq/angular-components:empty-state-size-attr --project <your project>
Docs Feedback
If you have any questions or would like to contribute to writing the documentation, please create an issue in our GitHub repository.