Reference Implementation

The upward-js package is a reference implementation of the UPWARD specification built using JavaScript. This package is able to run as standalone server or as an Express/Connect middleware.

If you followed the instructions for Setting up Venia, it automatically sets up and uses this implementation as its application shell server.

Use the following command to install upward-js in your project:

yarn add @magento/upward-js

Use the command line, server API, or middleware API to launch the upward-js server.

You can make this project available to the command line by installing it globally:

yarn global add @magento/upward-js

Launch the server in the foreground using the following command:

upward-js-server

This command does not take arguments. Instead, it uses the following environment variables for configuration:

Require server from @magento/upward-js in your Node script to import the server into your project.

Example:

const server require @magento/upward-js cons app upward upwardPath ./my-upward-server.yml app listen 8000;

Use middleware from @magento/upward-js to use the middleware into your project. This middleware is compatible with Express 4, Connect, and other frameworks that use this common pattern. It returns a Promise for a function which handles request/response pairs

Example:

class="kd">const express require express); const middleware} require @magento/upward-js); const app express (); app. use otherMiddlewaresMaybe app. use(middleware(./my-upward-server.yml'));

You can also pass an IOAdapter as a second argument to the middleware.