@twilio-labs/plugin-flex

@twilio-labs/plugin-flex

Twilio CLI plugin to interact with the Flex Plugin Builder

This plugin adds functionality to the Twilio CLI to locally develop, build and deploy Twilio Flex plugins; it uses the Flex Plugin Builder.

• Requirements
• Usage
• Commands

Requirements

Install the Twilio CLI

Via npm or yarn:

$ npm install -g twilio-cli
$ yarn global add twilio-cli

Via homebrew:

$ brew tap twilio/brew && brew install twilio

Usage

$ twilio plugins:install @twilio-labs/plugin-flex

$ twilio --help flex

USAGE
  $ twilio flex
...

Commands

• twilio flex:plugins:build
• twilio flex:plugins:create NAME
• twilio flex:plugins:create-configuration
• twilio flex:plugins:deploy
• twilio flex:plugins:describe:configuration
• twilio flex:plugins:describe:plugin
• twilio flex:plugins:describe:plugin-version
• twilio flex:plugins:describe:release
• twilio flex:plugins:diff ID1 [ID2]
• twilio flex:plugins:list:configurations
• twilio flex:plugins:list:plugin-versions
• twilio flex:plugins:list:plugins
• twilio flex:plugins:list:releases
• twilio flex:plugins:release
• twilio flex:plugins:remove
• twilio flex:plugins:start

twilio flex:plugins:build

Builds Flex plugin and creates a JavaScript and sourcemap bundle. This command needs to be invoked inside a plugin directory.

USAGE
  $ twilio flex:plugins:build

OPTIONS
  --json

See code: src/commands/flex/plugins/build.ts

twilio flex:plugins:create NAME

Creates a new Twilio Flex Plugin project

USAGE
  $ twilio flex:plugins:create NAME

ARGUMENTS
  NAME  Creates a new Twilio Flex Plugin project

        Arguments:
        name	Name of your plugin. Needs to start with plugin-

OPTIONS
  -a, --accountSid=accountSid  The Account SID for your Flex Project
  -h, --help=help
  -i, --install                Auto-install dependencies
  -r, --runtimeUrl             Auto-install dependencies
  -s, --typescript             Create a TypeScript project
  -t, --template=template      A URL to a template directory
  -v, --version=version
  -y, --yarn                   Use yarn as your dependency manager

DESCRIPTION
  Arguments:
  name	Name of your plugin. Needs to start with plugin-. This command needs to be invoked inside a plugin directory.

See code: src/commands/flex/plugins/create.ts

twilio flex:plugins:create-configuration

Creates a Flex Plugin Configuration. This command needs to be invoked inside a plugin directory.

USAGE
  $ twilio flex:plugins:create-configuration

OPTIONS
  --description=description  The configuration description
  --json
  --name=name                [default: Aug 14, 2020]
  --new

  --plugin=plugin            (required) The plugin to install, formatted as pluginName@version. Use additional --plugin
                             to provide other plugins to install

See code: src/commands/flex/plugins/create-configuration.ts

twilio flex:plugins:deploy

Builds and deploys Flex plugin to Twilio Assets. This command needs to be invoked inside a plugin directory.

USAGE
  $ twilio flex:plugins:deploy

OPTIONS
  --changelog=changelog
  --description=description
  --json
  --major
  --minor
  --patch
  --public
  --version=version

See code: src/commands/flex/plugins/deploy.ts

twilio flex:plugins:describe:configuration

Describes a release.

USAGE
  $ twilio flex:plugins:describe:configuration

OPTIONS
  --json
  --sid=sid  (required)

See code: src/commands/flex/plugins/describe/configuration.ts

twilio flex:plugins:describe:plugin

Describes a plugin.

USAGE
  $ twilio flex:plugins:describe:plugin

OPTIONS
  --json
  --name=name  (required) The plugin name to describe

See code: src/commands/flex/plugins/describe/plugin.ts

twilio flex:plugins:describe:plugin-version

Describes a plugin version.

USAGE
  $ twilio flex:plugins:describe:plugin-version

OPTIONS
  --json
  --name=name        (required) The plugin name to describe
  --version=version  (required) The plugin version to describe

See code: src/commands/flex/plugins/describe/plugin-version.ts

twilio flex:plugins:describe:release

Describes a release.

USAGE
  $ twilio flex:plugins:describe:release

OPTIONS
  --active
  --json
  --sid=sid  The release sid to describe

See code: src/commands/flex/plugins/describe/release.ts

twilio flex:plugins:diff ID1 [ID2]

Finds the diff between two configurations.

USAGE
  $ twilio flex:plugins:diff ID1 [ID2]

OPTIONS
  --json

See code: src/commands/flex/plugins/diff.ts

twilio flex:plugins:list:configurations

Lists the configurations on the account.

USAGE
  $ twilio flex:plugins:list:configurations

OPTIONS
  --json

See code: src/commands/flex/plugins/list/configurations.ts

twilio flex:plugins:list:plugin-versions

Lists the plugin versions on the account.

USAGE
  $ twilio flex:plugins:list:plugin-versions

OPTIONS
  --json
  --name=name  (required) The plugin name to list its versions

See code: src/commands/flex/plugins/list/plugin-versions.ts

twilio flex:plugins:list:plugins

Lists the plugins on the account.

USAGE
  $ twilio flex:plugins:list:plugins

OPTIONS
  --json

See code: src/commands/flex/plugins/list/plugins.ts

twilio flex:plugins:list:releases

Lists the releases on the account.

USAGE
  $ twilio flex:plugins:list:releases

OPTIONS
  --json

See code: src/commands/flex/plugins/list/releases.ts

twilio flex:plugins:release

Creates a Flex Plugin Release. This command needs to be invoked inside a plugin directory.

USAGE
  $ twilio flex:plugins:release

OPTIONS
  --configuration-sid=configuration-sid
  --description=description              The configuration description
  --json
  --name=name                            [default: Aug 14, 2020]
  --new

  --plugin=plugin                        The plugin to install, formatted as pluginName@version. Use additional --plugin
                                         to provide other plugins to install

See code: src/commands/flex/plugins/release.ts

twilio flex:plugins:remove

Removes the Flex plugin. This command needs to be invoked inside a plugin directory.

USAGE
  $ twilio flex:plugins:remove

OPTIONS
  --json

See code: src/commands/flex/plugins/remove.ts

twilio flex:plugins:start

Starts a dev-server to build the Flex plugin locally. If the --name flag is used at least once, the command does not need to be invoked in a plugin directory. Else, it does.

USAGE
  $ twilio flex:plugins:start

OPTIONS
  --include-remote  Use this flag to include all remote plugins in your build.
  --json

  --name=name       The name of the plugin(s) you would like to run, formatted as pluginName to run locally, or
                    pluginName@remote to run remotely.

See code: src/commands/flex/plugins/start.ts