diff --git a/README.md b/README.md
index e69de29..58790a2 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,5 @@
+# My Nix Dotfiles
+
+`system` contains my system-wide configuraitons for nixos and nix-darwin. 
+
+`nixpkgs` contains userland nix configs for all my systems using home-manager, and can be installed using `nixpkgs/install.sh`, which symlinks machine configs to `$HOME/.config/nixpkgs`.
\ No newline at end of file