diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f2b069d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# zack's nixos dotfiles
+
+![image](https://github.com/zackartz/nixos-dots/assets/34588810/c8c7cee0-01f9-4e20-b166-87ef60705b5b)
+
+my customized versions of other's dotfiles
+
+major credits to [siiodmy](https://github.com/sioodmy/dotfiles) and [luckasRanarison](https://github.com/luckasRanarison/nvimrc).
+
+could not have done this without their work :)