Skip to content

uk-gov-mirror/SkillsFundingAgency.das-employerfinance

 
 

Repository files navigation

SFA.DAS.EmployerFinance

Build status

Requirements

  1. Install .NET Core.
  2. Install Docker.
  3. Install Node.
  4. Install Npm.
  5. Install Gulp.

Windows

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

macOS

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

Setup

Add configuration

> 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.

Add database

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.

Add packages

Run in the src/SFA.DAS.EmployerFinance.Web directory:

> npm install

Add certificates

> dotnet dev-certs https --trust

Run

Run in the src/SFA.DAS.EmployerFinance.Web directory:

> dotnet run

Alternatively:

Test

Run in the src directory:

> dotnet test

Gulp tasks

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:

Rider

  • Right click src/SFA.DAS.EmployerFinance.Web/gulpfile.js.
  • Select Tools > Show Gulp Tasks.
  • Double click <task> or right click <task> then select Run <task>.

Visual Studio

  • Right click src/SFA.DAS.EmployerFinance.Web/gulpfile.js.
  • Select Task Runner Explorer.
  • Double click <task> or right click <task> then select Run.

GOV.UK Frontend

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 to wwwroot/css/govuk-frontend.css.
  • Copy node_modules/govuk-frontend/all.js to content/javascript/govuk-frontend/all.js.

Architecture

Levy Declaration Saga

Levy Declaration Saga Architecture

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 54.4%
  • CSS 19.9%
  • JavaScript 14.3%
  • HTML 6.7%
  • SCSS 2.5%
  • TSQL 2.0%
  • Other 0.2%