NativeScript SimDeck Inspector

Debug-only NativeScript runtime agent for simdeck.

npm install @nativescript/simdeck-inspector

import { startSimDeckInspector } from "@nativescript/simdeck-inspector";

if (__DEV__) {
  startSimDeckInspector({
    port: 4310,
    sourceRoot: "/absolute/path/to/your/app",
  });
}

The agent connects from the simulator app to:

ws://127.0.0.1:4310/api/inspector/connect

It implements the same inspector methods used by the Swift debug framework:

• Inspector.getInfo
• View.getHierarchy
• View.get
• View.listActions
• View.perform
• View.getProperties
• View.setProperty

View.getHierarchy returns the NativeScript logical tree by default and falls back to raw UIKit when called with { "source": "uikit" }.

For Angular NativeScript apps, call startSimDeckInspector() before runNativeScriptAngularApp(). The package installs a small compatibility shim for Angular 20 dev-mode template source locations on NativeScript views. Pass sourceRoot when your framework reports project-relative source paths; SimDeck will publish absolute sourceLocation.file values for Codex context and local file:// links in the inspector panel.