initial: decentralized link-sharing forum for TinyWeb

README.md

@@ -0,0 +1,25 @@
+# tinyweb-forum
+
+A decentralized link-sharing forum for [TinyWeb](https://github.com/derickfay/tinyweb). Share URLs and discuss them with other TinyWeb instances over the Reticulum mesh.
+
+## Install
+
+```bash
+pip install tinyweb-forum
+```
+
+Enable the forum in TinyWeb's customize page (`/style`).
+
+## Development
+
+```bash
+git clone https://github.com/derickfay/tinyweb-forum
+pip install -e .
+```
+
+## How it works
+
+- Each TinyWeb instance stores forum threads and posts in its own `forum.db`
+- Instances sync content with each other over RNS
+- Moderation is per-instance: block instances, mute threads, keyword filters
+- No global server, no algorithms, no tracking