From 41f8d3025f041aaab98fcc3511cb6ec2198f76a7 Mon Sep 17 00:00:00 2001
From: Ahmed <git@gumx.cc>
Date: Sun, 14 Jun 2026 01:49:48 +0300
Subject: init: vibed

---
 web/README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 web/README.md

(limited to 'web/README.md')

diff --git a/web/README.md b/web/README.md
new file mode 100644
index 0000000..50e8cef
--- /dev/null
+++ b/web/README.md
@@ -0,0 +1,46 @@
+# ugi.gumx.cc
+
+Web-based UGI (Unified Geek Identifier) encoder, decoder, and format converter.
+
+## What is this?
+
+A self-contained HTML tool for working with UGI strings — the modernized Geek Code. It provides three functions:
+
+- **Encoder** — form-based interface to build a UGI string by selecting fields, sub-IDs, and ratings
+- **Decoder** — paste a UGI string (URI or block format) and see a human-readable breakdown
+- **Converter** — convert between URI format (`ugi:0@handle:...`) and block format
+
+The tool is a single HTML file with no external dependencies. The full UGI registry is embedded inline.
+
+## Usage
+
+Open `index.html` in any browser. No server required.
+
+Supports `prefers-color-scheme` for automatic dark mode.
+
+## Regenerating
+
+The generator script takes the registry JSON path and output file path as arguments:
+
+```bash
+python scripts/gen_tool.py /path/to/ugi_registry_v0.json index.html
+```
+
+### Requirements
+
+- Python 3.8+
+- No external dependencies
+
+## Project structure
+
+```
+ugi.gumx.cc/
+├── index.html       # generated tool (deploy this)
+├── scripts/
+│   └── gen_tool.py  # HTML tool generator
+└── README.md
+```
+
+## License
+
+MIT
-- 
cgit v1.2.3