deskbar

Webapps by deskbar, for the Spotify Car Thing running bridgething.

Currently one app, apps/deskbar: a BUSY Bar style status/focus/Jira-time-tracking app. See its own README for what it does, physical controls, and mock-mode development.

First run

1. Push this repo to https://github.com/jmwerk/deskbar.
2. In Settings > Pages, set the source to Deploy from a branch, branch gh-pages, folder / (root).

The catalog is published to https://jmwerk.github.io/deskbar/catalog.v1.json, which can be submitted to <bridgething.com/apps>.

Develop

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 deskbar.

Screenshot for the store listing:

bun run shot deskbar            # grabs what is on the screen, over CDP against real hardware
bun run shot deskbar --replace  # overwrite

Deskbar also keeps a hardware-independent screenshot script for CI and for seeded/backdated app states (a paused focus session, a populated Today list) — see apps/deskbar/README.md.

Add another app

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

bun run bump deskbar patch -m "Fix the wind direction arrow"
git commit -am "deskbar: 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.

bun run skills           # refresh it from the published create-bridgething
bun run skills --check   # check whether it is behind