docs: add demo docs and CI deploy

Author: ClaudiuCeia

.github/workflows/deploy-demo.yml

@@ -0,0 +1,47 @@
+name: Deploy Demo (Deno Deploy)
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      ref:
+        description: "Git ref to deploy (branch, tag, or SHA)"
+        required: false
+        default: "main"
+        type: string
+
+permissions:
+  contents: read
+
+concurrency:
+  group: deploy-demo
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.release.tag_name || inputs.ref }}
+
+      - name: Setup Deno
+        uses: denoland/setup-deno@v2
+        with:
+          deno-version: v2.x
+
+      - name: Verify formatting
+        run: deno fmt --check
+
+      - name: Lint
+        run: deno lint
+
+      - name: Tests
+        run: deno task test
+
+      - name: Deploy
+        env:
+          DENO_DEPLOY_TOKEN: ${{ secrets.DENO_DEPLOY_TOKEN }}
+        run: deno deploy --config docs/deno.json --prod docs

README.md

@@ -22,6 +22,13 @@ Based on the
 ["Kind of Like That"](https://www.hackerfactor.com/blog/?/archives/529-Kind-of-Like-That.html)
 article by [Dr. Neal Krawetz](https://www.hackerfactor.com/about.php).
 
+## Demo
+
+Live demo (Deno Deploy): https://dhash.claudiuceia.deno.net/
+
+The demo source lives in `docs/` (`docs/main.tsx`, `docs/client.js`) and is
+deployed separately from the JSR package.
+
 ## Usage
 
 You can compare dhash values by simply computing the Hamming distance between

docs/README.md

@@ -0,0 +1,33 @@
+# dHash Demo (Deno Deploy)
+
+This folder contains a small, deployable demo app for the `@claudiu-ceia/dhash`
+library.
+
+- Production demo: `https://dhash.claudiuceia.deno.net/`
+- Deno Deploy config: `docs/deno.json`
+- Server: `docs/main.tsx` (SSR HTML + `/hash` API)
+- Client: `docs/client.js` (upload UI, hashing, sorting)
+
+## What It Does
+
+1. Upload up to 20 images (max 10MB each).
+2. Computes a 64-bit dHash for each image by calling `POST /hash`.
+3. Sorts images by similarity (Hamming distance) to a reference image you set by
+   clicking a card.
+
+Everything is in-memory; no persistence.
+
+## Run Locally
+
+From the repo root:
+
+```bash
+deno run -A --config docs/deno.json docs/main.ts
+```
+
+Then open `http://localhost:8000/`.
+
+## Deploy
+
+This app is intended to be deployed from CI using `deno deploy` and the
+`DENO_DEPLOY_TOKEN` secret. See `.github/workflows/deploy-demo.yml`.