sifive · Mixermachine · Dec 13, 2018 · Dec 13, 2018
diff --git a/README.md b/README.md
@@ -103,3 +103,30 @@ executable on your `PATH`.
 
 The default bootrom consists of a bootloader that loads a program off the SD
 card slot on the VC707 board.
+
+IntelliJ Setup
+-------------------------------
+This subsection will help you to setup IntelliJ.  
+The steps will describe what options you have to choose to get a hassle-free build.  
+If not otherwise stated, simply press next or hit enter in the corresponding dialog to get to the next step.  
+
+1. Select "Import project"  
+![Welcome screen](documentation/intellij-setup-01-welcome-screen.png)
+
+2. Locate the root folder of the freedom repository  
+![Folder window](documentation/intellij-setup-02-find-freedom-folder.png)
+
+3. Select sbt as a external model to import the project from  
+![Model import selection](documentation/intellij-setup-03-select-sbt-import.png)
+
+4. Check the option to use the sbt shell for build and import  
+![Project sbt setting](documentation/intellij-setup-04-import-project-source-and-sbt-settings.png)
+
+5. The IDE will open and try to import the freedom package. This will fail because IntelliJ builds all submodules with the version of the individual build.sbt file. We need to change that. Continue with the next step  
+![IDE window](documentation/intellij-setup-05-first-ide-start.png)
+
+6. Switch to the sbt shell and enter ++2.12.4  
+![IDE sbt shell window](documentation/intellij-setup-06-sbt-shell-version-setting.png)
+
+Done. IntelliJ now should be able to build the repository and show you code highlighting.  
+You might need to hit reimport in the build view which can be seen in step 5.
diff --git a/documentation/intellij-setup-01-welcome-screen.png b/documentation/intellij-setup-01-welcome-screen.png
diff --git a/documentation/intellij-setup-02-find-freedom-folder.png b/documentation/intellij-setup-02-find-freedom-folder.png
diff --git a/documentation/intellij-setup-03-select-sbt-import.png b/documentation/intellij-setup-03-select-sbt-import.png
diff --git a/documentation/intellij-setup-04-import-project-source-and-sbt-settings.png b/documentation/intellij-setup-04-import-project-source-and-sbt-settings.png
diff --git a/documentation/intellij-setup-05-first-ide-start.png b/documentation/intellij-setup-05-first-ide-start.png
diff --git a/documentation/intellij-setup-06-sbt-shell-version-setting.png b/documentation/intellij-setup-06-sbt-shell-version-setting.png