A Laravel Breeze scaffolding for GOV.UK Frontend.
GOV.UK Frontend contains the code you need to start building a user interface for government platforms and services.
See live examples of GOV.UK Frontend components, and guidance on when to use them in your service, in the GOV.UK Design System.
The version of GOV.UK Frontend used: 3.10.0
- Fresh install Laravel and cd to your app directory.
- Install this package via
composer require cabinetoffice/laravel-breeze-govuk-frontend --dev
. Laravel will automatically discover this package. You do not need to register the service provider. - Use
php artisan breeze:install-govuk
to install. See note about error from Laravel Breeze below. npm install && npm run dev
- You may need to carry out additional configurations and database migration depending on your set up.
php artisan serve
to run server and test.
This package installs Laravel Breeze as part of its installation. If Laravel Breeze generates error this will be flagged and installation of this package will stop.
You can ignore errors generated by Laravel Breeze and keep on installing by using --ignoreBreezeError=true
option with the install command, i.e. you would run: php artisan breeze:install-govuk --ignoreBreezeError=true
.
There are a couple of packages from us, available at https://packagist.org/packages/cabinetoffice/laravel-govuk-frontend-preset.
The package has been developed by Digital Communication, Cabinet Office and No10 Communication.
If you want to contribute, please do so with a pull request.
If you discover vulnerability with this package, please send an email to [email protected].
If you discover a security vulnerability within Laravel, please send an email to Taylor Otwell at [email protected].
Unless stated otherwise, the codebase is released for this package is under the MIT License. The licence for the GOV.UK Frontend codebase and documentation is available at: GOV.UK Frontend licence