Simplicity Embed™ Overview
Simplicity Embed™ is a robust web component that lets you easily create universally embeddable web widgets with any front-end and/or backend technology that you work with. The component solves the problem of integration, isolation, and communication.
For example, a mini application built in React can be distributed to work in any web page or even another application built in another framework like Vue or Angular.
Allow others to simply integrate your web apps built with Angular, ASP.NET, Backbone, Django, Ember, Java, JQuery, Mithril, Node, PHP, React, Ruby, Svelte, Vanilla JS, Vue and more!
Any web application can be turned into an embeddable widget
Any frontend framework can be used
Any backend technology can be used
Benefits
- The Simplicity Embed™ solves many problems with integrating a web application into another web page or another web application built with another framework.
- Code Isolation
- CSS Isolation
- Custom Command Communications to and from the host page to your widget/app
- Resizing As Host Page Resizes
- Inline or Overlay Modes that Can be Changed at Runtime
- Modal or nonmodal overlay mode
- Custom attributes can be defined that get passed to your widget/app
- Configuration file allows for A/B testing, dynamic update of widget/app displayed
Architecture
The Simplicity Embed™ web component allows you to embed web pages or complete web applications into other web pages. The copmponent simplifies the nuances that you come across when distributing an embed. The component allows you to define how the content or app gets embedded into the host page. That is, it can be defined to be an overlay (similar to how you commonly see chat widgets embedded) or it can be defined to be hosted inside of a container.
Iframe
Yes, the Simplicity Embed™ web component utilizes an iframe. This is still the best way to achieve isolation when distributing an embed to unknown HTML pages that you have no control over. We offer an iframe tester that you can use to see if your content / app can be embedded. If it cannot, we offer basic instructions on how to allow content to be embedded.
Host Communication to Your Widget
The Simplicity Embed™ web component provides you with mechanisms to allow the page hostinjg the embed component to communicate with your app (if you wish). You can define as many of these passthrough commands as you wish.
Configuration File
The Simplicity Embed™ component hs a setup attribute that points to a JSON configuration file. The file provides information about the initial setup of the component, the fully qualified URL of the widget, the positioninig of the widget, etc. The fact that you can host the setup file (if you wish), you can decide what widget gets loaded. This can be helpfull for A/B testing, different version testing, seasonal changes, etc.
Documentation
Further detail about these can be viewed in the Simplicity Embed™ Reference Manual
The Best Way to Learn Simplicity Embed™
The best way to learn Simplicity Embed™ is check out our quick start section. That will give you instructions to download one of our pre-built example projects and study how you can use it to embed your content or app.