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, pages } from '../lib/routing';
...

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

getCurrentPath

Get the current browser path in a cross-platform friendly way. Defaults to an empty string.

import { getCurrentPath } from 'parlor';
const currentPath = getCurrentPath();

getLocale

Get the current locale in a cross-platform friendly way. Defaults to en.

import { getLocale } from 'parlor';
const locale = getLocale();

matchesGenerator

Generates matches that can be used for determining if a path matches a valid route.

const { matchesGenerator } = require('parlor');
exports.matches = matchesGenerator('/:page/:alpha');

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 an SPA server that serves the build directory's index.html and static files. This is useful when running a server for E2E tests using 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