Migrating KendoReact v11 to v12

This page outlines the available codemods for migrating from KendoReact v11 to KendoReact v12.

Starting with KendoReact 11, some component packages now provide codemods to help you migrate between major versions. Check out Assisted Migration.

Best Practices

For a more manageable migration process, consider the following recommended practices:

• Migrate between consecutive major versions. For example, migrate from v11 to v12. This lets you review and adjust your code version by version, avoiding possible conflicts between breaking changes.
• Migrate one package at a time. This provides finer control over the migration process.

Chat

bash

# Migrate to the latest available package version.
npx @progress/kendo-cli migrate @progress/kendo-react-conversational-ui

# OR migrate from v11 to v12.
npx @progress/kendo-cli migrate @progress/kendo-react-conversational-ui --from=11 --to=12

# If not already installed, you will be prompted to install the Kendo CLI.

All Chat codemods perform the following:

• Find all KendoReact Chat components in your code. The transformations recognize custom import names as well.
• Preserve your existing code.

The following table outlines the specific Chat codemod transformations:

Codemod	Description
New onSendMessage handler	Rename onMessageSend to onSendMessage.
New authorId attribute	Replace user attribute with authorId, including lifting inline objects to variables if necessary.
New messageTemplate attribute	Rename message attribute to messageTemplate.
New ChatSendMessageEvent type	(TypeScript-only) Replace type annotations from the deprecated ChatMessageSendEvent type to the new ChatSendMessageEvent type.
Deprecated toolbar attributes	Removes showToolbar attribute from the Chat. Removes onToolbarActionExecute attribute from the Chat. Removes toolbar attribute from the Chat.

Suggested Links

• Keeping Up to Date
• KendoReact Changelog
• Breaking Changes
• Rendering Changes