Reports · Shared client platform
Hoichoi client platform How the new native-platform architecture fits together: one SolidJS app that makes every decision and ships over the air, thin Android/iOS/TV hosts that expose OS capabilities, and the generated kwry bridge between them. Every box and arrow below links to the code that proves it.
2026-11-09 Mapped by Claude (agent) from source at a950df76e · kwry 29b36e1 Public · every page in this group shares one access rule
The one-line model
JS is the brain, native is the hands. The page (core/decisions ) decides boot, deep links, downloads, licences and billing. Native islands own OS resources and report raw facts. A single Kotlin contract (Contract.kt ) generates both sides of the bridge, so a mismatch is a build error.
24@Island interfaces
Islands in the contract
92+ 17 observations
Bridge methods
116contract.lock.json
Versioned wire names
2026-12-p50 frozen releases
Contract tag
53lines (was 999)
Phone host MainActivity
4Android · TV · iOS · macOS
Hosts
Counts are from source at a950df76e: grep -c @Method -r contract/src/commonMain and the wire names in contract.lock.json ; MainActivity length from MainActivity.kt .
The whole platform on one page Architecture System overview Open full reader ↗ Hoichoi Shared Client Platform — system overview feat/SD/native-platform @ a950df76e · one SolidJS brain, thin native hosts over the kwry bridge Viewer · phone · TV · browser · Architecture component Viewer phone · TV · browser hoichoi-web · SSR · hoichoi.tv · Architecture component hoichoi-web SSR · hoichoi.tv hoichoi-mobile · mobile.hoichoi.tv · Architecture component hoichoi-mobile mobile.hoichoi.tv TV bundles · SolidTV · tv-kit · Architecture component TV bundles SolidTV · tv-kit Solid app UI · ui · mweb · tv-kit · JavaScript (ships over the air) Solid app UI ui · mweb · tv-kit OTA shell · /boot /offline /update · JavaScript (ships over the air) OTA shell /boot /offline /update packages/core · decisions · vm · intents · JavaScript (ships over the air) packages/core decisions · vm · intents Ports (interfaces) · VmPorts · HostShell · JavaScript (ships over the air) Ports (interfaces) VmPorts · HostShell Hoichoi APIs · core · contents · licence · Architecture component Hoichoi APIs core · contents · licence shell-kwry · generated TS client · JavaScript (ships over the air) shell-kwry generated TS client Kotlin contract · 24 islands · 2026-12-p · Architecture component Kotlin contract 24 islands · 2026-12-p kwry runtime · JSON-RPC · hello · OTA store · Native app binary (store release) kwry runtime JSON-RPC · hello · OTA store Islands (KMP) · player · downloads · cast · Native app binary (store release) Islands (KMP) player · downloads · cast host-core · origins · policy · floors · Native app binary (store release) host-core origins · policy · floors Android phone · MainActivity · PhoneIslands · Native app binary (store release) Android phone MainActivity · PhoneIslands iOS host · Swift App → HoichoiHost · Native app binary (store release) iOS host Swift App → HoichoiHost Android TV · TvActivity · Architecture component Android TV TvActivity OS + SDKs · Media3 · AVPlayer · Play · Architecture component OS + SDKs Media3 · AVPlayer · Play CI gates · Gate H · Gate A · Architecture component CI gates Gate H · Gate A browser app TV SSR OTA shell decisions bootStep() HTTPS host ports generates JSON-RPC dispatch OS calls KwryApp HostIslands floors lock check JavaScript (ships over the air) Native app binary (store release) Legend Frontend Backend Cloud Security Message bus External Two boundaries matter: everything inside JavaScript ships on the next web deploy; everything inside Native app binary needs a store release. Open the interactive version for guided views, hover-to-source and focus.
Explore every component Pick any component to open its deep dive: what it is, why it is built this way, the alternatives rejected, a pinned code excerpt, what it talks to, gotchas and references.
JavaScript (ships over the air) 15
Islands (OS capabilities) 14
Who owns what Where the code lives Tree Repository layout Open full reader ↗ Where the code lives Repository layout at a950df76e (selected folders) Hoichoi.SharedClientPlatform · pnpm + Gradle monorepo · Root Hoichoi.SharedClientPlatform pnpm + Gradle monorepo apps/ · deployables · Branch apps/ deployables packages/ · shared TS layers · Branch packages/ shared TS layers apps/native/ · KMP hosts + islands · Branch apps/native/ KMP hosts + islands web · SolidStart · phone build · shell · Leaf web SolidStart · phone build · shell tv · SolidTV DOM (LG/Samsung) · Leaf tv SolidTV DOM (LG/Samsung) androidtv · tv-kit WebGL + kwry · Leaf androidtv tv-kit WebGL + kwry vidaa-tv · edge Worker · Leaf vidaa-tv edge Worker interfaces · ports + types · Leaf interfaces ports + types core · decisions · vm · intents · Leaf core decisions · vm · intents ui / mweb · views + web port bindings · Leaf ui / mweb views + web port bindings tv-kit · TV screens + ports · Leaf tv-kit TV screens + ports player · Shaka web + native bridge · Leaf player Shaka web + native bridge shell-kwry · generated kwry client · Leaf shell-kwry generated kwry client api · auth · analytics … · I/O + telemetry · Leaf api · auth · analytics … I/O + telemetry contract · @Island interfaces · schema · Leaf contract @Island interfaces · schema islands · OS capabilities (KMP) · Leaf islands OS capabilities (KMP) host-core · origins · policy · floors · Leaf host-core origins · policy · floors videoplayer-core · player-engine module · Leaf videoplayer-core player-engine module hosts/ · android · androidtv · ios · macos · Leaf hosts/ android · androidtv · ios · macos kwry (submodule) · bridge runtime + codegen · Leaf kwry (submodule) bridge runtime + codegen 20 4 7 6 Expand all pnpm workspace for apps/* and packages/* (pnpm-workspace.yaml ); Gradle KMP build under apps/native, also opened from the repo root so the IDE indexes it (settings.gradle.kts ).
How a request crosses the bridge Sequence One bridge call, end to end Open full reader ↗ One bridge call: page → island → result hostSolid().window.setOrientation({ orientation: 'landscape' }) setOrientation(p) advertised v1? fit(p) encode + call JSON-RPC frame orient.lock() result / UNAVAILABLE decodeEmpty Outcome {ok} Page side (OTA JS) Native side (app binary) Result Solid page · mweb / player · Sequence participant Solid page mweb / player gen/solid.ts · operation() + fit() · Sequence participant gen/solid.ts operation() + fit() gen/client.ts · encode · gate · Sequence participant gen/client.ts encode · gate kwry Bridge · JSON-RPC · WebMessage · Sequence participant kwry Bridge JSON-RPC · WebMessage WindowIsland · generated dispatch · Sequence participant WindowIsland generated dispatch OS · orientation lock · Sequence participant OS orientation lock Legend main request return message The page calls a generated operation; it checks the host advertised the wire in hello, encodes, sends JSON-RPC over WebMessage, and the KSP-generated dispatch calls the island. The result comes back as a typed Outcome. Deep dive: kwry bridge .
How the app starts Workflow Cold start Open full reader ↗ Cold start: host loads the shell, the shell decides Android phone; iOS follows the same steps through Update.boot 01 / Native host 02 / OTA shell (JS) 03 / App page (JS) Activity start · intent → intents buffer · Native host Activity start intent → intents buffer BundleStore · seed + 2 OTA slots · Native host BundleStore seed + 2 OTA slots refreshShell() · stage next bundle · Native host refreshShell() stage next bundle /boot · shell.hoichoi.app · OTA shell (JS) /boot shell.hoichoi.app bootStep()? · update mode · network · OTA shell (JS) bootStep()? update mode · network /update · FORCE policy · OTA shell (JS) /update FORCE policy /offline · downloads list · OTA shell (JS) /offline downloads list app.load(url) · ShellLoader only · App page (JS) app.load(url) ShellLoader only App ready · splash released · App page (JS) App ready splash released read facts online no network FORCE open seed bridge.ready serve /boot after start Legend Screen / document JS decision Gate / trust Bridge call Network fetch The host only serves the seeded shell's /boot from its bundle store. The shell's bootStep() decides update, offline or load; the host's only navigation path is ShellLoader . A newer shell is staged in the background (refreshShell ).
How playback gets a licence Sequence Playback and DRM licence Open full reader ↗ Playback + DRM licence: the page answers every key request Android Media3 path; iOS FairPlay uses the same broker session.open(Open) coordinator.open prepare(manifest) challenge bytes Effect.LicenseRequest POST challenge + token licence Command.ProvideLicense provide(id) state · QoS effects Open (JS chose rendition + DRM) Key request round-trip Playing Player (JS) · native-main.ts · Sequence participant Player (JS) native-main.ts SessionWire · contract ↔ engine · Sequence participant SessionWire contract ↔ engine SessionCoordinator · one surface · retry · Sequence participant SessionCoordinator one surface · retry Media3Engine · ExoPlayer + CDM · Sequence participant Media3Engine ExoPlayer + CDM LicenceBroker · timeout → NO_ANSWER · Sequence participant LicenceBroker timeout → NO_ANSWER Licence server · Hoichoi contents API · Sequence participant Licence server Hoichoi contents API Legend main request return security async trace message The CDM's challenge goes to the page as Effect.LicenseRequest; the page POSTs it with its own token logic (fetchPost ) and answers with Command.ProvideLicense. No answer in time fails as LICENCE_NO_ANSWER (LicenceBroker ).
How the bridge is generated Data flow One contract, two languages Open full reader ↗ One contract, generated into both languages Kotlin @Island interfaces → KSP + islandgen → Kotlin dispatch and TS client; CI fails on drift 01 / Author 02 / Generate 03 / Artifacts 04 / Consumers @Island interfaces · 24 islands · 01 / Author @Island interfaces 24 islands KSP processor · kwry bridge-gen · 02 / Generate KSP processor kwry bridge-gen islandgen · schema + TS · 02 / Generate islandgen schema + TS Kotlin dispatch · *Dispatch · Containers · 03 / Artifacts Kotlin dispatch *Dispatch · Containers schema + lock · releases · breaking.toml · 03 / Artifacts schema + lock releases · breaking.toml TS client · shell-kwry/src/gen · 03 / Artifacts TS client shell-kwry/src/gen Native hosts · install islands · 04 / Consumers Native hosts install islands CI checks · islandgenCheck · tsc · 04 / Consumers CI checks islandgenCheck · tsc Page code · hostSolid() ops · 04 / Consumers Page code hostSolid() ops annotations walk schema Kotlin code release JSON TS code compile evolution check import Legend primary data policy / PII data store data flow KSP emits the Kotlin dispatch and per-surface containers; islandgen writes the schema, the frozen release JSON and the TS client into shell-kwry/src/gen . CI fails on a stale TS client or an unapproved breaking change (breaking.toml ).
Talks to what Read next Wire protocol, hello, budgets, transports Codegen and compile-time checks OTA bundle store and trust Which islands each host installs What each host still owns Threading and scopes Apps, packages, dependency direction Where decisions live Player, telemetry, deploy and CI Challenge sizes and caps Why the page makes the call Cost of the round-trip JS fetch vs native Ktor vs media engines Every path, with the reason What could still move to JS Places the host still decides Declared-but-unused contract rows Doc and vendored-code drift