create-bridgething 0.12.0 → 0.14.0

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.14.0",
+  "@bridgething/extension": "^0.14.0",
+  "@bridgething/source": "^0.14.0",
+  "libbridgething": "0.14.0"
+}

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.