diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..31adda8840e32f0fc42ed13713feb6e81d0959e5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# Role-based Runtime Model Synchronization (Running Example)
+
+Supplementary material for the [COP 2021](https://conf.researchr.org/track/ecoop-issta-2021/ecoop-issta-2021-cop) publication *"Resolving Synchronization Conflicts in Role-based Multimodel-Synchronization Environments"* by Sebastian Ebert, Tim Kluge , Sebastian Götz, Uwe Aßmann and Christopher Werner.
+
+The repository contains the source code of a library to be used as a core for systems synchronizing heterogenous object-oriented models. 
+
+## Installation
+
+This project is based on Maven, thus building it is simple:
+
+1. clone this project into your workspace
+2. cd into the cloned project
+3. run mvn -compile
+4. run mvn -package
+
+## Setting UP IntelliJ
+
+1. Install IntelliJ's Plugin for Scala-Support
+2. Clone this maven project
+3. Import the project into IntelliJ
+4. Wait till all dependencies are downloaded / installed
+
+### Prerequisites
+
+* Java SE Development Kit 8 (minimum)
+* Maven 3.6.0 (minimum)