Automatic instrumentation

Automatic instrumentation gives SignalFox a useful baseline without asking you to manually track every interaction. Once SignalFox.init, the navigation integration, and the startup patches are in place, SignalFox can start collecting the core signals that help you understand how people move through your app.

What SignalFox tracks automatically

SignalFox can track app lifecycle events, screen changes, modal opens and closes, touchable presses, and supported purchase activity.

In practice, that means you can see activity such as:

• app opens, foreground/background changes, and sessions
• screen views from your navigation setup
• React Native modals opening and closing
• presses on instrumented Pressable and Touchable components
• purchase events from supported monetization integrations

What you still need to add

Automatic tracking does not know which parts of your product matter most. Add signalFoxNodeId to the UI elements you care about, especially modals and important touchable actions.

Use trackFunnelStep only when a meaningful funnel happens inside a single screen, such as a multi-step form, a paywall with several in-screen states, or an onboarding screen that changes views without navigating to a new route.

Use trackSubview when a screen has important sections, tabs, or panels that should be visible in SignalFox.

Use trackModalShown when a surface behaves like a modal but is implemented manually, for example with a custom sheet, overlay, portal, or drawer instead of React Native Modal.

Setup checklist

To get automatic instrumentation working:

• install @asgami-digital/signalfox-react-native
• call applyModalPatch() and applyTouchablePatch() before your app renders
• call SignalFox.init({ apiKey, integrations }) once the root navigation ref (if any) is available
• add the right navigation integration for React Navigation or Expo Router
• add stable signalFoxNodeId values to important modals and pressable/touchable elements

What to expect

Automatic tracking is meant to reduce setup work, not replace product judgment. SignalFox will capture the technical activity it can observe, and you should add IDs and funnel steps where product meaning matters.

After setup, open the Development section in the SignalFox dashboard and interact with your app. You should see events appear as you navigate, open modals, and press tracked controls.