Browser Synchronization
- 🔁 Automatic browser refresh as you edit text
- ✅ Actions synced across browsers (input, click, scroll, etc.) optional
PowerSync.mp4
Make sure Docker is installed, then run:
docker run -d --name powersync -p 8080:80 ghcr.io/explodinglabs/powersyncInsert the following snippet (generally before the </body> closing tag, in
certain cases it only works in <head>):
<script
id="powersync"
type="text/javascript"
data-events-uri=":8080/.well-known/mercure"
data-events-topic="powersync"
src="https://explodinglabs.com/powersync/powersync-0.1.1.js"
></script>Tip
Since 0.1.1, add ?sync=true to the src url to sync DOM events like input,
scroll, and clicks across browsers.
Alternative method, excluding the production domain:
<script>
if (location.hostname !== "myapp.com") {
const s = document.createElement("script");
s.id = "powersync";
s.type = "text/javascript";
s.async = true;
s.src = "https://explodinglabs.com/powersync/powersync-0.1.1.js";
s.dataset.eventsUri = ":8080/.well-known/mercure";
s.dataset.eventsTopic = "powersync";
document.head.appendChild(s);
}
</script>After building your site, notify browsers with an HTTP request:
curl -X POST http://localhost:8080/.well-known/mercure \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJtZXJjdXJlIjp7InB1Ymxpc2giOlsiKiJdfX0.PXwpfIGng6KObfZlcOXvcnWCJOWTFLtswGI5DZuWSK4' \
--data-urlencode topic=powersync \
--data-urlencode data='{"type": "refresh"}'| Type | Description |
|---|---|
| refresh | Reloads the entire page |
| css | Reloads all external stylesheets |
| js | Reloads all external JavaScript files |
Create a script:
/usr/local/bin/powersync-watch.sh
#!/bin/sh
WATCH_DIR="/path/to/watch"
inotifywait -m -r -e close_write "$WATCH_DIR" | while read -r path event file
do
curl --fail --silent --show-error \
-X POST http://localhost:8080/.well-known/mercure \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJtZXJjdXJlIjp7InB1Ymxpc2giOlsiKiJdfX0.PXwpfIGng6KObfZlcOXvcnWCJOWTFLtswGI5DZuWSK4' \
--data-urlencode topic=powersync \
--data-urlencode data='{"type": "refresh"}' \
--output /dev/null
doneCreate a service:
/etc/systemd/system/powersync-watch.service
[Unit]
Description=PowerSync file watcher
After=network.target
[Service]
ExecStart=/usr/local/bin/powersync-watch.sh
Restart=always
User=app
WorkingDirectory=/home/app
[Install]
WantedBy=multi-user.targetStart it:
sudo systemctl daemon-reload
sudo systemctl enable powersync-watch
sudo systemctl start powersync-watchThen bring up the stacks.
Start powersync (note the watch directory is in the plist file):
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.explodinglabs.powersync.watch.plistKill powersync:
launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.explodinglabs.powersync.watch.plist