@@ -0,0 +1,56 @@
+# Sift
+
+Collaborative lists with real‑time voting and ranking. Create a room, share the link, add ideas, and sort them together with upvotes, downvotes, or vetoes.
+
+[](https://reuse.software/)
+[](LICENSES/AGPL-3.0-or-later.txt)
+[](LICENSES/CC0-1.0.txt)
+[](https://deno.land/)
+[](https://www.sqlite.org/)
+
+## Why Sift?
+
+- Real‑time collaboration: everyone sees changes instantly
+- Simple ranking: upvote, downvote, or veto; items auto‑sort by score
+- Veto with care: vetoed items fall to the bottom and dim
+- Bulk input: paste many lines at once; quick brainstorms welcome
+- Keyboard‑friendly: j/k navigate • 1/2/3 vote • e edit • Del delete • ? help • Ctrl/Cmd+Z undo
+- Clean UI: light/dark themes, responsive, reduced‑motion friendly
+- Easy sharing: rooms are just links; optional room titles for context
+
+## Quick start
+
+Run the server (Deno required):
+
+```bash
+deno run \
+ --allow-net=:8294 \
+ --allow-read=./static/,./lists.db,$HOME/.cache/deno/plug \
+ --allow-write=./lists.db,$HOME/.cache/deno/plug \
+ --allow-env \
+ --allow-ffi \
+ server.ts
+```
+
+Then open http://localhost:8294 in your browser.
+
+## How it works (for users)
+
+1) Create a room and share the link, or join an existing room by code
+2) Add items one‑by‑one or paste multiple lines
+3) Vote: 1 = up, 2 = down, 3 = veto; Enter also upvotes the selected item
+4) Edit or delete items inline; reset votes when starting a new round
+5) Optionally set a room title to keep context
+
+Tip: You can deep‑link into a room via `?room=CODE`.
+
+## Notes on privacy & safety
+
+- No accounts or authentication; rooms are protected only by knowing the ID
+- Treat rooms as shared spaces—don’t post sensitive information
+
+## License
+
+- Code: AGPL‑3.0‑or‑later → see [LICENSES/AGPL-3.0-or-later.txt](LICENSES/AGPL-3.0-or-later.txt)
+- Docs/assets: CC0‑1.0 → see [LICENSES/CC0-1.0.txt](LICENSES/CC0-1.0.txt)
+- This project follows [REUSE](https://reuse.software/) best practices