diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..5d4b09a3e75dd17fc2dcdc8107c9d90b9d0366b2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,36 @@
+# Teckids website
+
+## How to build
+
+### Install yarn and Zola
+
+#### On Debian
+
+```
+sudo apt install cargo yarnpkg
+cargo install zola
+```
+
+#### On openSUSE Tumbleweed
+
+```shell
+sudo zypper install yarn zola
+```
+
+### Install JavaScript dependencies
+
+```shell
+yarn install
+```
+
+### Build HTML output
+
+```shell
+zola build
+```
+
+Alternatively, run local development server:
+
+```shell
+zola serve
+```