diff --git a/docs/dev-env-intellij.md b/docs/dev-env-intellij.md
new file mode 100644
index 00000000..423b3389
--- /dev/null
+++ b/docs/dev-env-intellij.md
@@ -0,0 +1,23 @@
+# Setting up your development environment using Intellij IDEA
+
+The Maven Alfresco SDK is designed to work well with Eclipse. This support includes the ability to import existing Alfresco projects created using the 
+Alfresco SDK.
+
+Here we assume you already have an Eclipse installation up and running, together with an available Alfresco project created using the Alfresco SDK. If you 
+don't have a project already, follow the steps in [Getting started with Alfresco SDK 4.0](getting-started.md) to learn how to quickly generate it in a few 
+easy steps.
+
+## Importing the Alfresco project into Intellij IDEA
+
+1. Starting from IntelliJ IDEA, select `File > Open` from the main menu to open the Alfresco project. Alternatively, select `Import Project` if you're running 
+IntelliJ IDEA for the first time in your development environment.
+
+![Alt text](./imgs/sdk-dev-env-intellij-import.png?raw=true "IntelliJ maven project import")
+
+2. After the project is imported, you will see a window similar to the following:
+
+![Alt text](./imgs/sdk-dev-env-intellij-finish.png?raw=true "IntelliJ maven project imported")
+
+Once this is done, the project is successfully imported in IntelliJ IDEA. 
+
+If you want more detail about how to work with the project, please visit [Working with generated projects](projects-usage.md).
diff --git a/docs/imgs/sdk-dev-env-intellij-finish.png b/docs/imgs/sdk-dev-env-intellij-finish.png
new file mode 100644
index 00000000..4572ff08
Binary files /dev/null and b/docs/imgs/sdk-dev-env-intellij-finish.png differ
diff --git a/docs/imgs/sdk-dev-env-intellij-import.png b/docs/imgs/sdk-dev-env-intellij-import.png
new file mode 100644
index 00000000..bc5173ae
Binary files /dev/null and b/docs/imgs/sdk-dev-env-intellij-import.png differ