From c208da2ec5caeb27f7d08bc4da16120b2c6733c4 Mon Sep 17 00:00:00 2001
From: NotAShelf <raf@notashelf.dev>
Date: Wed, 8 Apr 2026 22:05:17 +0300
Subject: [PATCH] docs: initial project README

Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: I8e299612bf7afbb87d64ba098496ac536a6a6964
---
 README.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 README.md

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.