diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..4aab771
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,20 @@
+# plcom
+
+my website
+
+http://philippeloctaux.com
+
+## tech
+
+- https://astro.build
+- https://tailwindcss.com
+
+## wallpapers
+
+1. place **JPEG** files in `public/wallpapers` and make sure they have exif data (GPS + date)
+2. install https://deno.land and run `npm run wallpapers` to generate wallpaper metadata
+
+## icons
+
+- https://simpleicons.org for brand icons
+- https://heroicons.com for the rest
\ No newline at end of file