diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ab03df0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# NixOS Config
+My personal NixOS Configuration Repository
+
+This Nix flake defines NixOS configurations for two machines: creatorforge-vm and creatorforge-framework. The flake imports various external repositories to provide additional functionality, such as Home Manager, sops-nix, and disko.
+
+Here is an overview of the flake:
+
+[![built with nix](https://builtwithnix.org/badge.svg)](https://builtwithnix.org)