#Full Stack JavaScript (FSJ) for the CMV

##Introduction The Configurable Map Viewer (CMV) is a community-supported open source mapping framework. CMV works with the Esri JavaScript API, ArcGIS Server, and ArcGIS Online. Full Stack Javascript (FSJ) for the CMV provides an out-of-the-box Node.js reverse proxy to streamline CMV widget development and deployment.

##Why Do This? A reverse proxy is needed in most development environments to enable CORS. Currently, ESRI supplies proxy configurations for .Net, Java, and PHP servers. FSJ for the CMV ships with a reverse proxy, relieving the developer of the need to set up his or her own. Furthermore, it's all JavaScript, so configuring your development environment is easy.

##Getting Started

1. Ensure that you have Node.js and npm installed globally on your machine. Installing Node.js should also install npm, but it isn't a bad idea to make sure you have the most recent version of npm by running sudo npm install npm -g.
2. Clone this repository to the directory of your choice using git clone https://github.com/coshx/cmv-app.git.
3. Navigate into the cmv-app directory and run npm install. This will install the node package dependencies needed to run FSJ for the CMV.
4. Run gulp from the cmv-app directory to launch the map viewer at http://localhost:3000 and the proxy server at http://localhost:3002.
5. Point your browser to http://localhost:3000 and start tinkering!

##Configuring FSJ for the CMV

###Configuring the Backend

• To change the port that the map viewer runs on, simply change the port in the defualt task within gulpfile.js.
• To change the port that the proxy runs on, change the port in the proxy task within gulpfile.js. NOTE: This will likely cause CORS exceptions unless further configuration is done. See Configuring Reverse Proxy Rules.

###Configuring Reverse Proxy Rules

• Within ./viewer/js/config/viewer.js, a urlPrefix can be mapped to the reverse proxy's proxyUrl to avoid CORS exceptions. The proxyUrl in the proxy rules should match the URL that the proxy runs on in the gulpfile.js.

###Loading Different Maps

• Currently, FSJ for the CMV loads NOAA hurricane tracks from one of ESRI's sample servers. To change the operational layers that your map loads to one of the other maps on ESRI's servers, changing the operationalLayers within ./viewer/js/config/viewer.js will load more layers. NOTE: You may need to add a proxy rule for the server that is providing your operational layers See Configuring Reverse Proxy Rules for more information.

##Known Issues

1. Code that configures some of the dojo widgets that ESRI provides is raising a CORS exception. We have not noticed any broken functionality as a result.

##Further Documentation: Further information about the Common Map Viewer can be found in the CMV documentation. Feel free to learn more about the ESRI proxy configuration, which may be needed to replace FSJ for the CMV's Node.js proxy in production.

License

We are still determining the best license for FSJ for the CMV. Shoot us a message if you have any questions.