flowbased-polymer | Vaadin

FlowBasedProgramming with web-components



For Polymer 3 and higher use npm:

npm i --save  @furo/fpb

For Polymer 2 and below use bower:

bower install --save veith/flowbased-polymer

The flowbased-polymer mixin offers you the possibility to write your components or apps fully declaratively. No more manual/imperative adding of eventListeners in the source code and no searching for IDs to access the component you want.

You can use it to simply save adding eventlisteners in your source or to write entire components and applications according to the FBP programming paradigm without using a single line of JS. It's up to you how far you want to go.

FBP code is also easy testable. It takes about 2 minutes to understand the main concept.

It is a hybrid form of flow-based programming and ordinary polymer and works with every component which is useable by polymer.

Published on webcomponents.org

Simple Introduction

In short, FBP combines events from one component @-event with methods from another component ƒ-method to trigger them. We call the connection a wire.

    <paper-button raised @-click="--btnPropsClicked">Show Props</paper-button>
    <left-drawer ƒ-hide="--btnPropsClicked">Menu...</left-drawer>
    <right-drawer ƒ-show="--btnPropsClicked">Props...</right-drawer>

simple intro


When the user clicks on the paper-button, the left-drawer is hidden and the right-drawer is displayed. The button does not need to know that there is a left-drawer or right-drawer. It only informs about the wire --btnPropsClicked that it was clicked.

Further documentation

Please read the documentation page for more information.


After importing the Mixin, extend your component with the FBPMixin. Thats all you have to do.

import {PolymerElement, html} from '@polymer/polymer';
import {FBP} from "@furo/fbp";
// ...

 * `my-component`
 * @summary
 * @customElement
 * @polymer
 * @mixes FBP
class MyComponent extends FBP(PolymerElement) {
    static get template() {
    // language=HTML
    return html`
        :host {
          display: block;
      <paper-button raised @-click="--btnPropsClicked">Show Props</paper-button>
      <left-drawer ƒ-hide="--btnPropsClicked">Menu...</left-drawer>
      <right-drawer ƒ-show="--btnPropsClicked">Props...</right-drawer>



window.customElements.define('my-component', MyComponent);

Detailed documentation

Read more about FBPolymer on the documentation pages.




Link to this version
ImportedReleased 22 February 2019MIT License
Framework Support
Polymer 3.0+
Also supported:
Polymer 1 (1.16.0)Polymer 2 (3.4.1)
Browser Independent
Install with
npm install @furo/fbp"@4.3.1"
Run the above npm command in your project folder. If you have any issues installing, please contact the author.
Release notes - Version 4.3.1


  • @polymer/polymer#^3.0.0