diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..9db85ef
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,10 @@
+# brunc
+
+This is the repository that powers the https://brunc.io/ page.
+
+It's written with Astro, with some bits of Svelte and custom dirty JavaScript.
+It sort of works and it's published to Vercel.
+
+If you find any issues or have any improvement suggestions, your comments are welcome.
+
+Peace!
\ No newline at end of file