reactant-share

A framework for building shared web applications that support multiple windows.

Support

• Shared Tab
• Shared Worker
• Detached window
• iframe
• Coworker
• Any other data-transport based application port, such as WebRTC

Usage

npm install reactant-share
# or
yarn add reactant-share

Here is the counter example, it uses reactant-share ShareWorker mode:

• app.view.tsx:

import React from 'react';
import {
  ViewModule,
  createApp,
  injectable,
  useConnector,
  action,
  state,
  spawn,
} from 'reactant-share';

@injectable({ name: 'counter' })
class Counter {
  @state
  count = 0;

  @action
  increase() {
    this.count += 1;
  }
}

@injectable()
export class AppView extends ViewModule {
  constructor(public counter: Counter) {
    super();
  }

  component() {
    const count = useConnector(() => this.counter.count);
    return (
      <button type="button" onClick={() => spawn(this.counter, 'increase', [])}>
        {count}
      </button>
    );
  }
}

• index.tsx:

import { render } from 'reactant-web';
import { createSharedApp } from 'reactant-share';
import { AppView } from './app.view';

createSharedApp({
  modules: [],
  main: AppView,
  render,
  share: {
    name: 'SharedWorkerApp',
    port: 'client',
    type: 'SharedWorker',
    workerURL: 'worker.bundle.js',
  },
}).then((app) => {
  app.bootstrap(document.getElementById('app'));
});

• worker.tsx:

import { createSharedApp } from 'reactant-share';
import { AppView } from './app.view';

createSharedApp({
  modules: [],
  main: AppView,
  render: () => {
    //
  },
  share: {
    name: 'SharedWorkerApp',
    port: 'server',
    type: 'SharedWorker',
  },
}).then((app) => {
  // renderless
});

Workflow

1. client App: spawn(this.counter, 'increase', [])
2. server app: this.counter.increase()
3. return value to current client app and sync state to all client apps

Examples

• shared-worker
• shared-tab
• dynamic-module

Documentation

You can visit reactant.js.org for more documentation.