Socket
Socket
Sign inDemoInstall

@twilio/flex-plugin

Package Overview
Dependencies
0
Maintainers
1
Versions
302
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@twilio/flex-plugin

Runtime for Flex plugins


Version published
Weekly downloads
8.3K
increased by26.04%
Maintainers
1
Created
Weekly downloads
 

Readme

Source

Version Downloads License

Flex Plugin

Library to help building Twilio Flex Plugins.

Installation

npm install flex-plugin

Usage

import { loadPlugin, FlexPlugin } from '@twilio/flex-plugin';

class MyPlugin extends FlexPlugin {
  pluginName = 'MyPlugin';

  init(flex, manager) {
    // set up your flex
    flex.TaskCanvas.Content.add(<p>Hello</p>);
  }
}

loadPlugin(MyPlugin);

Visit Twilio Docs for a tutorial on creating your first plugin.

Libraries

Loading External JS/CSS Files

To load external JS/CSS files into your plugin, we provide two helper methods: loadJS and loadCSS. Use them by calling these methods at the start of plugin initialization.

import { FlexPlugin, loadJS, loadCSS } from '@twilio/flex-plugin';

class MyPlugin extends FlexPlugin {
  pluginName = 'MyPlugin';

  init(flex, manager) {
    loadJS('http://mysite.com/files/flex.js');
    loadCSS(
      'http://mysite.com/files/flex.css',
      'http://mysite.com/files/flex-2.css',
    );

    // set up everything else
  }
}

The CSS/JS files must be accessible by Twilio's proxy servers. Local files on your desktop are likely inaccessible via these methods, but your stylesheet may be uploaded to Twilio Assets for use here.

External Dependencies

The following NPM packages are defined as external dependencies:

react
react-dom
redux
react-redux

When you build your plugin, these dependencies will not be included in your bundle. Instead, Flex UI will provide them as global for your plugin to use.

To ensure you are using the same version that Flex UI is exposing, leave the version of the React that is specified in your package.json. See React Versions to see the currently supported version.

React Versions

We currently support the following versions:

react          16.5.2
react-dom      16.5.2
redux          3.7.2
react-redux    5.1.0

Contributing

Make sure to follow the instructions in the main repository to set up the project.

# Install dependencies and link local packages with each other
cd packages/flex-plugin-scripts
npx lerna bootstrap

# Run tests
npm test

# To use your local package in a different project
npm link
# then in a different project
npm link flex-plugin-scripts

Contributors

Thank you to all the lovely contributors to this project. Please check the main repository to see all contributors.

License

MIT

Keywords

FAQs

Last updated on 10 Jun 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc