diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e0a673f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# NixOS & Home Manager config
+
+## Structure
+
+- **home**: Home Manager modules
+- **hosts**: Host-specific configs
+- **infra**: Terraform/OpenTofu files
+- **secrets**: Age-encrypted secrets shared between multiple hosts.
+  Host-specific secrets are stored in their own directories.
+- **system**: Base NixOS modules shared among all hosts