This guidance will enable you to use DfE Frontend into the GOV Prototype Kit. It assumes you've got a working knowledge of using packages and working with code.
Follow the guidance for getting the prototype kit set up on your device before following these steps.
Install the package
DfE Frontend is available in the npm registry. You can install it using the npm install command in your terminal.
1. Install
npm install dfe-frontend-alpha
CSS, Javascript, and logo files
Add the following to the top of your application.scss file after the line
@import 'node_modules/govuk-frontend/dist/govuk/all';
2. application.scs
@import 'node_modules/dfe-frontend-alpha/packages/dfefrontend';
Javascript
You need to include the javascript reference in your main layout. Find the scripts section and replace with the following code.
3. /views/layouts/main.html
{% block scripts %}
{{ super() }}
<script src="/node_modules/dfe-frontend-alpha/dist/dfefrontend.min.js"></script>
{% endblock %}
Copy the logo files
There might not be an /app/assets/images folder, so create this first.
4. Copy image assets
From
/node_modules/dfe-frontend-alpha/packages/assets/dfe-logo.png
/node_modules/dfe-frontend-alpha/packages/assets/dfe-logo-alt.png
To
/app/assets/images
You're good to go
You will now be able to use DfE styles and components in your product.
Used correctly, this package will not interfere with govuk-
scoped styles and components. All
DfE Frontend styles are scoped to dfe-
.
Making your service look like a DfE service
There are strict rules on how your service should look, depending on where it's provided.
The following sections should be your next steps if you're providing your service on education.gov.uk.