Cisco Spark for React (react-ciscospark)

• THIS REPO CONTAINS EXPERIMENTAL CODE *

The Cisco Spark for React library allows developers to easily incorporate Spark functionality into an application.

Table of Contents

• Background
• Widgets
• Install
  • Build from Source
• Components
  • Install
• Browser Support

Background

This library allows React developers to quickly and easily create a Cisco Spark experience within their apps. Here we provide basic components (e.g. buttons, text fields, icons) that reflect the styles and aesthetics of Spark, along with more complex, complete widgets, such as the Spark Message and Meet Widget.

The basic components are just presentational React https://github.com/facebook/react components, while our widgets leverage Redux https://github.com/reactjs/redux and the Spark Javascript SDK https://github.com/ciscospark/spark-js-sdk.

Widgets

While many of our components are purely presentational, some have extended functionality that provide a piece of the full Cisco Spark experience. These fully self contained elements are called Widgets and are available here:

• Message and Meet Widget

Install

Build From Source

1. Clone this repo using a git client (e.g. git clone https://github.com/ciscospark/react-ciscospark.git)
2. Run npm install from the root of the repo. You will want to run this every time you pull down any new updates.
3. From the root of the repo, run the following to build the widget:

npm run build

1. The built bundles are located at packages/node_modules/@ciscospark/PACKAGE_NAME/dist.

Limitations

Development

• stylelint currently ignores all node_modules directories, and will not lint our packages. Discussion: stylelint/stylelint#2236