@condorinst/mobile-bridge
The SDK for the Home of the Condor Canvas app: a self-contained web page
that the app shows inside a sandboxed iframe after login. The page talks to the
app — device list, live light readings, history, permissions, language, and a
cache on the phone for what must survive a restart — with BridgeClient, and
the package's CLI builds, checks, tests and publishes it.
Building a Home — person or AI agent
Start at AGENTS.md: the rules, the boot sequence to copy, the
browser harness, the validation loop, and which document owns each subject. It
is written once for both audiences.
Everything ships inside the npm tarball, so after npm install it is on disk at
node_modules/@condorinst/mobile-bridge/, readable with no network. Over the
network, every document is plain text at a pinned, unauthenticated URL;
llms.txt is the index and llms-full.txt has every document in one file:
https://cdn.jsdelivr.net/npm/@condorinst/[email protected]/llms.txt
https://cdn.jsdelivr.net/npm/@condorinst/[email protected]/llms-full.txt
The machine-readable contract — keys, commands, limits, capability matrix — is
contract/bridge-contract.json, importable as
@condorinst/mobile-bridge/contract.
Note for fetchers: the Bitbucket repository landing page is a JavaScript application and returns no readable text. Use the jsDelivr URLs above, or Bitbucket's
raw/file URLs.
Installation
npm install @condorinst/mobile-bridge@^0.27.0
The package ships a prebuilt dist/ (ESM + CJS + type declarations); no build
toolchain of ours is needed on your side.
The CLI
| Command | Does | Documented in |
|---|---|---|
npx condor-mobile-bridge dev -i dist/index.html | runs your page in a browser harness that behaves like the app, inside a phone or tablet frame (--device) | docs/device-testing.md |
npx condor-mobile-bridge build -i dist/index.html -o dist/bundle.zip | inlines your build into one index.html and zips it | docs/device-testing.md |
npx condor-mobile-bridge validate -i dist/bundle.zip --strict | applies the app's gates and lints for blocked APIs | docs/device-testing.md |
npx condor-mobile-bridge canvas publish | list | revoke | publishes your bundle to your company (interactive login) | docs/device-testing.md |
Versioning policy (semver)
- PATCH (
0.23.x): bugfix with no API change. - MINOR (
0.x.0): new observable key, new command, backward-compatible API.While on
0.x, a minor bump may carry breaking changes (semver treats pre-1.0 minors as breaking). Pin^0.27.0to stay on safe patches. - MAJOR (
x.0.0): incompatible schema change (key rename, payload shape change, public API change).1.0.0marks the production-stable contract.
The native side declares nativeVersion in the handshake; the client
declares clientVersion. This release does not enforce hard semver
validation — the native side accepts any clientVersion. Real validation will
land once there are 2+ versions in the field.
Shell side (Condor)
BridgeShell, the legacy Bridge singleton, mock mode and the dev panel are
for Condor's app shell, not for client bundles:
docs/shell-integration.md.
Local development (SDK contributors)
npm install # installs deps + runs prepare (build)
npm run typecheck # tsc --noEmit
npm run lint # biome check
npm run format # biome format --write
npm run test # vitest run
npm run build # tsup (ESM + CJS + types in dist/)
License
Proprietary — Condor Instruments. See LICENSE.