@hmcts/one-per-page

One per page

Easily build GOV.UK style one question per page services using express, nunjucks and webpack.

Features

One per page solves a number of hard problems in building a one question per page service:

• Capturing and validating users answers
• Navigating branching journeys
• Session management
• Content internationalisation
• Template management

All documentation is available at https://one-per-page.herokuapp.com

Usage

Add one-per-page and look-and-feel to your package.json:

> yarn add @hmcts/one-per-page @hmcts/look-and-feel

Then create a few steps and wire them to your express app:

app.js

const app = express();

class Start extends EntryPoint {
  next() {
    return goTo(this.journey.steps.CheckYourAnswers);
  }
}

class Name extends Question {
  get form() {
    return form({
      firstName: text.joi('Enter your first name', Joi.string().required()),
      lastName: text.joi('Enter your last name', Joi.string().required()),
    });
  }
  next() {
    return goTo(this.journey.steps.CheckYourAnswers);
  }
}

journey(app, {
  steps: [
    Start,
    Name,
    CheckYourAnswers
  ]
});

app.listen(3000);

And create a template for your step:

Name.template.html

{% extends "look-and-feel/layouts/question.html" %}
{% from "look-and-feel/components/fields.njk" import textbox %}

{% set title %}What is your name?{% endset %}

{% block fields %}
  {{ textbox(fields.firstName, "First Name") }}
  {{ textbox(fields.lastName, "Last Name") }}
{% endblock %}

@hmcts/look-and-feel helps with creating templates

Then start your app:

> node app.js
# listening on port 3000

Contribute

This project is open to accepting contributions. Check out our open issues for ideas on where to start or to raise your own issue. Read our development documentation for help on getting started.

Changelog

2.4.0 (2018-02-20)

• Allow tests to customise the views dir (516bc19)
• Document CheckYourAnswers and the html answers option (dd4d45e)
• Encapsulate answer rendering, to allow for overriding (54e316b)
• Increase coverage over answer.js (8893fb9)
• Increase coverage over CheckYourAnswers (1053e97)
• Nest answer inside it's module (eed7088)
• Release 2.4.0-1 (64d5bf1)
• Render templates from answers that have one (60abe2a)
• Update example apps dependencies (0cfbb51)

<a name="2.4.0-1"></a>