Public repo of the original developers internal version
Go to file
2019-05-11 09:51:48 -04:00
.circleci adding test coverage 2018-05-29 22:11:05 -04:00
jest fixing tests for changed bookmark 2018-06-09 09:17:40 -04:00
public Update blank.html with note regarding widget location 2018-09-19 11:24:30 -04:00
src fixing tests for changed bookmark 2018-06-09 09:17:40 -04:00
vendor adding cleanslate support for style scoping 2018-06-09 08:43:18 -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
bookmarklet-flow.gif doc: fix typo (#84) 2019-04-27 09:01:23 -04:00
package-lock.json chore(deps): update dependency enzyme-adapter-react-16 to v1.13.0 (#90) 2019-05-11 09:51:48 -04:00
package.json chore(deps): update dependency enzyme-adapter-react-16 to v1.13.0 (#90) 2019-05-11 09:51:48 -04:00
README.md doc: adjust demo size (#85) 2019-04-27 09:04:32 -04:00
renovate.json Add renovate.json (#63) 2019-04-16 14:10:29 -04:00
webpack.config.js fix: webpack config (#82) 2019-04-27 08:01:14 -04:00

Embeddable React Widget

Easy creation of embeddable widgets - https://seriousben.github.io/embeddable-react-widget

CircleCI codecov Renovate enabled

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)
  • Bookmarklet supported for fast testing and demonstration
  • User theming of widget
  • Obfuscating of the widget code
  • Unit Tested with code coverage enabled
  • Continuous Integration ready

Demo

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
  • Bookmarklet
  • Reset / Cleanslate / No-conflicts of styles
  • Obfuscation
  • Theming support
  • Storyboard and docs
  • Integrate eslint with webpack

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.