create-bridgething 0.12.0 → 0.12.1

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "create-bridgething",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "type": "module",
-  "description": "Scaffold a new bridgething webapp (React + Vite + Tailwind v4)",
+  "description": "Scaffold a bridgething app source: webapps for the Spotify Car Thing, published as a catalog.v1 on GitHub Pages.",
   "license": "MIT",
   "author": "Joey Eamigh <55670930+JoeyEamigh@users.noreply.github.com> (https://github.com/JoeyEamigh)",
   "homepage": "https://bridgething.com",
@@ -14,7 +14,14 @@
   "bugs": {
     "url": "https://github.com/JoeyEamigh/bridgething/issues"
   },
-  "keywords": ["bridgething", "spotify", "car-thing", "superbird", "create", "scaffold"],
+  "keywords": [
+    "bridgething",
+    "spotify",
+    "car-thing",
+    "superbird",
+    "create",
+    "scaffold"
+  ],
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -24,7 +31,9 @@
   },
   "files": [
     "dist",
+    "template-versions.json",
     "template",
+    "template-source",
     "template-extension",
     "template-launcher",
     "template-overlay"
@@ -37,7 +46,7 @@
     "test": "bun test"
   },
   "devDependencies": {
-    "@bridgething/extension": "0.12.0",
+    "@bridgething/extension": "0.12.1",
     "@msgpack/msgpack": "^3.1.3",
     "@types/bun": "^1.4.0",
     "@types/node": "^26.1.1",

package/template/_claude/skills/bridgething/reference/develop.md

@@ -72,15 +72,16 @@ scrolling for the rotary's horizontal wheel.
 CDP input goes into the page, so the launcher gesture and browser-nav side
 effects stay out of the way.
 
-Get the app on the kiosk first with `bun run dev:device` or `bun run push`. CDP
-is served at `bridgething.local:9222`, reachable over USB:
+Get the app on the kiosk first with `bun run dev:device` or `bun run push`.
+Chromium listens on loopback, but the image proxies it, so CDP answers on
+`bridgething.local:9222` over USB:
 
 ```bash
 curl -s http://bridgething.local:9222/json/version >/dev/null && echo cdp-up
 ```
 
-Use the `webSocketDebuggerUrl` exactly as returned. It comes back as an IP rather
-than the hostname you asked for, and that address is the correct one.
+Use the `webSocketDebuggerUrl` exactly as returned. It comes back as an IP
+rather than the hostname you asked for, and that address is the correct one.
 
 Playwright's `connectOverCDP` never finishes the websocket upgrade against the
 device's embedded chromium, so drive it with a raw CDP websocket. Connect to the

package/template/_claude/skills/bridgething/reference/sdk.md

@@ -116,6 +116,19 @@ fetch and XHR. WebSocket APIs work. Plain HTTP APIs work when the server sends
 permissive CORS headers, since requests arrive with `Origin: null`. For a
 CORS-strict HTTP-only service, fetch through `client.net` instead.
 
+Write it in react like the rest of the app. `react` and `react-dom/client`
+imports, `className`, `htmlFor`, react's event types. The build runs it on
+preact through `@preact/preset-vite`, which is most of what keeps the page
+small, so keep the react-flavoured source and leave the preset alone. One
+tsconfig covers `src`, `settings` and `extension`, so `bun run typecheck`
+checks all three.
+
+Keep the page small. It builds to one self-contained HTML file, and the device
+refuses to install a bundle whose declared settings page is over 1 MiB, failing
+the whole install with an invalid-manifest error. The build warns past 200 KiB
+and again past 500 KiB. A heavy dependency in `settings/` is the usual way
+there.
+
 `client.net` tunnels HTTP, websockets, and a SOCKS proxy through the phone. The
 SOCKS proxy needs `"net.proxy"` in the manifest's `permissions`. Read the
 `NetSurface` block in the `.d.ts` for the request shapes.

package/template/package.json

@@ -7,13 +7,13 @@
     "dev": "vite",
     "dev:device": "vite --mode device",
     "build": "vite build && vite build -c vite.settings.config.ts",
+    "typecheck": "tsc --noEmit",
     "preview": "vite preview",
     "push": "bun scripts/push.ts",
     "share": "bun scripts/share.ts",
     "update": "bunx @bridgething/updater"
   },
   "dependencies": {
-    "@bridgething/client": "^0.12.0",
     "preact": "^10.29.7",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"

package/template/settings/main.tsx

@@ -1,6 +1,6 @@
 import { settings, type ConfigField, type SettingsContext } from '@bridgething/client/settings';
-import { render } from 'preact';
-import { useEffect, useState } from 'preact/hooks';
+import { useEffect, useState, type FormEvent, type InputEvent } from 'react';
+import { createRoot } from 'react-dom/client';
 import './style.css';
 
 function fieldMeta(field: ConfigField): { key: string; label: string } {
@@ -26,7 +26,7 @@ function Settings() {
     })();
   }, []);
 
