fieldview

Precision agriculture imagery viewing application.

Development requirements assume Node, NPM and Grunt installed on your system. To install the Grunt cli

$ npm install -g grunt-cli

To install the project's dependencies and development dependencies change to the project's root directory and run

$ npm install

You can then run

$ grunt watch

And any changes you make in the src files will be compiled on the fly into the /dist/main.js file that the application uses. Newer versions of OSX may have file handle limitations which prevent the browserify task from running correctly see this for more information and a solution.

The application requires an instance of the fieldviewapi running in the background for local testing. These are referenced in the dev section of the replace task in the Gruntfile.js.

To build the application for local testing run

$ grunt dev

Run unit tests with

$ npm test

To serve the application locally I use serve. You can install it globally using

$ npm install -g serve

And run

$ serve

To run the application locally on port 3000.

To deploy to production on Amazon s3 you will need to create a .json file with your Amazon key and replace the reference in aws property of the Gruntfile.js (Do not commit this to the repository).

You can then run

$ grunt dist

Which will create a production build of the application and push it to s3 for hosting.