Initial commit

Author: kevinsinclairdwp

.gitignore

@@ -0,0 +1,12 @@
+# Node.js ignores
+node_modules/
+
+# Prototype ignores - per-user
+.tmp/
+.env
+migrate.log
+usage-data-config.json
+
+# General ignores
+.DS_Store
+.idea

.npmrc

@@ -0,0 +1 @@
+audit=false

HOW-TO-GUIDES.MD

@@ -0,0 +1,26 @@
+You can find all the tutorials and guides for using the GOVUK Prototype kit here
+https://prototype-kit.service.gov.uk/docs/tutorials-and-guides
+
+
+Commonly used guides
+
+How to create pages from templates
+https://prototype-kit.service.gov.uk/docs/make-first-prototype/create-pages-from-templates
+
+How to use components from the Design System
+https://prototype-kit.service.gov.uk/docs/make-first-prototype/use-components
+
+How to Pass data from page to page
+https://prototype-kit.service.gov.uk/docs/pass-data
+
+How to use layouts
+https://prototype-kit.service.gov.uk/docs/how-to-use-layouts
+
+How to install and use plugins
+https://prototype-kit.service.gov.uk/docs/install-and-use-plugins
+
+How to change the content within a page based on a user's answers
+https://prototype-kit.service.gov.uk/docs/conditional-content
+
+How to show the user’s answers on the ‘Check answers’ page
+https://prototype-kit.service.gov.uk/docs/make-first-prototype/show-users-answers

LICENCE.txt

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (C) 2014 Crown Copyright (Government Digital Service)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,19 @@
+Use this template to create new prototypes in DWP. This template is updated with every major version release of the GOVUK prototype kit. 
+
+Support
+
+If you've got a question, idea or suggestion about the GOVUK protoype kit, get in touch with the GOV.UK Prototype team.
+
+The GOV.UK Prototype team provides support to people who use the Prototype Kit and work in government.
+
+We cannot give general advice to the public. We do not have access to information about you held by government departments.
+
+For other enquiries, use the contact form on GOV.UK.
+
+Slack
+
+Use the #govuk-prototype-kit channel on cross-government Slack.
+
+Email
+
+Email the GOV.UK Prototype team at govuk-prototype-kit-support@digital.cabinet-office.gov.uk.

app/assets/javascripts/application.js

@@ -0,0 +1,8 @@
+//
+// For guidance on how to add JavaScript see:
+// https://prototype-kit.service.gov.uk/docs/adding-css-javascript-and-images
+//
+
+window.GOVUKPrototypeKit.documentReady(() => {
+  // Add JavaScript here
+})

app/assets/sass/application.scss

@@ -0,0 +1,6 @@
+//
+// For guidance on how to add CSS and SCSS see:
+// https://prototype-kit.service.gov.uk/docs/adding-css-javascript-and-images
+// 
+
+// Add extra styles here

app/config.json

@@ -0,0 +1,3 @@
+{
+  "serviceName": "Service name goes here"
+}

app/data/session-data-defaults.js

@@ -0,0 +1,5 @@
+module.exports = {
+
+  // Insert values here
+
+}

app/filters.js

@@ -0,0 +1,9 @@
+//
+// For guidance on how to create filters see:
+// https://prototype-kit.service.gov.uk/docs/filters
+//
+
+const govukPrototypeKit = require('govuk-prototype-kit')
+const addFilter = govukPrototypeKit.views.addFilter
+
+// Add your filters here

app/routes.js

@@ -0,0 +1,49 @@
+//
+// For guidance on how to create routes see:
+// https://prototype-kit.service.gov.uk/docs/create-routes
+//
+
+const govukPrototypeKit = require('govuk-prototype-kit')
+const router = govukPrototypeKit.requests.setupRouter()
+
+// Find an address plugin
+const findAddressPlugin = require("find-an-address-plugin");
+
+findAddressPlugin(router);
+
+// Logging session data  
+// This code shows in the terminal what session data has been saved.
+router.use((req, res, next) => {    
+    const log = {  
+      method: req.method,  
+      url: req.originalUrl,  
+      data: req.session.data  
+    }  
+    console.log(JSON.stringify(log, null, 2))  
+   
+  next()  
+})  
+
+// This code shows in the terminal what page you are on and what the previous page was.
+router.use('/', (req, res, next) => {  
+    res.locals.currentURL = req.originalUrl; //current screen  
+    res.locals.prevURL = req.get('Referrer'); // previous screen
+  
+  console.log('folder : ' + res.locals.folder + ', subfolder : ' + res.locals.subfolder  );
+  
+    next();  
+  });
+
+  // Routing for the example journey. 
+  router.post('/country-answer', function(request, response) {
+
+    var country = request.session.data['country']
+    if (country == "England"){
+        response.redirect("example/complete")
+    } else {
+        response.redirect("example/ineligible")
+    }
+})
+
+
+  // Add your routes here

