Skip to content
RingCentral Integration Widget Library
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.ackrc coveragePathIgnorePatterns Aug 8, 2017
.eslintignore fix different tests maybe interfer with each other when they share st… ( Sep 7, 2018
.eslintrc Enhance/shared babel (#738) May 9, 2018
.gitattributes feat: 🎸 Add vertualized list to fix `CallList` performance prob (#1372) Oct 23, 2018
.prettierrc style: 💄 Add prettier config for better formatting (#1381) Oct 17, 2018
.travis.yml Sync new features and bugfixs from ce1e1d6 (#1586) Mar 15, 2019
LICENSE Refactor Welcome Page, RegionSettings, and CallingSettings Jan 12, 2017
lerna.json Monorepo to merge commons ang widgets (#712) Apr 26, 2018
package.json Sync new features and bugfixs from 6eba761 (#1584) Mar 1, 2019


Build Status Coverage Status Codacy Badge NPM Version NPM Version


RingCentral integration widgets aim to provide reusable RingCentral service module and UI components to allow developers to integrate RingCentral unified communication service into third party processes or tools more easily.

This project includes RingCentral Integration Common Library and RingCentral Widgets Library. The basic idea is to connect modules in RingCentral Integration Common Library with React components to provide ready to use UI widgets.

Get Started

We use RingCentral Widgets CLI to startup a RingCentral Widgets based app.

$ npm install -g ringcentral-widgets-cli
$ rc-widgets -h

Create a new project

rc-widgets new your_project_name
cd your_project_name
yarn install

Update .env file in project root path.

Start development server

$ yarn start

Visit on http://localhost:8080 in browser.

For production build and deploy, please get more information in here.


This is a demo and step-by-step tutorials show how to use this library.

Contribution and Development

We use Lerna.js to manage packages source. And we require Node.js > 8.

Clone the repo:

$ git clone
$ cd ringcentral-js-widgets

Install dependent libraries:

$ yarn install
$ yarn bootstrap # Bootstrap with lerna
$ yarn test # Run tests


$ git add .
$ yarn commit
$ yarn git-cz

Play with Development Server

A development server is delivered with source so that developers can use it to get familiar with the project or do further development. To get development server running:

Create a file named api-config.js in following format in folder packages/ringcentral-widgets-demo/dev-server to specify app related info

export default {
  appKey: ${app key},
  appSecret: ${app secret},
  server: ${server url},

Run following command to start development server

$ yarn start

The development server is listening on port 8080 by default. Open up your browser and access http://localhost:8080 to see how it works.

Note that the development server is using OAuth for authorization process. Please make sure the app you specified in configuration above is setup with Redirect Uri http://localhost:8080/redirect.html.

Projects which use this library

You can’t perform that action at this time.