Public repo of the original developers internal version
Go to file
2018-06-03 11:22:27 -04:00
.circleci adding test coverage 2018-05-29 22:11:05 -04:00
jest adding tests 2018-05-29 21:57:30 -04:00
public adding widget output 2018-05-28 22:49:38 -04:00
src adding tests 2018-05-29 21:57:30 -04:00
.eslintrc adding widget output 2018-05-28 22:49:38 -04:00
.gitignore adding test coverage 2018-05-29 22:11:05 -04:00
package-lock.json adding tests 2018-05-29 21:57:30 -04:00
package.json adding docs 2018-06-03 11:21:39 -04:00
README.md adding docs 2018-06-03 11:21:39 -04:00
webpack.config.js prod build 2018-05-30 20:45:33 -04:00

Embeddable React Widget

CircleCI codecov Greenkeeper badge

Easy creation of an embeddable widget.

Features

  • Full ES6/ES2015 support (with Babel)
  • Package fonts, css, json, javascripts together into one single package (with Webpack)
  • No css styling conflicts between the host page and the widget (with https://github.com/premasagar/cleanslate)
  • User theming of widget
  • Obfuscating of the widget code
  • Unit Tested with code coverage enabled
  • Continuous Integration ready

Running the widget

Install dependencies

$ npm install

Start the development server

$ npm start
... server running at http://localhost:8080/

Run tests

$ npm test
... test output

Production build

$ npm run build
... create files in /dist

Roadmap

  • Widget as react app - index.html works (webpack, babel, react)
  • React widget (widget builder)
  • Webpack changed to output a library
  • Add tests
  • Add circleci integration
  • Add codecov integration for codecoverage
  • Production Build
  • Minified
  • Add greenkeeper
  • Reset / Cleanslate / No-conflicts of styles
  • Obfuscation
  • Integrate eslint with webpack
  • Theming support
  • Storyboard and docs

Background

What is an embeddable widget?

  • Usable using a simple <script> tag
  • Configurable with code
  • Themable

Why not in an iframe?

  • Interaction between the frame and the hosting page is tricky and not recommended
  • You can only display content within the iframe
  • iframe and content resizing is impossible
  • iframe sandboxing can result in missing functionalities

Read more

Read more about about widgets, react and scoping of css.