tamer-dev-app

    Standalone Tamer4Lynx dev app — Expo Go-style QR scan and HMR for development. Not an installable npm package; it is a private workspace app in the tamer4lynx monorepo.

    What it is

    tamer-dev-app is the prebuilt native host app that runs on a physical device or simulator during development. It embeds tamer-dev-client for the launcher UI (server discovery, QR scan, recent servers, reload bridge) and connects to t4l start over WebSocket for HMR.

    Use it instead of building a full native host from scratch when you want a quick dev loop.

    Build and install

    From the repo root:

    # Android
t4l build android --install

# iOS
t4l build ios --install

# Or use the dedicated command (builds both platforms)
t4l build-dev-app
t4l build-dev-app --platform android --install
t4l build-dev-app --platform ios

    See t4l build-dev-app for flags.

    Dev workflow

    1. Start the dev server: t4l start (from your Lynx project root)
    2. Build and install the dev app on your device/simulator
    3. Open the dev app, scan the QR code, and connect — HMR is active

    Native linking

    LynxInitProcessor.swift (iOS) ships with GENERATED IMPORTS / GENERATED AUTOLINK placeholders. Run t4l link from this package directory (where tamer.config.json lives) before the first iOS build so the placeholders are filled from node_modules. In the monorepo, use npm run link:native from packages/tamer-dev-app (requires npm run build at the repo root first).

    Fresh clones must run t4l link before iOS will compile.

    official-app.json

    If an official-app.json file is present in the project root when running t4l build android, the CLI injects its contents as TAMER_DEV_CLIENT_OFFICIAL_APP_METADATA_JSON into the build environment. This is used for publishing official builds of the dev app.

    See also