Document browser-only TeaQL SQLite playground

README.md

@@ -1,10 +1,31 @@
 ---
-title: Browser Sqlite Playground
-emoji: 🚀
-colorFrom: red
+title: TeaQL Browser SQLite Playground
+emoji: 🫖
+colorFrom: green
 colorTo: blue
 sdk: static
+app_file: dist/index.html
 pinned: false
+license: apache-2.0
+short_description: TeaQL and SQLite, entirely in your browser.
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# TeaQL Browser SQLite Playground
+
+This playground runs entirely inside your browser:
+
+- SQLite runs as WebAssembly in a dedicated Web Worker.
+- Generated TeaQL Q APIs execute against that browser-local database.
+- Demo records are created through audited generated mutation APIs.
+- Memory mode resets on refresh and gives every visitor the same starting point.
+- Optional OPFS mode persists data within the current browser origin when the host supports it.
+- Reset drops the local schema, recreates it, and seeds the demo again.
+
+There is no application backend and no server-side business database. The
+Space only serves static HTML, JavaScript, CSS, and WASM assets. Query and
+mutation data remain in the visitor's browser.
+
+The complete source and executable browser smoke test are maintained in the
+[`teaql-ts` browser-sqlite example](https://github.com/teaql/teaql-ts/tree/main/examples/browser-sqlite).
+
+Learn more at [teaql.io](https://teaql.io/).