diff --git a/lib/README.md b/lib/README.md
new file mode 100644
index 00000000..bb96e1b4
--- /dev/null
+++ b/lib/README.md
@@ -0,0 +1,7 @@
+# Library
+
+Some Helper functions for the project:
+
+1. `macosSystem`: A function to generate attribute set for macOS, used by `flake.nix` to reduce code duplication and make it easier to add new machines.
+2. `nixosSystem`: A function to generate attribute set for NixOS, used by `flake.nix` to reduce code duplication and make it easier to add new machines.
+