Initial Space setup: README with OAuth config

README.md

@@ -1,12 +1,31 @@
 ---
-title: Vrom Hub
-emoji: 🏃
-colorFrom: red
-colorTo: gray
+title: "🧩 vROM Hub"
+emoji: 🧩
+colorFrom: purple
+colorTo: blue
 sdk: gradio
-sdk_version: 6.13.0
+sdk_version: "6.13.0"
 app_file: app.py
-pinned: false
+pinned: true
+hf_oauth: true
+hf_oauth_scopes:
+  - email
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🧩 vROM Hub
+
+Browse, submit, and manage [vROM](https://github.com/philsupertramp/vecdb-wasm) packages — pre-computed vector knowledge bases for in-browser semantic search.
+
+## Features
+
+- **📋 Browse** — View all published vROMs in the registry
+- **➕ Submit** — Request a new vROM from documentation URLs
+- **🔐 Admin** — Approve/reject submissions, trigger builds
+
+## How it works
+
+1. **Submit** documentation URLs via the form
+2. An **admin reviews** and approves the request
+3. The backend **chunks → embeds → builds HNSW** index
+4. The vROM is **published** to the [registry](https://huggingface.co/datasets/philipp-zettl/vrom-registry)
+5. Load it in the browser: `await memory.mount('your-vrom-id')`