diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5df6d0c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# nixos-config
+
+NixOS configuration using a dendritic structure — `flake.nix` at the root, with modules branching out under `modules/`.
+
+```
+.
+├── flake.nix
+├── hardware-configuration.nix
+└── modules/
+    ├── browsers.nix
+    ├── gaming.nix
+    ├── packages.nix
+    ├── shell.nix
+    ├── ui.nix
+    └── ...
+```
+
+## Usage
+
+```bash
+sudo nixos-rebuild switch --flake .
+```