From c03978105880c06d84f061a2595f6f9a4d55676e Mon Sep 17 00:00:00 2001
From: Chris McCormick <chris@mccormick.cx>
Date: Wed, 2 Jul 2025 14:38:37 +0800
Subject: [PATCH] Document service worker usage. (#117)

---
 README.md            |  4 ++++
 doc/serviceworker.md | 26 ++++++++++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 doc/serviceworker.md

diff --git a/README.md b/README.md
index a276016..52d3130 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,10 @@ babashka or Clojure JVM):
 
 See [doc/nrepl](doc/nrepl).
 
+### Service worker
+
+See [doc/serviceworker.md](doc/serviceworker.md).
+
 ## Tasks
 
 Run `bb tasks` to see all available tasks:
diff --git a/doc/serviceworker.md b/doc/serviceworker.md
new file mode 100644
index 0000000..1048f77
--- /dev/null
+++ b/doc/serviceworker.md
@@ -0,0 +1,26 @@
+# Scittle in a service worker
+
+You can use Scittle to bootstrap a ClojureScript based service worker.
+
+Put the following code into e.g. `scittle-sw.js` to create a JavaScript based service worker, load Scittle, then fetch your script and eval it.
+
+```javascript
+importScripts("scittle.min.js");
+
+const request = await fetch("sw.cljs");
+const text = await request.text();
+const result = scittle.core.eval_string(text);
+```
+
+Then load `scittle-sw.js` in your HTML:
+
+```html
+<script>
+  if('serviceWorker' in navigator)
+    navigator.serviceWorker.register('scittle-sw.js');
+</script>
+```
+
+This will load `sw.cljs` and eval it in the context of the service worker.
+
+A ready-made example can be found at [chr15m/scittle-template-serviceworker](https://github.com/chr15m/scittle-template-serviceworker).