How to Setup WISE: Local Development Environment using IntelliJ IDEA

(Note: These instructions require an installation of IntelliJ IDEA Ultimate Edition, since it makes use of the Maven, Spring, Hibernate, and Tomcat modules)

Initial Steps

1. Check out WISE Project
   1. Open IntelliJ.
   2. Go to New -> Project from Version Control -> Git
   3. For "URL", type "https://github.com/WISE-Community/WISE.git". For "Directory", choose a location where you want to checkout the project.
   4. Hit "clone".
   5. Follow the rest of the instructions. Choose default settings (no need to specify anything) when prompted. When finished, IntelliJ should open the WISE project in the Project Browser window (usually on the left-hand side). It might take a while for IntelliJ to index the files.
2. Right click on pom.xml file and choose "Add as Maven Project". This will make WISE into a Maven project, download maven dependencies, and re-organize the folders.
3. Configure settings
   1. Copy src/main/resources/wise_sample_embedded_tomcat.properties to src/main/resources/wise.properties
   2. Edit src/main/resources/wise.properties IF NEEDED (you probably won't need to edit anything, but if you run into issues in the future, this may be a place to look)
4. Add Run Configuration to IntelliJ
   1. Click on "Add Configuration" button at the top-right corner of the IntelliJ window. This will open up the Run/Debug Configuration window.
   2. In the window, click on the "+" button to create a new configuration.
   3. Choose "Maven" in the list of possible configurations
   4. Change the name to: "WISE Maven".
   5. Change the "Command line" to: "tomcat7:run"
   6. Click "OK" to save and close the window. You should now see "WISE Maven" in the top-right corner of IntelliJ and the Run/Debug buttons should be enabled.

Running/Debugging WISE

1. Click on the Run/Debug button in the top-right corner of the IntelliJ window.
2. Open up the Terminal and run "npm run watch-all-site" to compile the site