app/views/example/complete.html

@@ -0,0 +1,42 @@
+{% extends "layouts/main.html" %}
+
+{% block pageTitle %}
+  Confirmation page template – {{ serviceName }} – GOV.UK Prototype Kit
+{% endblock %}
+
+{% block content %}
+
+  <div class="govuk-grid-row">
+    <div class="govuk-grid-column-two-thirds">
+
+      {{ govukPanel({
+        titleText: "Application complete",
+        html: "Your reference number<br><strong>HDJ2123F</strong>"
+      }) }}
+
+      <p>
+        We have sent you a confirmation email.
+      </p>
+
+      <h2 class="govuk-heading-m">
+        What happens next
+      </h2>
+
+      <p>
+        We've sent your application to Hackney Electoral Register Office.
+      </p>
+
+      <p>
+        They will contact you either to confirm your registration, or to ask for more information.
+      </p>
+      <p>
+        <a href="#">
+          What did you think of this service?
+        </a> (takes 30 seconds)
+      </p>
+
+
+    </div>
+  </div>
+
+{% endblock %}

app/views/example/ineligible.html

@@ -0,0 +1,10 @@
+{% extends "layouts/main.html" %}
+
+{% block pageTitle %}
+  GOV.UK page template – {{ serviceName }} – GOV.UK Prototype Kit
+{% endblock %}
+
+{% block content %}
+
+
+{% endblock %}

app/views/example/where-do-you-live.html

@@ -0,0 +1,60 @@
+{% extends "layouts/main.html" %}
+
+{% block pageTitle %}
+  GOV.UK page template – {{ serviceName }} – GOV.UK Prototype Kit
+{% endblock %}
+
+{% block content %}
+
+{% from "govuk/components/back-link/macro.njk" import govukBackLink %}
+{% from "govuk/components/radios/macro.njk" import govukRadios %}
+{% from "govuk/components/button/macro.njk" import govukButton %}
+
+{% block beforeContent %}
+
+{% endblock %}
+
+
+  <div class="govuk-grid-row">
+    <div class="govuk-grid-column-two-thirds">
+<form class="form" action="/country-answer" method="post">
+
+{{ govukRadios({
+  name: "country",
+  value: data['country'],
+  fieldset: {
+    legend: {
+      text: "Where do you live?",
+      isPageHeading: true,
+      classes: "govuk-fieldset__legend--l"
+    }
+  },
+  items: [
+    {
+      value: "England",
+      text: "England"
+    },
+    {
+      value: "Scotland",
+      text: "Scotland"
+    },
+    {
+      value: "Wales",
+      text: "Wales"
+    },
+    {
+      value: "Northern Ireland",
+      text: "Northern Ireland"
+    }
+  ]
+}) }}
+
+{{ govukButton({
+  text: "Continue"
+}) }}
+
+</form>
+    </div>
+  </div>
+{% endblock %}
+

app/views/index.html

@@ -0,0 +1,25 @@
+{% extends "layouts/main.html" %}
+
+{% set pageName="Home" %}
+
+{% block content %}
+
+<div class="govuk-grid-row">
+  <div class="govuk-grid-column-two-thirds">
+
+    {% include "govuk-prototype-kit/includes/homepage-top.njk" %}
+
+    <h1 class="govuk-heading-xl">
+      {{ serviceName }}
+    </h1>
+
+
+      {{ govukButton({
+          text: "Continue",
+          href: "example/where-do-you-live"
+        }) }}
+    {% include "govuk-prototype-kit/includes/homepage-bottom.njk" %}
+  </div>
+</div>
+
+{% endblock %}

app/views/layouts/main.html

@@ -0,0 +1,6 @@
+{#
+For guidance on how to use layouts see:
+https://prototype-kit.service.gov.uk/docs/how-to-use-layouts
+#}
+
+{% extends "govuk-prototype-kit/layouts/govuk-branded.njk" %}