parlor

parlor

A collection of tools for creating React and Next.js apps.

install

yarn add parlor or npm i -S parlor

usage

Detailed examples can be found at the interplay.app repository.

syncRouting

Sync some routing on a single page app within _app.js of a Next app.

...
import { syncRouting } from 'parlor';
import { matches, getCurrentPath, pages } from '../lib/routing';
...

class ReduxApp extends NextApp {
  ...
  componentDidMount() {
    syncRouting({ matches, getCurrentPath, pages });
  }
  ...
}

next-server

A replacement for server.js within a Next app that always renders the root page.

$ node node_modules/parlor/dist/next-server.js

spa-server-maker

Use to generate a SPA server that serves the build directory's index.html and static files. This is useful running a server for E2E tests through Nightwatch.js.

const spaServerMaker = require('parlor/dist/spa-server-maker.js');
const appRoot = require('app-root-path');

const server = spaServerMaker(done, appRoot.toString());
server.close();

spa-server

Starts an SPA server using spa-server-maker.

$ node node_modules/parlor/dist/spa-server.js

requirements

• Node 8 LTS
• Yarn 1.9.4
• Peer dependencies: next

commands

• yarn to install NPM packages
• yarn prettier to clean code
• yarn eslint to check code is clean
• yarn ci to run all continuous integration tests
• yarn babel to convert code from src to dist
• yarn publisher - to convert code and then start publishing