create-bridgething 0.12.0 → 0.14.0

package/template/settings/main.tsx

@@ -1,103 +1,61 @@
-import { settings, type ConfigField, type SettingsContext } from '@bridgething/client/settings';
-import { render } from 'preact';
-import { useEffect, useState } from 'preact/hooks';
+import { ConfigForm, closeSettings, type ConfigFormHandle } from '@bridgething/client/form';
+import { settings, type SettingsContext } from '@bridgething/client/settings';
+import { useEffect, useRef, useState } from 'react';
+import { createRoot } from 'react-dom/client';
 import './style.css';
 
-function fieldMeta(field: ConfigField): { key: string; label: string } {
-  return { key: field.data.key, label: field.data.label };
-}
-
 function Settings() {
+  const form = useRef<ConfigFormHandle>(null);
   const [ctx, setCtx] = useState<SettingsContext | null>(null);
-  const [fields, setFields] = useState<ConfigField[]>([]);
-  const [values, setValues] = useState<Record<string, string>>({});
   const [status, setStatus] = useState('');
 
   useEffect(() => {
-    (async () => {
-      try {
-        setCtx(await settings.context());
-        const [schema, entries] = await Promise.all([settings.config.fields(), settings.config.list()]);
-        setFields(schema);
-        setValues(Object.fromEntries(entries.map(e => [e.key, e.value])));
-      } catch (err) {
-        setStatus(err instanceof Error ? err.message : String(err));
-      }
-    })();
+    settings.context().then(setCtx, (err: unknown) => setStatus(errText(err)));
+    return settings.onRefresh(setCtx);
   }, []);
 
-  async function saveConfig(event: Event) {
-    event.preventDefault();
-    setStatus('saving...');
+  async function saveToDevice() {
+    setStatus('writing to device...');
     try {
-      for (const field of fields) {
-        const { key } = fieldMeta(field);
-        await settings.config.set(key, values[key] ?? '');
-      }
-      setStatus('settings saved');
+      const values = await form.current?.flush();
+      await settings.doc.set('preferences', JSON.stringify({ values, savedAt: Date.now() }));
+      setStatus('synced a preferences doc to the device');
     } catch (err) {
-      setStatus(err instanceof Error ? err.message : String(err));
+      setStatus(errText(err));
     }
   }
 
-  async function saveToDevice() {
-    setStatus('writing to device...');
+  async function close() {
     try {
-      await settings.doc.set('preferences', JSON.stringify({ values, savedAt: Date.now() }));
-      setStatus('synced a preferences doc to the device');
+      await closeSettings(form.current);
     } catch (err) {
-      setStatus(err instanceof Error ? err.message : String(err));
+      setStatus(errText(err));
     }
   }
 
   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.name} ${ctx.version}` : 'connecting to the companion host...'}</p>
 
-      <form onSubmit={saveConfig}>
-        {fields.length === 0 && <p class="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 });
-          return (
-            <div class="field" key={key}>
-              <label for={key}>{label}</label>
-              {field.type === 'enum' ? (
-                <select id={key} value={value} onInput={onInput}>
-                  {field.data.choices.map(choice => (
-                    <option value={choice} key={choice}>
-                      {choice}
-                    </option>
-                  ))}
-                </select>
-              ) : (
-                <input
-                  id={key}
-                  type={field.type === 'number' ? 'number' : field.type === 'secret' ? 'password' : 'text'}
-                  value={value}
-                  onInput={onInput}
-                />
-              )}
-            </div>
-          );
-        })}
+      <ConfigForm ref={form} />
 
-        <div class="row">
-          <button type="submit">Save settings</button>
-          <button type="button" class="secondary" onClick={saveToDevice}>
-            Save to device
-          </button>
-          <button type="button" class="secondary" onClick={() => settings.done()}>
-            Done
-          </button>
-        </div>
-      </form>
+      <div className="row">
+        <button type="button" onClick={saveToDevice}>
+          Save to device
+        </button>
+        <button type="button" className="secondary" onClick={close}>
+          Done
+        </button>
+      </div>
 
-      <p class="status">{status}</p>
+      <p className="status">{status}</p>
     </main>
   );
 }
 
-render(<Settings />, document.getElementById('root')!);
+function errText(err: unknown): string {
+  return err instanceof Error ? err.message : String(err);
+}
+
+createRoot(document.getElementById('root')!).render(<Settings />);

package/template/settings/style.css

@@ -1,14 +1,14 @@
 :root {
-  color-scheme: light dark;
-  font-family:
-    system-ui,
-    -apple-system,
-    sans-serif;
+  color-scheme: var(--bt-scheme);
 }
 
 body {
   margin: 0;
   padding: 20px;
+  background: var(--bt-color-bg);
+  color: var(--bt-color-fg);
+  font-family: var(--bt-font-body);
+  font-size: var(--bt-text-body);
   line-height: 1.5;
 }
 
@@ -18,68 +18,50 @@ main {
 }
 
 h1 {
-  font-size: 1.25rem;
-  margin: 0 0 0.25rem;
-}
-
-.hint {
-  opacity: 0.7;
-  font-size: 0.85rem;
-  margin: 0 0 1.25rem;
-}
-
-.field {
-  display: flex;
-  flex-direction: column;
-  gap: 4px;
-  margin-bottom: 14px;
-}
-
-.field label {
-  font-size: 0.85rem;
+  font-family: var(--bt-font-display);
+  font-size: var(--bt-text-title);
   font-weight: 600;
+  margin: 0 0 4px;
 }
 
-.field input,
-.field select {
-  padding: 8px 10px;
-  font-size: 1rem;
-  border: 1px solid color-mix(in srgb, currentColor 25%, transparent);
-  border-radius: 8px;
-  background: transparent;
-  color: inherit;
+.hint {
+  color: var(--bt-color-muted);
+  font-family: var(--bt-font-mono);
+  font-size: var(--bt-text-hint);
+  margin: 0 0 20px;
 }
 
 .row {
   display: flex;
-  gap: 10px;
+  gap: 12px;
   align-items: center;
-  margin-top: 8px;
+  margin-top: 16px;
 }
 
-button {
-  padding: 9px 16px;
-  font-size: 0.95rem;
-  font-weight: 600;
-  border: none;
-  border-radius: 8px;
-  background: #00a8e8;
-  color: #06232e;
+.row button {
+  padding: 10px 16px;
+  font-family: var(--bt-font-mono);
+  font-size: var(--bt-text-body);
+  border: 1px solid var(--bt-color-accent);
+  border-radius: 0;
+  background: var(--bt-color-accent-soft);
+  color: var(--bt-color-fg);
   cursor: pointer;
 }
 
-button.secondary {
-  background: color-mix(in srgb, currentColor 12%, transparent);
-  color: inherit;
+.row button.secondary {
+  border-color: var(--bt-color-edge);
+  background: none;
 }
 
-button:disabled {
+.row button:disabled {
   opacity: 0.5;
   cursor: default;
 }
 
 .status {
-  font-size: 0.85rem;
-  opacity: 0.8;
+  color: var(--bt-color-muted);
+  font-family: var(--bt-font-mono);
+  font-size: var(--bt-text-hint);
   min-height: 1.2em;
 }

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.config.ts

@@ -3,14 +3,11 @@ import react from '@vitejs/plugin-react';
 import { defineConfig } from 'vite';
 import { bridgething, daemonProxy } from './scripts/bridgething';
 
-export default defineConfig(async () => ({
+export default defineConfig(async ({ command }) => ({
   plugins: [react(), tailwindcss(), bridgething()],
   build: {
     target: 'es2022',
     sourcemap: true,
   },
-  server: {
-    host: true,
-    proxy: await daemonProxy(),
-  },
+  server: command === 'serve' ? { host: true, proxy: await daemonProxy() } : {},
 }));

package/template/vite.settings.config.ts

@@ -12,7 +12,7 @@ function sizeGuard(): Plugin {
   return {
     name: 'settings-size-guard',
     closeBundle() {
-      const out = resolve(__dirname, 'dist', 'settings.html');
+      const out = resolve(import.meta.dirname, 'dist', 'settings.html');
       let bytes: number;
       try {
         bytes = statSync(out).size;
@@ -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}).`);
       }
     },
   };
