diff --git a/README.md b/README.md
index 0f741c5..7ed76ff 100644
--- a/README.md
+++ b/README.md
@@ -77,6 +77,28 @@ ldd target/x86_64-unknown-linux-musl/release/story-kit
 ./story-kit
 ```
 
+## Releasing
+
+Builds both macOS and Linux binaries locally, tags the repo, and publishes a Gitea release with a changelog.
+
+**One-time setup:**
+
+1. Create a Gitea API token at `https://code.crashlabs.io/user/settings/applications` (needs repository read/write)
+2. Add it to `.env` (gitignored): `GITEA_TOKEN=your_token`
+3. Ensure `cross` is installed (`cargo install cross`) and Docker is running
+
+**To release:**
+
+```bash
+make release V=0.2.0
+```
+
+This will:
+- Build macOS arm64 (native) and Linux amd64 (static musl via cross/Docker)
+- Generate a changelog from commits since the last tag
+- Tag the repo as `v0.2.0` and push the tag
+- Create a Gitea release with both binaries and the changelog attached
+
 ## Testing
 
 ### Frontend Tests