@idosgames/app-shell

The host runtime for iDosGames composable modules. A project is one host shell plus N feature modules; this package is the shell — it owns the module registry, a shared event bus, a surface allocator, the imperative scene stage, and the React Mode Router that switches between modules.

import { createIDosGamesClient } from "@idosgames/core";
import { mountHost } from "@idosgames/app-shell";
import { modules } from "./modules";

const client = createIDosGamesClient({ titleID, buildKey });
await client.auth.loginWithDeviceID();
mountHost({ container: document.getElementById("app")!, client, modules });

mountHost renders a nav-bar when ≥2 modules register a route and mode-switches between them (only the active mode's scene is mounted and ticking). Panels registered with activeOnly: false stay visible across every mode (e.g. a shared HUD).

Modules are authored against @idosgames/module-sdk; shared React glue is @idosgames/react. React and ReactDOM are peer dependencies. See docs/composable-modules-architecture.md for the full design.