diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3bcbb5c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# matchiato
+**matchiato** is another neovim setup using lazy.vim with a custom catppuccino colour palette inspired by matcha green.
+The colour palette is based on the macchiato theme but with matcha tones which replace the text, subtext, overlay,
+surface and, base, mantle and crust colours.
+
+This branch is a more stable, portable alternative to the main branch which is more experimental and likely not to work
+across PCs. This project may change in the future to be its own repository if configured and setup properly.