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
, andrender
APIs. - It adds a new
reduxBundlerLoadSubApp
API for loading subapps that use redux-bundler.
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.
This package transpile ES6 syntax to ES5 syntax and depend on [@babel/runtime] to provide helpers. It pulls version 7.
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.
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>
);
};
TBD
Preact Suspense support is still experimental. TBD.
Copyright (c) 2016-present, WalmartLabs
Licensed under the Apache License, Version 2.0.