From 972abc197bafc995f65cf3a45b1d901675be3176 Mon Sep 17 00:00:00 2001
From: Christian Cleberg <hello@cleberg.net>
Date: Sun, 2 Aug 2026 15:29:32 -0500
Subject: convert readme to nfo; relicense to 0bsd

---
 README.nfo | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 README.nfo

(limited to 'README.nfo')

diff --git a/README.nfo b/README.nfo
new file mode 100644
index 0000000..e19e76c
--- /dev/null
+++ b/README.nfo
@@ -0,0 +1,45 @@
+┌──────────────────────────────────────────────────────────────┐
+│  H U T C H - N O T I F Y                   [ KRZ ]   krz.sh  │
+└──────────────────────────────────────────────────────────────┘
+
+WHAT
+  backend for push notifications in hutch.
+
+DOES
+  - register apns device tokens
+  - store notification subscriptions
+  - poll sr.ht for changes
+  - send pushes via apns
+
+STACK
+  python (fastapi), sqlite, apns (http/2, token auth).
+
+STATUS
+  early development. current scope: device registration and a test
+  push endpoint. planned: build, ticket, and inbox notifications.
+
+RUN
+      python3.12 -m venv .venv
+      source .venv/bin/activate
+      pip install -r requirements.txt
+      uvicorn app.main:app --reload
+
+ENV
+  create .env:
+
+      API_KEY=change-me
+      DATABASE_URL=sqlite+aiosqlite:///./hutch_notify.db
+      APNS_KEY_ID=
+      APNS_TEAM_ID=
+      APNS_BUNDLE_ID=
+      APNS_PRIVATE_KEY_PATH=
+      SRHT_TOKEN=
+
+NOTES
+  - the ios app registers with apns and sends its token here.
+  - keep the apns .p8 key secure.
+  - event-driven eventually; the first version polls.
+
+┌──────────────────────────────────────────────────────────────┐
+│  krz.sh                                                      │
+└──────────────────────────────────────────────────────────────┘
-- 
cgit v1.2.3