Frontend administration application for the digital marketplace.

• Python app, based on the Flask framework

Install Virtualenv

sudo easy_install virtualenv

Create a virtual environment

virtualenv ./venv

Activate the virtual environment

source ./venv/bin/activate

Set the required environment variables (for dev use local API instance if you have it running):

export DM_DATA_API_URL=http://localhost:5000
export DM_DATA_API_AUTH_TOKEN=<bearer_token>

Install new Python dependencies with pip

pip install -r requirements_for_test.txt

Install frontend dependencies with npm and gulp

npm install

For development usage:

npm run frontend-build:development

For production:

npm run frontend-build:production

Note: running npm run frontend-build:watch will also build the front-end code.

./scripts/run_tests.sh

To run the Admin Frontend App for local development you can use the convenient run script, which sets the required environment variables to defaults if they have not already been set:

./scripts/run_app.sh

More generally, the command to start the server is:

python application.py runserver

The admin frontend runs on port 5004. Use the app at http://127.0.0.1:5004/

To use feature flags, check out the documentation in (the README of) digitalmarketplace-utils.

NPM is used for all frontend build tasks. The commands available are:

• npm run frontend-build:development (compile the frontend files for development)
• npm run frontend-build:production (compile the frontend files for production)
• npm run frontend-build:watch (watch all frontend files & rebuild when anything changes)
• npm run frontend-install (install all non-NPM dependancies)

Note: npm run frontend-install is run as a post-install task after you run npm install.