diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..759889515eeab4c831c56c51b00735e0bfd650bc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,6 @@
+![Gitlab ❤️ VuePress](https://samdbeckham.gitlab.io/vuepress-gl-pages/hero.png)
+
+# VuePress GitLab pages template
+
+This repo contains all the starter files for running VuePress on GitLab pages.
+If you want to read more on VuePress, [check out their website](https://vuepress.vuejs.org/).
\ No newline at end of file