Run the following PowerShell commands in the tools
directory, Choclatey will also be installed:
> iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))
> choco install dotnetcore-sdk
> choco install docker-desktop
> & "$Env:PROGRAMFILES\Docker\Docker\Docker for Windows.exe"
> docker-compose up -d
> choco install nodejs
> npm install -g npm
> npm install -g gulp
Run the following Bash commands in the tools
directory, Homebrew will also be installed:
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
$ brew tap caskroom/cask
$ brew cask install dotnet-sdk
$ brew cask install docker
$ open -a docker
$ docker-compose up -d
$ brew install nodejs
$ npm install -g npm
$ npm install -g gulp
- Clone the das-employer-config repository.
- Clone the das-employer-config-updater repository.
- Run in the
das-employer-config-updater
directory:
> dotnet run
- Follow the instructions to import the config from the directory that you cloned the
das-employer-config
repository to.
The two repositories above are private. If the links appear to be dead, make sure that you're logged into GitHub with an account that has access to these i.e. that you are part of the Skills Funding Agency Team organization.
Run in the src/SFA.DAS.EmployerFinance.Database
directory:
> dotnet run
- Wait until you see
[SFA.DAS.EmployerFinance.Database.Program] - Finished deploying database
in the shell window and then press Ctrl + C.
Run in the src/SFA.DAS.EmployerFinance.Web
directory:
> npm install
> dotnet dev-certs https --trust
Run in the src/SFA.DAS.EmployerFinance.Web
directory:
> dotnet run
Alternatively:
- Open
SFA.DAS.EmployerFinance.sln
in your IDE e.g. Rider, Visual Studio, Visual Studio Code etc. - Start debugging the
SFA.DAS.EmployerFinance.Web
project.
Run in the src
directory:
> dotnet test
Run in the src/SFA.DAS.EmployerFinance.Web
directory:
> gulp <task>
Task | Description |
---|---|
default |
Runs the css & js tasks. |
css |
Compiles all scss files in content/styles to wwwroot/css . |
js |
Copies all js files in node_modules/govuk-frontend to content/javascript/govuk-frontend . |
Alternatively:
- Right click
src/SFA.DAS.EmployerFinance.Web/gulpfile.js
. - Select
Tools
>Show Gulp Tasks
. - Double click
<task>
or right click<task>
then selectRun <task>
.
- Right click
src/SFA.DAS.EmployerFinance.Web/gulpfile.js
. - Select
Task Runner Explorer
. - Double click
<task>
or right click<task>
then selectRun
.
GOV.UK Frontend is included in the project using npm. There is also a direct reference in _Layout.cshtml
to a GOV.UK Frontend asset stored in the CDN. To ensure that the latest version is being used run in the src/SFA.DAS.EmployerFinance.Web
directory:
> npm outdated govuk-frontend
If an update is available then you'll see something like this:
Package Current Wanted Latest Location
govuk-frontend 2.5.0 2.5.1 2.5.1 asp.net
If no update is available then the command will complete silently. To update the package run in the src/SFA.DAS.EmployerFinance.Web
directory:
> npm update govuk-frontend
As part of the update the default gulp task will run which will:
- Compile
content/styles/govuk-frontend.scss
towwwroot/css/govuk-frontend.css
. - Copy
node_modules/govuk-frontend/all.js
tocontent/javascript/govuk-frontend/all.js
.