@platform/react.ssr NPM

banner

A lightweight SSR (server-side-rendering) system for react apps bundled with ParcelJS and hosted on S3.

Live Demo:

https://ssr.platform.uiharness.com

Highlights:

Store assets on S3 (or Digital Ocean Spaces).
Serve entry HTML from server (immediate load from "server-side-render").
307 redirect all other assets to S3/CDN (geo-edge cache).
Manage lifecycle with simple command-line tools:
- Bundle and push to S3 via command-line.
- Manage versioned releases (with simple roll-backs) across multiple sites/environments.
  (eg. dev, staging, prod)

diagram

Setup

yarn add @platform/react.ssr

Workflow

Develop UI components on local dev-server within the UIHarness or anything that can produce a javascript bundle (eg ParcelJS):
Ensure the UI module has a bundle script within it's package.json.
Create an ssr.yml configuration file for the server.

Sample

The /sample/now and /sample/server are expecting a .env file with your S3 account information:

# 
# Digital Ocean "SPACES" or AWS "S3" connection secrets.
# 
SPACES_KEY="..."
SPACES_SECRET="..."

These are referenced within the ssr.yml config file.

Example sequence:

🌼
cd sample/ui
yarn start

Bundle a version and push it to S3:

🌳
cd sample/server
yarn ssr bundle

Release bundled version by updating manifest:

🌳
cd sample/server
yarn ssr release

Start local SSR server to test the bundle:

🌼
cd sample/server 
yarn start

Open in http://localhost browser (address/port exposed in server startup log).

Routes

The following system routes are exposed for examining meta-data about the current state and configuration of the server.

https://domain.com/.manifest
https://domain.com/.manifest/summary
https://domain.com/.manifest/summary/<site>

@platform/cli @platform/exec @platform/fs @platform/fs.s3 @platform/http @platform/libs @platform/log @platform/micro @platform/npm @platform/react bowser cheerio listr path-to-regexp semver

@infinitebrahmanuniverse/nolb-_plat @everything-registry/sub-chunk-725

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago