great-international-ui
Requirements
Local installation
$ git clone https://github.com/uktrade/great-international-ui
$ cd great-international-ui
$ make
Directory Forms
Form submissions are powered by directory-forms-api. Set that up locally then generate a API client here and add the following entries to your conf/.env
file.
Environment variable | Notes |
---|---|
DIRECTORY_FORMS_API_API_KEY | Populate from client access_key |
DIRECTORY_FORMS_API_SENDER_ID | Populate from client identifier |
Debugging
Setup debug environment
$ make debug
Run debug webserver
$ make debug_webserver
Run debug tests
$ make debug_test
CSS development
Requirements
$ npm install
Update CSS under version control
$ gulp sass
Rebuild the CSS files when the scss file changes
$ gulp sass:watch
Session
Signed cookies are used as the session backend to avoid using a database. We therefore must avoid storing non-trivial data in the session, because the browser will be exposed to the data.
Cookies
To be able to test cookies locally add the following to your /etc/hosts
:
127.0.0.1 int.trade.great
Then run the server and visit int.trade.great:8013