README.md

USGS Publications Warehouse User Interface

The Pubs Warehouse provides access to over 150,000 publications written by USGS scientists over the century-plus history of the bureau.

This repo contains the front-end components of the Publications Warehouse:

• server: A Flask web application that is used to create server-rendered pages
• assets: Client-side Javascript, CSS, images, etc.

This application should be built using Python 3.6 and Node.js version > 8.x.x.

Install dependencies

The repository contains a make target to configure a local development environment:

make env

To manually configure your environment, please see the READMEs of each separate project.

Development server

To run all development servers in a watch mode at the same time, use the make target:

make watch

... and to run each dev server individually:

make watch-server
make watch-assets

See the specific project READMEs for additional information.

• Flask Server README
• Assets README

Run tests

To run all project tests:

make test

Production build

make build

Clean targets

make clean      ; clean build artifacts
make cleanenv   ; clean environment configuration and build artifacts

make supports chaining targets, so you could also make clean watch, etc.