diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,61 @@
+# KDE Human Interface Guidelines website
+
+
+## Setup dev environment
+
+### Install virtualenv
+
+Arch Linux
+
+```
+sudo pacman -S python-virtualenv
+```
+
+Fedora
+
+```
+sudo dnf install python3-virtualenv
+```
+
+Ubuntu/Debian
+
+```
+sudo apt-get install python3-virtualenv
+```
+
+Using pip
+
+```
+pip install virtualenv
+```
+
+### Create a virtual environment
+
+```
+virtualenv -p python3 env
+source env/bin/activate
+```
+
+Install required packages
+
+```
+pip install -r requirements.txt
+```
+
+
+## Build the website
+
+Go to the directory where `Makefile` is located and run
+
+```
+make html
+```
+
+
+## Run the website
+
+Go to `build/html` directory and run a web server
+
+```
+python3 -m http.server
+```