diff --git a/README.md b/README.md
index 3879684..24c8691 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,33 @@
-

+
### Beta (β) release
-The most epic theme meet Visual Studio Code. If you have problems, first search for a similiar issue and then report a new one.
+[](https://github.com/equinusocio/vsc-material-theme/releases)
+[](https://beerpay.io/equinusocio/vsc-material-theme)
+
+The most epic theme meet Visual Studio Code. Please note that this theme is still in Beta (β) release. You can help by reporting issues [here](https://github.com/equinusocio/vsc-material-theme/issues)
+
+
+# Easy installation
+You can install this awesome theme through the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Equinusocio.vsc-material-theme).
+1. Press cmd/ctrl + P
+2. Type `ext install vsc-material-theme`
+
+
+# Activate the theme
+
+1. Press cmd/ctrl + Shift + P and type `color`, then select **Color Theme**
+2. Select `Material Theme Darker` or `Material Theme Lighter` fromt the list, then press **Enter**
+
+
+# Recommended settings for a better experience:
+
+```json
+ // Controls the font family.
+ "editor.fontFamily": "Operator Mono",
+ // Controls the line height. Use 0 to compute the lineHeight from the fontSize.
+ "editor.lineHeight": 24,
+ // Enables font ligatures
+ "editor.fontLigatures": true,
+```
\ No newline at end of file