-  async function saveConfig(event: Event) {
+  async function saveConfig(event: FormEvent<HTMLFormElement>) {
     event.preventDefault();
     setStatus('saving...');
     try {
@@ -53,17 +53,18 @@ function Settings() {
   return (
     <main>
       <h1>{ctx?.name ?? '__PROJECT_NAME__'} settings</h1>
-      <p class="hint">{ctx ? `${ctx.webappId} on ${ctx.deviceId}` : 'connecting to the companion host...'}</p>
+      <p className="hint">{ctx ? `${ctx.webappId} on ${ctx.deviceId}` : 'connecting to the companion host...'}</p>
 
       <form onSubmit={saveConfig}>
-        {fields.length === 0 && <p class="hint">this webapp declares no config fields yet.</p>}
+        {fields.length === 0 && <p className="hint">this webapp declares no config fields yet.</p>}
         {fields.map(field => {
           const { key, label } = fieldMeta(field);
           const value = values[key] ?? '';
-          const onInput = (e: Event) => setValues({ ...values, [key]: (e.target as HTMLInputElement).value });
+          const onInput = (e: InputEvent<HTMLInputElement | HTMLSelectElement>) =>
+            setValues({ ...values, [key]: (e.target as HTMLInputElement).value });
           return (
-            <div class="field" key={key}>
-              <label for={key}>{label}</label>
+            <div className="field" key={key}>
+              <label htmlFor={key}>{label}</label>
               {field.type === 'enum' ? (
                 <select id={key} value={value} onInput={onInput}>
                   {field.data.choices.map(choice => (
@@ -84,20 +85,20 @@ function Settings() {
           );
         })}
 
-        <div class="row">
+        <div className="row">
           <button type="submit">Save settings</button>
-          <button type="button" class="secondary" onClick={saveToDevice}>
+          <button type="button" className="secondary" onClick={saveToDevice}>
             Save to device
           </button>
-          <button type="button" class="secondary" onClick={() => settings.done()}>
+          <button type="button" className="secondary" onClick={() => settings.done()}>
             Done
           </button>
         </div>
       </form>
 
-      <p class="status">{status}</p>
+      <p className="status">{status}</p>
     </main>
   );
 }
 
-render(<Settings />, document.getElementById('root')!);
+createRoot(document.getElementById('root')!).render(<Settings />);

package/template/src/App.tsx

@@ -70,7 +70,7 @@ export default function App() {
             <div className="mt-6 flex gap-4">
               <button
                 className="border border-edge px-6 py-3 font-mono text-row text-near transition active:bg-neutral-soft"
-                onClick={() => client.player.skipPrev()}>
+                onClick={() => client.player.skipPrev({ allowSeeking: true })}>
                 ◀◀
               </button>
               <button

package/template/tsconfig.json

@@ -18,5 +18,5 @@
     "verbatimModuleSyntax": true,
     "useDefineForClassFields": true
   },
-  "include": ["src"]
+  "include": ["src", "settings", "extension"]
 }

package/template/vite.settings.config.ts

@@ -26,14 +26,14 @@ function sizeGuard(): Plugin {
             '',
             '========================================================================',
             `  settings.html is ${kib} KiB.`,
-            `  the companion hard-rejects settings pages over ${HARD_CAP} at install.`,
-            '  trim dependencies or inline assets before this page stops installing.',
+            `  the device refuses to install a bundle whose settings page is over ${HARD_CAP}.`,
+            '  trim dependencies or inline assets; the whole install fails, not just this page.',
             '========================================================================',
             '',
           ].join('\n'),
         );
       } else if (bytes > WARN_BYTES) {
-        console.warn(`settings.html is ${kib} KiB; keep it lean (install hard cap is ${HARD_CAP}).`);
+        console.warn(`settings.html is ${kib} KiB; keep it lean (install fails over ${HARD_CAP}).`);
       }
     },
   };

package/template-overlay/vite.overlay.config.ts

@@ -18,7 +18,7 @@ function sizeGuard(): Plugin {
         return;
       }
       if (bytes > WARN_BYTES) {
-        console.warn(`overlay.js is ${(bytes / 1024).toFixed(1)} KiB; the daemon ignores overlays over ${HARD_CAP}.`);
+        console.warn(`overlay.js is ${(bytes / 1024).toFixed(1)} KiB; install fails over ${HARD_CAP}.`);
       }
     },
   };

package/template-source/CLAUDE.md

@@ -0,0 +1,104 @@
+# Building bridgething webapps in this repo
+
+This repo is a bun workspace of webapps for the Spotify Car Thing, plus the pipeline that publishes them as a `catalog.v1` source on GitHub Pages. Each `apps/<slug>` is one webapp: a single page running full-screen in the chromium kiosk on the device, reaching the on-device daemon through `@bridgething/client`.
+
+## The device
+
+The screen is 800x480, landscape, and never resizes. The kiosk shows one webapp, so build in-app views rather than tabs or windows. Add an on-screen keyboard if the app needs text entry.
+
+Listen with a `keydown` handler and a `wheel` handler on `window`.
+
+| Control      | Event                                 |
+| ------------ | ------------------------------------- |
+| Preset 1-4   | `keydown` key `"1"` `"2"` `"3"` `"4"` |
+| Mode         | `keydown` key `"m"`                   |
+| Back         | `keydown` key `"Escape"`              |
+| Rotary wheel | `wheel` with horizontal `deltaX`      |
+| Touch        | pointer and touch events              |
+
+Make horizontal wheel scroll move through the main list. Five fast presses of Mode returns to the launcher.
+
+## The client
+
+```ts
+import { BridgethingClient } from '@bridgething/client';
+import { useMemo } from 'react';
+
+import { daemonUrl } from './daemon';
+
+const client = useMemo(() => new BridgethingClient({ url: daemonUrl() }), []);
+```
+
+Construct it once and reuse it. It connects and reconnects on its own. Call `daemonUrl()` instead of a literal `ws://` address.
+
+Now-playing and library data come from the phone's Spotify, so render a placeholder when no phone is connected. Fetch artwork with `client.asset.get` using the opaque id on the track.
+
+Every surface: `player asset config store doc capabilities library audio notifications phone peer geo net hardware bluetooth system time voice lyrics webapp forward`. Each method is an event, a request, or a command.
+
+Methods, types, and examples: `.claude/skills/bridgething/reference/sdk.md`. That skill lives once at the repo root and every app symlinks it, so it is one copy for the whole workspace. `bun run skills` refreshes it from the published `create-bridgething`; `bun run check` says when it is behind.
+
+## Working on one app
+
+```sh
+bun run dev                            # the only app, against a connected Car Thing
+bun run dev <slug>                     # name it when there is more than one
+bun run --cwd apps/<slug> dev          # always works
+bun run --cwd apps/<slug> dev:device   # show that server on the device's own screen
+bun run --cwd apps/<slug> push         # build and install onto the connected device
+bun run --cwd apps/<slug> build        # writes dist/
+bun run --cwd apps/<slug> typecheck    # checks src, settings and extension together
+bun run --cwd apps/<slug> share        # zips dist/ to hand to someone directly
+bun run --cwd apps/<slug> update       # brings the device to the latest bridgething release
+```
+
+An app with a variant or an extension carries its own `apps/<slug>/CLAUDE.md` with the parts specific to it.
+
+Running and driving the app: `.claude/skills/bridgething/reference/develop.md`. Push, zip, update: `.claude/skills/bridgething/reference/ship.md`. The desktop-side Deno extension and its permission model, for an app with an `extension/` directory: `.claude/skills/bridgething/reference/extension.md`.
+
+## The three files that describe an app
+
+**`apps/<slug>/public/manifest.json`** is the app's identity as far as the device and the catalog are concerned.
+
+- `id` identifies this webapp on the device. It is a uuidv7 generated once at scaffold time. **Never change it**: the device keys upgrade-in-place and the app's key-value namespace on it, so a new uuid orphans everyone's installed copy and its data.
+- `version` is what the store publishes against. Move it with `bun run bump`, never by hand.
+- `description` is the store tagline and must not be empty.
+- `config` declares the settings the companion app edits and `client.config` reads.
+- `permissions` grants `geo` and `net.proxy`.
+- `art.heroPx` and `art.thumbPx` are the sizes artwork arrives at.
+- `settings` names the page built from `settings/`, capped at 1 MiB. It talks to the companion app through `@bridgething/client/settings`.
+- `extension` declares the desktop-side Deno process and the host permissions it gets.
+
+**`apps/<slug>/catalog.json`** is the store listing and nothing else: `author`, `homepage`, `source`, an `icon` override, `screenshots`, and `min_libbridgething_version` (the oldest daemon the app works against). Never restate anything the manifest already says. An app that ships an extension must carry its `github.com` repo url in `source`, because the store shows that link next to the host permissions it is asking for.
+
+**`apps/<slug>/CHANGELOG.md`** carries a `## <version>` section per release, which becomes that version's changelog in the catalog.
+
+## Adding and shipping
+
+```sh
+bun run new <slug> [--extension | --launcher | --overlay]
+bun run shot <slug> [--replace | --name <label>]
+bun run bump <slug> <major | minor | patch | x.y.z> [-m "note"]
+bun run check
+```
+
+`new` scaffolds into `apps/<slug>`. Never add an app by hand: the scaffold generates the uuid, writes the store listing, wires the dev server to a connected device, and lands the tsconfig and scripts CI expects.
+
+`shot` captures the kiosk over CDP into `apps/<slug>/screenshots/`. Chromium's debugging port is 9223 and is bound to the device's loopback, so it goes through an ssh tunnel; the command opens and closes one itself. Up to six, filename order, first is the store card.
+
+`bump` writes `public/manifest.json` and `package.json` together and opens the changelog section. Editing one without the other fails the build.
+
+`check` is the whole gate and is exactly what CI runs: typecheck, build, bundle, generate the catalog, validate it against `catalog.v1` and the cross-reference invariants. Run it before claiming anything works.
+
+Pushing to main publishes. `bun run publish --dry-run` assembles the exact bytes that would be pushed, into `site/`, without pushing.
+
+## Publishing rules that are not negotiable
+
+- **A published version is immutable.** `published.json` on the `gh-pages` branch records the sha256 clients verify against. Changing an app means a new version, always. `check` fails a pull request that changed an app without bumping it.
+- **Bundles are reproducible.** Timestamps are flattened before zipping so the same source gives the same digest. Do not add anything nondeterministic to a build.
+- **`site/` is generated and gitignored.** Nothing about a release belongs on main.
+- **CORS is a requirement.** A source must serve its catalog and its downloads with `Access-Control-Allow-Origin: *` or browser clients cannot read it. GitHub Pages does; most self-hosting does not.
+- **`base_url` in `source.json` is where this catalog is served.** If you forked this repo, point it at your own pages site and give every app a fresh uuid, or you publish app ids that belong to someone else. `check` refuses when it disagrees with the origin remote.
+
+## Comments
+
+Terse, lowercase, self-contained, non-obvious WHY only, 120 columns. No historical cross-references, no pointers at other files, no emdashes. Most code here needs none.

package/template-source/README.md

@@ -0,0 +1,57 @@
+# **SOURCE_NAME**
+
+**SOURCE_DESCRIPTION**
+
+Webapps for the Spotify Car Thing running [bridgething](https://bridgething.com).
+
+## First run
+
+1. Push this repo to `https://github.com/__REPO_OWNER__/__REPO_NAME__`.
+2. In **Settings > Pages**, set the source to **Deploy from a branch**, branch `gh-pages`, folder `/ (root)`.
+
+The catalog is published to `__BASE_URL__/catalog.v1.json`, which can be submitted to <bridgething.com/apps>
+
+## Develop
+
+```sh
+bun run dev            # develop the app against a connected bridgething instance
+bun run dev:device     # show the dev server on the car thing screen
+bun run push           # build and install to the device
+bun run check          # ensure the catalog is valid
+```
+
+With more than one app in `apps/` your commands must specify which one: `bun run dev __APP_SLUG__`.
+
+Screenshot for the store listing:
+
+```sh
+bun run shot __APP_SLUG__            # grabs what is on the screen
+bun run shot __APP_SLUG__ --replace  # overwrite
+```
+
+## Add another app
+
+```sh
+bun run new weather                 # a webapp
+bun run new dashboard --extension   # a webapp plus a desktop-side Deno process
+bun run new home --launcher         # a replacement home screen
+bun run new hud --overlay           # a system overlay drawn over every webapp
+```
+
+## Ship
+
+```sh
+bun run bump __APP_SLUG__ patch -m "Fix the wind direction arrow"
+git commit -am "__APP_SLUG__: fix the wind direction arrow" && git push
+```
+
+Pushing to main builds the apps and regenerates the catalog.
+
+## Agent skill
+
+`.claude/skills/bridgething/` holds the `/bridgething` skill.
+
+```sh
+bun run skills           # refresh it from the published create-bridgething
+bun run skills --check   # check whether it is behind
+```

package/template-source/_bunversion

@@ -0,0 +1 @@
+1.4.0

package/template-source/_github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: ci
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version-file: .bun-version
+
+      - run: bun install --frozen-lockfile
+
+      - name: build, bundle and validate the catalog
+        env:
+          CHECK_BASE_REF: ${{ github.event_name == 'pull_request' && format('origin/{0}', github.base_ref) || '' }}
+        run: bun run check

package/template-source/_github/workflows/publish.yml

@@ -0,0 +1,33 @@
+name: publish
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: publish
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version-file: .bun-version
+
+      - run: bun install --frozen-lockfile
+
+      - name: identify the publisher
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: build every unpublished version and push the catalog
+        run: bun run publish

package/template-source/_gitignore

@@ -0,0 +1,7 @@
+node_modules
+dist
+site
+.dev-extension
+.DS_Store
+*.log
+.env*

package/template-source/_prettierrc.js

@@ -0,0 +1,10 @@
+/** @type {import("prettier").Config} */
+export default {
+  bracketSpacing: true,
+  bracketSameLine: true,
+  singleQuote: true,
+  trailingComma: 'all',
+  arrowParens: 'avoid',
+  semi: true,
+  overrides: [{ files: ['*.ts', '*.js', '*.tsx', '*.jsx', '*.cjs', '*.mjs'], options: { printWidth: 120 } }],
+};

package/template-source/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "__REPO_NAME__",
+  "private": true,
+  "type": "module",
+  "workspaces": [
+    "apps/*"
+  ],
+  "scripts": {
+    "new": "bunx create-bridgething",
+    "dev": "bridgething-source run dev",
+    "dev:device": "bridgething-source run dev:device",
+    "build": "bridgething-source run build",
+    "push": "bridgething-source run push",
+    "share": "bridgething-source run share",
+    "check": "bridgething-source check",
+    "bump": "bridgething-source bump",
+    "shot": "bridgething-source shot",
+    "catalog": "bridgething-source catalog",
+    "publish": "bridgething-source publish",
+    "skills": "bridgething-source skills",
+    "format": "prettier --write \"*.json\" \"*.js\""
+  },
+  "devDependencies": {
+    "prettier": "^3.9.6",
+    "typescript": "^6.0.3"
+  }
+}

package/template-source/source.json

@@ -0,0 +1,8 @@
+{
+  "name": "__SOURCE_NAME__",
+  "description": "__SOURCE_DESCRIPTION__",
+  "homepage": "https://github.com/__REPO_OWNER__/__REPO_NAME__",
+  "icon": null,
+  "base_url": "https://__REPO_OWNER_LOWER__.github.io/__REPO_NAME__",
+  "recommended_sources": []
+}

package/template-versions.json

@@ -0,0 +1,6 @@
+{
+  "@bridgething/client": "^0.12.1",
+  "@bridgething/extension": "^0.12.1",
+  "@bridgething/source": "^0.12.1",
+  "libbridgething": "0.12.1"
+}

package/template/CLAUDE.md

@@ -1,71 +0,0 @@
-# Building this bridgething webapp
-
-A bridgething webapp is one page running full-screen in the chromium kiosk on a
-Spotify Car Thing. It reaches the on-device daemon through `@bridgething/client`.
-
-## The device
-
-The screen is 800x480, landscape, and never resizes. The kiosk shows one webapp,
-so build in-app views rather than tabs or windows. Add an on-screen keyboard if
-the app needs text entry.
-
-Listen with a `keydown` handler and a `wheel` handler on `window`.
-
-| Control      | Event                                 |
-| ------------ | ------------------------------------- |
-| Preset 1-4   | `keydown` key `"1"` `"2"` `"3"` `"4"` |
-| Mode         | `keydown` key `"m"`                   |
-| Back         | `keydown` key `"Escape"`              |
-| Rotary wheel | `wheel` with horizontal `deltaX`      |
-| Touch        | pointer and touch events              |
-
-Make horizontal wheel scroll move through the main list. Five fast presses of
-Mode returns to the launcher.
-
-## The client
-
-```ts
-import { BridgethingClient } from '@bridgething/client';
-import { useMemo } from 'react';
-
-import { daemonUrl } from './daemon';
-
-const client = useMemo(() => new BridgethingClient({ url: daemonUrl() }), []);
-```
-
-Construct it once and reuse it. It connects and reconnects on its own. Call
-`daemonUrl()` instead of a literal `ws://` address.
-
-Now-playing and library data come from the phone's Spotify, so render a
-placeholder when no phone is connected. Fetch artwork with `client.asset.get`
-using the opaque id on the track.
-
-Every surface: `player asset config store doc capabilities library audio
-notifications phone peer geo net hardware bluetooth system time voice lyrics
-webapp forward`. Each method is an event, a request, or a command.
-
-Methods, types, and examples: `.claude/skills/bridgething/reference/sdk.md`.
-
-## `public/manifest.json`
-
-- `id` identifies this webapp on the device. Keep it.
-- `version` tells builds apart. Raise it before sharing an update.
-- `config` declares the settings the companion app edits and `client.config`
-  reads.
-- `permissions` grants `geo` and `net.proxy`.
-- `art.heroPx` and `art.thumbPx` are the sizes artwork arrives at.
-- `settings` names the page built from `settings/`, capped at 1 MiB. It talks to
-  the companion app through `@bridgething/client/settings`.
-
-## Workflow
-
-- `bun run dev` serves at `http://localhost:5173/` against the connected Car
-  Thing.
-- `bun run dev:device` shows that server on the device's own screen.
-- `bun run build` writes `dist/`.
-- `bun run push` builds and installs onto the connected device.
-- `bun run share` zips `dist/`.
-- `bun run update` brings the device to the latest bridgething release.
-
-Running and driving the app: `.claude/skills/bridgething/reference/develop.md`.
-Push, zip, update: `.claude/skills/bridgething/reference/ship.md`.

package/template/README.md

@@ -1,57 +0,0 @@
-# **PROJECT_NAME**
-
-A bridgething webapp scaffolded with `create-bridgething`. It runs full-screen in
-the chromium kiosk on a Spotify Car Thing and talks to the on-device daemon
-through [`@bridgething/client`](https://github.com/JoeyEamigh/bridgething).
-
-Stack: React 19, Vite, Tailwind v4, TypeScript strict.
-
-Open this folder with your coding agent. It reads `CLAUDE.md` or `AGENTS.md` and
-the `/bridgething` skill.
-
-## Develop
-
-```bash
-bun install
-bun run dev
-```
-
-Vite serves at http://localhost:5173/ with hot reload, against the daemon on the
-Car Thing plugged in over USB. Set `SUPERBIRD_HOST` to target another device, or
-`BRIDGETHING_DAEMON_URL` to reach a daemon elsewhere.
-
-```bash
-bun run dev:device
-```
-
-The same server, shown on the Car Thing's own screen, hot reload included.
-Ctrl-C hands the screen back to the installed build.
-
-When the project ships an extension (`extension/main.ts`), both commands bundle
-it on every save and run it under Deno with the permissions the manifest
-declares.
-
-## Push, share, update
-
-```bash
-bun run push     # build, copy to the Car Thing, switch the kiosk to it
-bun run build
-bun run share    # write <name>-<version>.zip from dist/
-bun run update   # bring the device to the latest bridgething release
-```
-
-`push` targets `bridgething.local` over USB; pass a host or IP address for
-another device. Anyone with a bridgething Car Thing installs the zip from the
-companion app. For one device out of several,
-`bun run update -- --host ws://bridgething-<serial>.local:8892/`.
-
-## Layout
-
-- `src/App.tsx` subscribes to `client.player.onSnapshot`, fetches artwork through
-  `client.asset.get`, and draws transport controls.
-- `src/daemon.ts` returns the daemon URL.
-- `public/manifest.json` carries the webapp id, version, config schema, and
-  permissions.
-- `settings/` is the settings page the companion app renders, built to
-  `dist/settings.html`.
-- `index.html` and `vite.config.ts` fix the 800x480 viewport and the build target.