Skip to contentSkip to navigationSkip to topbar
Twilio Docs
Rate this page:
On this page

Update plugins for Flex UI 2.x.x

This page explains how to update your plugins when migrating to Flex UI 2.x.x. For more information about the entire migration process, see Migrate from Flex UI 1.x.x to 2.x.x.

(warning)

Warning

Flex UI 2.x.x works with Flex Plugins CLI 4.1.3 or higher.

Install the latest version of the Flex Plugins CLI.

Your plugins must use the Flex Plugins CLI in order to be served on Flex UI 2.x.x. If you have plugins built on older versions of the Plugin Builder, you need to migrate them to use the Plugins CLI.

Update Flex 1.x.x plugins for Flex 2.x.x

update-flex-1xx-plugins-for-flex-2xx page anchor

Based on the implementation of your plugin, you may need to update your plugin source code and its dependencies to be compatible with Flex UI 2.x.x.

Update your plugin dependencies

update-your-plugin-dependencies page anchor

When you leverage the create command of the Flex Plugins CLI to create a new plugin, you need to update the dependencies on the package.json file of the plugin to make it compatible with 2.x.x.

Note the differences between the dependencies and devDependencies on the following sample package.json files. You need to update the devDependencies in order to run your plugin locally via the twilio flex:plugins:start command of the CLI.

Flex UI 1.x.xFlex UI 2.x.x

_17
{
_17
"name": "plugin-sample",
_17
"version": "0.0.0",
_17
"private": true,
_17
"scripts": {
_17
"postinstall": "flex-plugin pre-script-check"
_17
},
_17
"dependencies": {
_17
"@twilio/flex-plugin-scripts": "5.1.1",
_17
"react": "16.5.2",
_17
"react-dom": "16.5.2",
_17
"react-emotion": "9.2.12"
_17
},
_17
"devDependencies": {
_17
"@twilio/flex-ui": "^1",
_17
"react-test-renderer": "16.5.2"
_17
}

Manage migration of your plugins

manage-migration-of-your-plugins page anchor

Following are some guidelines to help you manage the migration of your plugins:

  1. Once you have updated your plugin code and dependencies to be compatible with 2.x.x, test your plugin locally by using the twilio flex:plugins:start command of the Flex Plugins CLI.
  2. Once you have tested your plugin to ensure that it works as expected, deploy your plugin to your dev or staging environment using the twilio:flex:plugins:deploy command. We recommend following the Semantic Versioning format for managing your plugin version. Since this plugin is compatible with 2.x.x, we recommend registering this plugin version as a new major version. Use the --major argument and write a clear description for the Changelog of this version.
  3. Enable the plugin deployed on your stage/dev account via the Plugins Dashboard or the Plugins CLI .
  4. Follow Steps 1 to 3 for migrating all your plugins to be compatible with Flex UI 2.x.x.
  5. Finally, create a release via the CLI or the Plugins Dashboard that contains all the plugins that you have migrated to 2.x.x. Leverage the description and the name fields to tag the release as being compatible with 2.x.x.
Rate this page: