Interactive State Water Plan (ISWP) 2017
Web application for the 2017 Texas State Water Plan.
- Install Node >=8.9.2
- Install AWS Command Line Interface and configure with AWS credentials (IAM Key, Secret, Region). http://docs.aws.amazon.com/cli/latest/userguide/installing.html
- Install Yarn >=1.1
- Download a copy of the water plan data sqlite3 database (https://s3.amazonaws.com/tnris-misc/iswp/2017/cache.db) and place it at
- Install dependencies: cd into
- Install the custom Webfont by following the instructions in 'Webfont' section below
Download a copy of the licensed web font we are using from S3 at tnris-misc/iswp/2017/gill-sans.zip and unzip the contents to app/public/static/webfonts/ (this requires credentials to our S3 bucket). If you are using a fork of this you can just remove the custom font usage in
layout.swig and in
This command should do it for you (requires aws cli and credentials): cd into
./src and run
aws s3 cp s3://tnris-misc/iswp/2017/gill-sans.zip gill-sans.zip; unzip gill-sans.zip -d app/public/static/webfonts/; rm gill-sans.zip
All commands run from src directory:
cd src from project root
Upon the first local build, errors on startup may be related to the initial webpack assests not existing yet. If you encounter errors on the initial build, try running
yarn run webpack and then continue to run the commands below.
yarn run dev-startin a terminal to continuously build client-side scripts and css and serve the application
yarn testto run the test scripts
npm install --productionto install dependencies
npm run webpackto build production client side assets
- Run the application with
npm start. You can optionally set the
APP_PORTenvironment variable to specify the port to listen to, otherwise 3333 will be used.
You can also build and run the app with
NODE_ENV set to "staging" to make a version that serves a non-indexed robots.txt and does not use the production Google Analytics code. Otherwise follow the Production steps from above.