explaingit

wix/react-native-navigation

13,182MDXAudience · developerComplexity · 3/5Setup · moderate

TLDR

A React Native library by Wix that handles screen navigation in mobile apps using the real native navigation components built into iOS and Android, so transitions and gestures feel exactly like native apps.

Mindmap

mindmap
  root((react-native-navigation))
    What it does
      Screen transitions
      Tab bars
      Native gestures
    Platforms
      iOS 11 and above
      Android 5 and above
    Key benefits
      Truly native UI
      One API both platforms
      Wix maintained
    Setup
      npm install
      Native file edits
      Discord and Stack Overflow
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Add native-feeling screen transitions, swipe gestures, and tab bars to a React Native app without writing platform-specific code.

USE CASE 2

Replace a JavaScript-based navigation solution with truly native iOS and Android navigation so the app feels like a real native app.

USE CASE 3

Build a cross-platform navigation structure using one API that behaves identically on both iOS and Android.

Tech stack

React NativeJavaScriptTypeScriptiOSAndroid

Getting it running

Difficulty · moderate Time to first run · 1h+

Requires manual changes to native iOS and Android project files in addition to the standard JavaScript package install.

In plain English

React Native Navigation is a library created by Wix that handles in-app screen transitions for mobile apps built with React Native. When you build a mobile app, you need a way to move users from one screen to another, such as from a login page to a home screen, or from a list view to a detail view. This library takes care of that. The key thing that sets this library apart is that it uses the native navigation tools built into iOS and Android rather than simulating them in JavaScript. That means the swipe gestures, transitions, and tab bars your users see are the real thing, behaving exactly as they would in apps built from scratch in Swift or Kotlin. From a code perspective, the API is designed to look the same whether you are writing for iOS or Android. You write your navigation logic once and it works on both platforms. Wix, the company behind website builder tools by the same name, developed and maintains this project. Getting it set up requires some work beyond a standard JavaScript package install. Because it hooks into native code, you will need to make changes to files in the iOS and Android parts of your project. The documentation walks through that process, and there is a Discord community and Stack Overflow tag if you run into questions. The library targets iOS 11 and Android 5.0 as the minimum supported versions. Development can be done on Windows, macOS, or Linux. The README is brief and points to external documentation for the bulk of the setup and usage details.

Copy-paste prompts

Prompt 1
Help me set up react-native-navigation in my existing React Native project, including the native iOS and Android file changes required.
Prompt 2
I want a bottom tab navigator with 3 tabs using react-native-navigation. Show me the setup code for iOS and Android.
Prompt 3
How do I push a new screen onto the navigation stack and pass data to it using react-native-navigation?
Prompt 4
My react-native-navigation setup works on iOS but crashes on Android. What are the most common causes and how do I debug them?
Open on GitHub → Explain another repo

← wix on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.