diff --git a/README.md b/README.md
index 3974e4cb8..2772fe848 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,29 @@
-Stremio - the next generation media center
-================
+# Stremio - the next generation media center
+
+![Build](https://github.com/stremio/stremio-web/workflows/Build/badge.svg?branch=development)
 
 Stremio is a modern media center that's a one-stop solution for your video entertainment. You discover, watch and organize video content from easy to install addons.
 
-![Build](https://github.com/stremio/stremio-web/workflows/Build/badge.svg?branch=development)
+## Build
+
+#### Prerequisites:
+* Node.js 10 or higher
+* yarn __configured for use with GitHub Packages__
+
+### Install dependencies:
+
+```bash
+yarn install
+```
+
+### Development:
+
+```bash
+yarn start
+```
+
+### Production:
+
+```bash
+yarn build
+```