@@ -42,12 +42,13 @@ function sizeGuard(): Plugin {
 export default defineConfig({
   root: 'settings',
   plugins: [preact(), viteSingleFile(), sizeGuard()],
+  resolve: { dedupe: ['preact'] },
   build: {
     target: 'es2022',
-    outDir: resolve(__dirname, 'dist'),
+    outDir: resolve(import.meta.dirname, 'dist'),
     emptyOutDir: false,
     rollupOptions: {
-      input: resolve(__dirname, 'settings', 'settings.html'),
+      input: resolve(import.meta.dirname, 'settings', 'settings.html'),
     },
   },
 });

package/template-overlay/_claude_append.md

@@ -14,7 +14,11 @@ back to the built-in overlay, the recovery path when a build misbehaves.
 The daemon prepends one global before your bundle:
 
 ```js
-window.__bridgethingOverlay = { origin: 'http://127.0.0.1:8891', surfaces: {...} };
+window.__bridgethingOverlay = {
+  origin: 'http://127.0.0.1:8891',
+  url: 'ws://127.0.0.1:8891/?scope=overlay',
+  surfaces: {...},
+};
 ```
 
 `surfaces` is the active webapp's declared profile, a boolean each for
@@ -22,16 +26,22 @@ window.__bridgethingOverlay = { origin: 'http://127.0.0.1:8891', surfaces: {...}
 only the surfaces set to true; an app that draws its own volume indicator
 declares `volume: false`. When every surface is false the daemon injects nothing.
 
-`origin` is the kiosk origin. Compare `location.origin` against it before
-mounting. Everything else comes from `@bridgething/client` over the local
-websocket.
+`url` is the socket to hand `@bridgething/client`. Always use it rather than
+building one from `location`, because the kiosk can be showing a dev server or
+an external page whose host is not the daemon. That socket is scoped to your
+bundle, so `client.config` and `client.doc` read your own settings and storage
+rather than the foreground webapp's, and `client.config.onChanged` fires when a
+companion changes one of your settings.
+
+`origin` is the kiosk origin, for telling a kiosk page apart from a dev server.
 
 ### Output constraints
 
 `overlay.js` must be one self-contained file under 512 KiB. The daemon injects it
-as a script string into another app's document, so it carries its own code and
-styles and reaches nothing at runtime. `vite.overlay.config.ts` builds a single
-inlined iife; keep that shape.
+as a script string into an isolated world over another app's document, so it
+shares the DOM with that app but none of its javascript, and it carries its own
+code and styles. `vite.overlay.config.ts` builds a single inlined iife; keep that
+shape.
 
 Style `overlay/main.tsx` with tailwind classes like the rest of the project.
 `overlay/style.css` is imported with vite's `?inline`, so the compiled css mounts
@@ -40,7 +50,7 @@ into the shadow root as a string. Tailwind scans only `overlay/main.tsx`
 
 ### Keep these four from the starter
 
-1. The origin guard before mounting.
+1. The socket url from the prelude, never one built from `location`.
 2. The `__bridgethingOverlayMounted` guard, so a second injection is a no-op.
 3. The closed shadow root, which keeps your styles and the host app's apart.
 4. Escape-only key handling on the capture phase, active only while something is

package/template-overlay/overlay/main.tsx

@@ -13,7 +13,7 @@ type OverlaySurfaces = {
   volume: boolean;
 };
 
-type OverlayConfig = { origin: string; surfaces: OverlaySurfaces };
+type OverlayConfig = { origin: string; url: string; surfaces: OverlaySurfaces };
 
 declare global {
   interface Window {
@@ -209,8 +209,7 @@ function Overlay({ cfg, client }: { cfg: OverlayConfig; client: BridgethingClien
 
 function boot() {
   const cfg = window.__bridgethingOverlay;
-  if (!cfg || !location.origin.startsWith(cfg.origin)) return;
-  if (window.__bridgethingOverlayMounted) return;
+  if (!cfg || window.__bridgethingOverlayMounted) return;
   window.__bridgethingOverlayMounted = true;
 
   const mount = () => {
@@ -218,7 +217,7 @@ function boot() {
     host.style.cssText = 'position:fixed;inset:0;z-index:2147483647;pointer-events:none';
     const shadow = host.attachShadow({ mode: 'closed' });
     document.body.appendChild(host);
-    render(<Overlay cfg={cfg} client={new BridgethingClient({ url: `ws://${location.host}/` })} />, shadow);
+    render(<Overlay cfg={cfg} client={new BridgethingClient({ url: cfg.url })} />, shadow);
   };
 
   if (document.body) mount();

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

@@ -13,12 +13,12 @@ function sizeGuard(): Plugin {
     closeBundle() {
       let bytes: number;
       try {
-        bytes = statSync(resolve(__dirname, 'dist', 'overlay.js')).size;
+        bytes = statSync(resolve(import.meta.dirname, 'dist', 'overlay.js')).size;
       } catch {
         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}.`);
       }
     },
   };
@@ -28,11 +28,11 @@ export default defineConfig({
   plugins: [preact(), tailwindcss(), sizeGuard()],
   build: {
     target: 'es2022',
-    outDir: resolve(__dirname, 'dist'),
+    outDir: resolve(import.meta.dirname, 'dist'),
     emptyOutDir: false,
     cssCodeSplit: false,
     lib: {
-      entry: resolve(__dirname, 'overlay', 'main.tsx'),
+      entry: resolve(import.meta.dirname, 'overlay', 'main.tsx'),
       formats: ['iife'],
       name: '__overlay',
       fileName: () => 'overlay.js',

package/template-source/CLAUDE.md

@@ -0,0 +1,105 @@
+# 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`      |
+| Wheel click  | `keydown` key `"Enter"`               |
+| Touch        | pointer and touch events              |
+
+Make horizontal wheel scroll move through the main list and wheel click activate the selected item. 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 blob 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 `client.config` reads. The companion app edits them through `<ConfigForm/>` from `@bridgething/client/form`, on a default page when the app has no `settings` page.
+- `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` and embeds `<ConfigForm/>` for the declared fields. A button on it that acts on those fields awaits the form's `flush()` first. The companion keeps the page loaded between visits, so it rereads device state in `settings.onRefresh`. It is also where a user picks a file for the app (`settings.pick` + `settings.blob.put`), which the webapp then shows through `client.blob`.
+- `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/`. The image fronts chromium's debugging port on `bridgething.local:9222`, so it needs nothing but the device plugged in. 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