!Module
!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.

`

These are referenced within the ssr.yml config file.


#### Example sequence:

`bash
🌼
cd sample/ui
yarn start
`


Bundle a version and push it to S3:

`bash
🌳
cd sample/server
yarn ssr bundle
`

Release bundled version by updating manifest:

`bash
🌳
cd sample/server
yarn ssr release
`

Start local SSR server to test the bundle:

`bash
🌼
cd sample/server
yarn start
`

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

Routes

`
https://domain.com/.manifest
https://domain.com/.manifest/summary
https://domain.com/.manifest/summary/
``