diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c5260c8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+# neovim config
+I like neovim.  
+
+## installation
+```bash
+# install neovim 0.11+
+sudo add-apt-repository ppa:neovim-ppa/unstable -y
+sudo apt update
+sudo apt install neovim
+
+# install dependencies
+sudo apt install git ripgrep build-essential nodejs npm xclip
+sudo npm install -g pyright
+
+# clone contents of this repo to ~/.config/nvim/
+git clone https://github.com/Jovan-04/neovim-config.git ~/.config/nvim
+
+# set up clipboard integrations
+printf '#!/bin/bash \nxclip -selection clipboard' | tee ~/.local/bin/pbcopy
+sudo chmod a+x ~/.local/bin/pbcopy
+printf '#!/bin/bash \nxclip -selection clipboard -o' | tee ~/.local/bin/pbpaste
+sudo chmod a+x ~/.local/bin/pbpaste
+```
+don't forget to set up an `alias nv='nvim'`
+
+## includes
+- Lazy.nvim plugin manager
+- treesitter syntax highlighting (with auto-install)
+- nvim-lspconfig
+- pyright language server
+- keybindings (mostly LSP-related)