Electrode Subapp For Preact and Redux Bundler
This module mainly serve to setup subapp-web with Preact framework, and the support for redux-bundler for Electrode subapps.
It basically re-exports the module subapp-web and sets it up with Preact specific APIs.
- For convenience, it also exports preact's
h, Component, and render APIs.
- It adds a new
reduxBundlerLoadSubApp API for loading subapps that use redux-bundler.
ES6 and Modules
This package only export its code for node.js with main field and ES modules with module field.
This is neccessary for webpack to do treeshaking when bundling code.
This module also depend on the app loading polyfills for ES6 libraries and APIs such as Promise or array methods.
The recommendation is to use polyfill.io.
Babel Runtime
This package transpile ES6 syntax to ES5 syntax and depend on [@babel/runtime] to provide helpers. It pulls version 7.
Usage
To use, a subapp's code should be doing:
/** @jsx h */
import { h, reduxBundlerLoadSubApp } from "subapp-pbundle";
import Component from "./component";
export default reduxBundlerLoadSubApp({ name: "MyComponent", Component });
preact and preact-render-to-string are specified as peerDependencies, so you must install them as part of your package.json dependencies.
SSR App Context
This module also exports a default Preact context that SSR uses to pass in server request object to your React component.
ie:
import { AppContext } from "subapp-pbundle";
const Component = () => {
return (
<AppContext.Consumer>
{({ isSsr, ssr, subApp }) => {
return (
<div>
IS_SSR: {`${Boolean(isSsr)}`} HAS_REQUEST: {ssr && ssr.request ? "yes" : "no"}
</div>
);
}}
</AppContext.Consumer>
);
};
Support for React Router
TBD
Support for SSR with Suspense
Preact Suspense support is still experimental. TBD.
License
Copyright (c) 2016-present, WalmartLabs
Licensed under the Apache License, Version 2.0.
