diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0e5dade
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# frzn.dev
+
+Hackerspace portal & our glorious homepage.
+
+## Development
+
+### Prerequisites
+
+- Node.js 22+ (any recent version should just work)
+- pnpm
+
+### Setup
+
+```bash
+# Install all dependencies
+$ pnpm install
+```
+
+### Commands
+
+```bash
+# Common tasks
+$ pnpm dev       # Start development server (http://localhost:4321)
+$ pnpm build     # Build for production
+$ pnpm preview   # Preview production build
+$ pnpm fmt       # Format code
+$ pnpm fmt:check # Check formatting
+```
+
+## Tech Stack
+
+[Astro]: https://astro.build/
+[@astrojs/node]: https://docs.astro.build/en/guides/integrations-guide/node/
+
+This site is built with [Astro], using Astro 6.x with server-side rendering
+features powered by [@astrojs/node]. The stack is relatively simple, and should
+be easily extensible without sacrificing from maintainability in the long term.