From fb8a8773eafbfac2f92d11dc7c05bce35980081b Mon Sep 17 00:00:00 2001
From: Dave <futurechimp@users.noreply.github.com>
Date: Fri, 13 Mar 2026 13:02:16 +0000
Subject: [PATCH] Noting release scripts

---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

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