Symbiote.js

Simple, light and very powerful library to create embedded components for any purpose, with a data flow management included.

⚖️ What for?

Symbiote.js - is for symbiosis. That means, you can create complex meta-applications, above another applications, built with any modern stack.

The major purpose of Symbiote.js - is to move application inner interactions from the locked space of certain frameworks implementations to the common open space based on native platform features and standards, to be closer to the HTML, CSS and simple DOM APIs, without a lack of DX.

Best for:

• Complex widgets
• Micro frontends
• Reusable component libraries
• Fast and reliable web applications
• Framework agnostic solutions
• Meta-applications
• JamStack solutions

Symbiote.js is designed to give the level of freedom, you got with Vanilla JS and to give the convenience level, as you got from the modern frameworks at the same time.

🔥 Core benefits

• Minimal but rich.
• No extra dependencies.
• Ultralight (~4kb br/gzip for the all BaseComponent features).
• Blazing fast.
• Memory friendly (no immutables).
• CSP friendly - good for enterprise usage.
• Highly extensible - you can add new custom features with ease.
• Easy to learn - nothing completely new for experienced developers, nothing complicated for newbies.
• Works in all modern browsers. As is.
• Easy to test.
• TypeScript friendly - use it in TS or JS projects from the common source code.
• Integration friendly: works with any modern development stack.
• Lifecycle control: no need to initiate something from outside.
• ESM friendly - native JavaScript modules are best!
• Developer Experience on the mind: compact & convenient APIs, habitual syntax.
• Open source (MIT license).

💎 Tech concept keypoints

• Native modern APIs instead of expensive libraries.
• Shadow DOM is optional. Use it when you need it only.
• Total styling freedom: from the old classics to the cutting edge platform abilities.
• Native HTML instead of custom template syntax processing.
• Templates are out of the component or render function context. It’s just a simple JavaScript template literals. So you can keep or process them wherever you want.
• No logical operators in templates. Logic and presentation are strictly separated.
• Fast synchronous UI updates, no unexpected redraws.
• Full data context access from the document structure.
• Full data context availability for template bindings.
• DOM API friendly approach for the most performant solutions.
• Convenient object model access instead of opaque abstractions.

🍏 Quick start

The easiest way to try Symbiote.js is to create a simple html file in your text editor and connect the Symbiote base class from web:

<script type="module">
  import { BaseComponent } from 'https://symbiotejs.github.io/symbiote.js/core/BaseComponent.js';

  class MyComponent extends BaseComponent {
    init$ = {
      count: 0,
      increment: () => {
        this.$.count++;
      },
    }
  }

  MyComponent.template = /*html*/ `
    <h2>{{count}}</h2>
    <button set="onclick: increment">Click me!</button>
  `;

  MyComponent.reg('my-component');
</script>

<my-component></my-component>

This code can work directly in any modern browser, so you don't need to install anything to try it!

🧜‍♀️ Dive deeper

Check the project documentation for details:

🤖 Live examples

Browser: https://symbiotejs.github.io/examples/

Use devtools to discover details

GitHub: https://github.com/symbiotejs/examples

✅ Browser support

Symbiote.js is supported and tested in all major modern desktop and mobile browsers:

• Chrome
• Firefox
• Safari
• Opera

Internet Explorer - is outdated and not supported anymore:

https://uploadcare.com/blog/uploadcare-stops-internet-explorer-support/

(But it's possible with polyfills: https://github.com/webcomponents/polyfills/tree/master/packages/webcomponentsjs)

💰 General sponsor

Big thanks to 🟡 Uploadcare for supporting this project!

https://uploadcare.com/

🌎 Useful external links

If you have questions or proposals - welcome to Symbiote Discussions! ❤️