installation-notes.txt

02/12/23 Darren H. Notes on how I got the (GDS v13+) repo to run on Windows after running 'npm install @hmlr/frontend'

( Re: https://hmlr-design-system.herokuapp.com/get-started/prototyping/ )

After running ... npm install @hmlr/frontend 
the 'npm run dev' command reported this error ...


sass.Exception [Error]: Can't find stylesheet to import.
  ╷
7 │ @import "./govuk-frontend/govuk/base.scss";
  │         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  ╵

AND later...

sass.Exception [Error]: Can't find stylesheet to import.
  ╷
9 │ @import "govuk-frontend/govuk/all";
  │         ^^^^^^^^^^^^^^^^^^^^^^^^^^
  ╵


To resolve this I manually edited 2 file paths: 

1).  

I edited file: workflow-prototype-v2\node_modules\@hmlr\frontend\hmlr\_base.scss

This line (path): @import "govuk-frontend/govuk/base.scss";

to: @import "node_modules/govuk-frontend/govuk/base.scss";

AND 

This line (path): $govuk-assets-path: "/govuk-frontend/govuk/assets/" !default;

to: $govuk-assets-path: "/node_modules/govuk-frontend/govuk/assets/" !default;

2). 

I edited file: workflow-prototype-v2\node_modules\@hmlr\frontend\hmlr\all.scss

This line (path): @import "govuk-frontend/govuk/all";

to: @import "node_modules/govuk-frontend/govuk/all";

----

a) I then also manually copied from a different HMLR repo (AP-PROTOTYPES) a directory ("css") of flat CSS files:
app > assets > css 
into app > assets of this repo

b) I then manually added a hardcoded link to any of the CSS files I required in the header area of my layout HTML files, e.g: 
wf_layout.html now links to fonts.css, like this: 
<link href="/public/css/font.css" rel="stylesheet" type="text/css" />

I don't know if this is the correct method? (No HMLR sass files populated the app/assets/sass when I ran npm install @hmlr/frontend )
There are no version numbers written inside the HMLR CSS files? 

----