Getting started with the MD iMAP basic viewer template is easy. Here will be described steps to access the code and start working with it using a commercially available Javascript IDE called Webstorm. A 30 day trial version is available for free. The are two baseline assumptions in making these suggestions:

•  	Using Microsoft Windows 7 operating system. <br>
  

•  	Fully installed Google Chrome web browser. <br>
  

To be able to fork and download the code base, you will be required to Create a GitHub Account. At this time the code is open source and freely accessible to anyone for download. Simply downloading the code files will give you access to the full directory for standing up your own project locally. Additional steps need to be taken to use the full features and workflows available in GitHub. To keep your personal code repository "linked" with the master code base you must be made a collaborator by contacting the git hub code steward at [email protected]. As a collaborator you will be given access to forking the code and receiving code updates, bug fixes, and breaking changes from the master branch, as well as allowing your extensions and custom modules to be pushed back to the main code.

GitHub offers flexibility and tools for managing a versioned code base. Please find more details of these features in the Resources for Git Hub section. Because most of GitHub's functionality relies on command line script, it is recommended that you download the GitHub Windows Client for a simple user interface for managing and syncing your code.

Forking
Once you have been granted access as a collaborator, you will be able to fork the code from Master Branch. In the upper left of the mdgio/Master page, you will see the "Fork" button. Press this and a personal repository of the code will be created in your user account on the Git Server. You can then use the "Clone in Windows" button or the GitHub Windows Client to clone the repository on your local machine. This local repository is where you will actively develop your customized application. Use the Windows Client to sync and push changes back to the Server repository when the code is stable.

To run the application from the local code repository, Internet Information Services (IIS) will need to be configured on your machine. By default, IIS is not installed on Windows 7. Please follow the steps to install IIS in Windows:

Install

1. Click Start and then click Control Panel.
   
2. In Control Panel, click Programs and then click Turn Windows features on or off.
   
3. In the Windows Features dialog box, click Internet Information Services and then click OK.
   

Create Application

1. Open IIS by serching in the Start Menu and clicking on "Internet Information Services"
2. Open the "Default Website" node in the left tree view.
3. Right Click on Default Website and select "Create Application"
4. Configure the Application. Give it the name "iMap" and navigate to the directory of the basicviewer code.
5. Click OK. The application has now been set up in IIS and you should be able to view it in a web browser at http://localhost/iMap

WebStorm is a robust and economical Javascript IDE. A 30 day free trial is available. It offers a number of different functionalities that aid in working with the iMAP codebase, including IntelliSense and full debugging features for Google Chrome and Mozilla Firefox.

•   [Install](http://www.jetbrains.com/webstorm/)
  

• Project Setup
  
• Debug