diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..be6e8e4
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,8 @@
+# Changelog
+
+All notable changes to this dotfile repo
+
+
+### 2026-8-1
+- Added initial nvim with kickstart.nvim
+- ``./install.sh`` to symlink configs into place on a new machine
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..98f635a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# dotfiles
+
+Personal config for nvim, and others. **Arch**
+
+## Setup
+Copy from either my gitea:
+``git clone https://git.voodie.dev/voo/dotfiles.git ~/dotfiles``
+Or the github repository:
+``git clone https://github.com/voodev/dotfiles.git ~/dotfiles``
+```
+cd ~/dotfiles
+./install.sh
+```
+
+This symlinks each config to where the relevant app expects it. 
+