diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b4b0799
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# nvim
+
+my neovim configuration
+
+## external dependencies
+
+- ripgrep (for telescope)
+- npm (for installing language servers and formatters)