diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f02e4d7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# matmanna.dev
+
+the latest iteration of my personal site, based on the blog theme i made for tonic, [doctored](https://doctored.matmanna.dev). the site aims to be simple, elegant, and above all - small! to accomplish all that, it currently uses jekyll, tailwind, markdown, html/js/css, goatcounter analytics, and hosted on github pages (--> cf asap). all of this allows it to serve as my main "place on the web", an active personal portfolio, and eventual blog as well.
+
+https://matmanna.dev
+
+---
+
+**attribution:**
+
+- [shymike](https://imshymike.dev) for hackatime-heatmap
+- all the people who inspired [doctored](https://doctored.matmanna.dev)
+
+i used little to no genai for the content/design of the site, but codex was shockingly super helpful for the tailwind compression functions and optimization prototypes!