Skip to main content
Version: 6.x


single-spa-riot is a helper library that helps implement single-spa registered application lifecycle functions (bootstrap, mount and unmount) for for use with riot. Check out the single-spa-riot github.


Build Status



npm install --save single-spa-riot


import * as Riot from "riot";
import singleSpaRiot from "single-spa-riot";
import App from "./App.riot";

const riotLifecycles = singleSpaRiot({
rootComponent: Riot.component(App),
domElementGetter: () => document.getElementById("#app"),

export const bootstrap = riotLifecycles.bootstrap;

export const mount = riotLifecycles.mount;

export const unmount = riotLifecycles.unmount;


All options are passed to single-spa-riot via the opts parameter when calling singleSpaRiot(opts). The following options are available:

  • domElementGetter: (required) the callback to get root component mount element.
  • rootComponent: (optional and replaces appOptions.loadRootComponent) the root riot component.
  • loadRootComponent: (optional and replaces appOptions.rootComponent) A promise that resolves with your root component. This is useful for lazy loading.