Skip to content
TraceItX Docs
Documentation

Install

A JS provider over a native bridge, so the screenshot and log capture are real native captures.

Updated 

npm i @traceitx/react-native

No manual linking. Autolinking picks up the native module; run pod install for iOS as usual.

Wrap your app

import { TraceItXProvider } from '@traceitx/react-native';

export default function App() {
  return (
    <TraceItXProvider config={{ apiKey: 'txx_live_…' }}>
      <RootNavigator />
    </TraceItXProvider>
  );
}

Open the reporter

import { useTraceItX } from '@traceitx/react-native';

function ReportBugButton() {
  const { open } = useTraceItX();
  return <Button title="Report a bug" onPress={() => open()} />;
}

There is no shake gesture or floating bubble by default — you wire the trigger, because a gesture that fires by accident during normal use costs you more than it gains.

On a TV there is no on-device reporter: open() presents nothing, and reports are filed through the companion from a phone or the dashboard. See the tvOS and Android TV pages.

Wire navigation

This is the one step that is not automatic. An RN app is a single native screen for its whole lifetime, so nothing can observe your navigator from outside. One line per screen, or one integration:

import { reactNavigationIntegration } from '@traceitx/react-native/integrations/react-navigation';

See Screen tracking — skipping it is why a report would otherwise arrive with no trail.

Requirements

React Native0.84+
ArchitectureNew Architecture (Fabric). Hermes supported.
TVreact-native-tvos supported, including tvOS and Vega OS
iOS deployment target15+
Android minSdk24+

Verify it

File a report and check the delivery log in the dashboard. If nothing arrives, the usual causes are a wrong key, the provider not actually mounted above the code calling open(), and — on iOS — a missing pod install after upgrading.

There is no debug option on this SDK; native logs go to Xcode and Logcat.

Next