From 8db5130aff87e92bc91985f859f3802e75b5c976 Mon Sep 17 00:00:00 2001
From: SpookyJumpyBeans <116844292+SpookyJumpyBeans@users.noreply.github.com>
Date: Sat, 3 Oct 2026 23:57:47 -0400
Subject: [PATCH] Link the in-browser demo from the README

tinyquery's Pages site queries a tinydelta table under Pyodide, with a
timeline over its versions and a button that commits a new one. Note
where the demo departs from the real commit path: Pyodide has no hard
links, so it publishes with exclusive create plus copy.
---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index ae2ce78..61546b8 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,16 @@ This is the same shape as Delta Lake (log as source of truth, atomic commit, tim
 
 Sister of [tinyquery](https://github.com/SpookyJumpyBeans/tinyquery): that repo is the query engine, this one is the table format.
 
+**[Try it in your browser](https://spookyjumpybeans.github.io/tinyquery/)**: tinyquery
+queries a tinydelta table under Pyodide. Drag the timeline to read any version,
+or append a new one and watch it commit.
+
+[![The demo: a version timeline over a tinydelta table, with the query plan for the selected version](https://raw.githubusercontent.com/SpookyJumpyBeans/tinyquery/main/docs/demo.gif)](https://spookyjumpybeans.github.io/tinyquery/)
+
+Pyodide has no hard links, so the demo publishes commits with exclusive create
+plus copy instead. That only holds up because a browser tab runs one Python
+thread; everywhere else, tinydelta uses `link()` as described below.
+
 ## What works
 
 - `create` an empty table with a schema