An express middleware which handles server side rendering via Hypernova from AirBnB.

Downloads in past


331.0.44 years ago5 years agoMinified + gzip package size for @immowelt/hypernova-express in KB


Powered by Immowelt Build Status Dependency Status devDependency Status Renovate enabled semantic-release
An express middleware which handles server side rendering via Hypernova from AirBnB.


To install the middleware just execute the following command in your workspace.
yarn add @immowelt/hypernova-express --dev

and configure your express server to use the middleware, e.g.
const express = require('express');
const path = require('path');
const Renderer = require('hypernova-client');
const createHypernovaMiddleware = require('@immowelt/hypernova-express');
const fetch = require('node-fetch');

const app = express();

app.get('/', createHypernovaMiddleware({
	createRequestProps: async (req) => {
		const componentProps = {};

		try {
			const res = await fetch('fetch/some/thing.json');

			componentProps.data = await res.json();
		} catch (e) {}

		return Promise.resolve({
			myRegisteredComponent: componentProps
	templatePath: path.join(__dirname, 'index.html'),
	templateMarker: '<i data-html></i>',
	renderer: new Renderer({
		url: `http://localhost:8081/batch`


As seen in the example you can configure the middleware just like any express middleware by passing in an options object.


const createHypernovaMiddleware = require('@immowelt/hypernova-express');


A required function that returns a Promise which will resolve with the query/props for the hypernova renderer. The function gets called with the incomming request object from express is the best place to prepare or fetch props for your Component/App that shall be rendered.


A required full file-system path to the base template you want to wrap around the response of Hypernova.

opts.templateMarker (optional)

The piece of markup that will be replaced with the HTML retrieved from the Hypernova service.


The required renderer instance of hypernova-client.


See the CONTRIBUTING.md file at the root of the repository.


See the LICENSE file at the root of the repository.