great-international-ui

Great International UI

---

Requirements

Python 3.6

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

node SASS gulp

$ npm install  # to install yarn
$ yarn install # use yarn for installing all other javascript dependencies

Update CSS under version control

$ make compile_css

Rebuild the CSS files when the scss file changes

$ make watch_css

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