Farmdoc

A web-based analysis tool to assist farmers, academics and policymakers with understanding programs and policies surrounding the farm bill

farmdoc is a React module that renders the front end of the Farmdoc dashboard, exchange calls and data with the model backend.

Installation

1. Check that required JavaScript package manager npm and Node.js package are sucessfully installed on your computer

   npm -v and node -v

   Recommended versions to be used are: node 10.x and npm 6.x.

2. If not download Node.js package from, for example nodejs.org and install it on your system. Package manager npm is distributed with Node.js and it is automatically installed on your computer.

3. Clone the code from Farmdoc git repository.

4. In the Project window terminal run

   npm install --python=python2.7

   Note Some Node installation dependencies do not work with Python 3.x therefore users with default higher version of Python have to specify lower Python versions.

Running

1. In the Project window terminal run

   npm start

2. The dashboard should open locally at

   http://localhost:3000/

3. Follow the login instructions (using your Datawolf credentials)

Testing

npm run test

Launches the test runner in the interactive watch mode.

Building & Deploying

npm run build

Builds the app for production to the build folder.
It bundles React in production mode and optimizes the build for the best performance.

Copy the build folder to a web server to run the app

Docker Build

docker build --no-cache --build-arg REACT_APP_ENV=development --progress=plain --tag farmdoc/frontend .

REACT_APP_ENV can be localhost, development or production

Docker Run

docker run -p 3000:80 farmdoc/frontend:latest

This should run the application on http://localhost:3000/