@rozenite/react-navigation-plugin

A Rozenite plugin that provides comprehensive React Navigation debugging and inspection for React Native applications.

The Rozenite React Navigation Plugin provides real-time navigation state monitoring, action timeline inspection, and deep linking testing within your React Native DevTools environment. It offers comprehensive navigation debugging capabilities for React Navigation v7.

Features

• Action Timeline: Track all navigation actions in real-time with detailed history
• State Inspection: View and analyze navigation state at any point in time
• Time Travel Debugging: Jump back to any previous navigation state
• Deep Link Testing: Test and validate deep links directly from DevTools
• Real-time Updates: See navigation changes as they happen in your app
• Production Safety: Automatically disabled in production builds

Installation

Install the React Navigation plugin as a dependency:

npm install @rozenite/react-navigation-plugin

Quick Start

1. Install the Plugin

npm install @rozenite/react-navigation-plugin

2. Integrate with Your App

With react-navigation

Add the DevTools hook to your React Native app with a reference to your NavigationContainer:

// App.tsx
import React, { useRef } from 'react';
import { NavigationContainer } from '@react-navigation/native';
import { useReactNavigationDevTools } from '@rozenite/react-navigation-plugin';

function App() {
  const navigationRef = useRef(null);

  // Enable React Navigation DevTools in development
  useReactNavigationDevTools({ ref: navigationRef });

  return (
    <NavigationContainer ref={navigationRef}>
      <YourAppNavigator />
    </NavigationContainer>
  );
}

With expo-router

Add the DevTools hook to your root _layout file with a reference to your NavigationContainer:

// _layout.tsx
import { Stack, useNavigationContainerRef } from 'expo-router';
import { useReactNavigationDevTools } from '@rozenite/react-navigation-plugin';

function App() {
  const navigationRef = useNavigationContainerRef();

  // Enable React Navigation DevTools in development
  useReactNavigationDevTools({ ref: navigationRef });

  return <Stack />;
}

3. Access DevTools

Start your development server and open React Native DevTools. You'll find the "React Navigation" panel in the DevTools interface.

Made with ❤️ at Callstack

rozenite is an open source project and will always remain free to use. If you think it's cool, please star it 🌟.

Callstack is a group of React and React Native geeks, contact us at [e-mail] if you need any help with these or just want to say hi!

Like the project? ⚛️ Join the team who does amazing stuff for clients and drives React Native Open Source! 🔥