diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7716705
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# dotfiles
+
+My personal dotfiles, originally for macOS only but currently being adapted for use on Linux based systems (Ubuntu and Pop!_OS in particular) where needed.
+
+## Attribution
+
+Inspired in part by similar repositories by [Chris Toomey][], [Gabe Berke-Williams][], [Jeff Geerling][] and others.
+
+[chris toomey]: https://github.com/christoomey/dotfiles
+[gabe berke-williams]: https://github.com/gabebw/dotfiles
+[jeff geerling]: https://github.com/geerlingguy/dotfiles