### Run Native Navigation Example App on iOS

Source: https://github.com/airbnb/native-navigation/blob/master/CONTRIBUTING.md

These commands start the development packager and then launch the example application on an iOS simulator or device.

```bash
npm start

npm run run:ios
```

--------------------------------

### Set up Native Navigation Development Environment

Source: https://github.com/airbnb/native-navigation/blob/master/CONTRIBUTING.md

This snippet provides the initial steps to clone the repository, navigate into it, and install project dependencies for the `native-navigation` project.

```bash
git clone https://github.com/airbnb/native-navigation.git
cd native-navigation
npm install
```

--------------------------------

### Run Native Navigation Example App on Android

Source: https://github.com/airbnb/native-navigation/blob/master/CONTRIBUTING.md

These commands start the development packager and then launch the example application on an Android emulator or device.

```bash
npm start

npm run run:android
```

--------------------------------

### Install Native Navigation Project Dependencies

Source: https://github.com/airbnb/native-navigation/blob/master/README.md

Commands to install npm and bundler dependencies required to run the native-navigation example project.

```bash
npm install
```

--------------------------------

### Build and Watch Native Navigation Documentation Locally

Source: https://github.com/airbnb/native-navigation/blob/master/CONTRIBUTING.md

This command starts a local server to build and serve the project documentation, automatically refreshing the browser on source file changes.

```bash
npm run docs:watch
```

--------------------------------

### Initialize ReactNavigationCoordinator in MainApplication.java onCreate()

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Modifies the `onCreate()` method in `MainApplication.java` to initialize `SoLoader` and inject the `ReactInstanceManager` into `ReactNavigationCoordinator`, starting the navigation coordinator.

```Java
import com.airbnb.android.react.navigation.ReactNavigationCoordinator;

// ...

@Override
public void onCreate() {
  super.onCreate();
  SoLoader.init(this, /* native exopackage */ false);
  
  // These three lines need to be added
  ReactNavigationCoordinator coordinator = ReactNavigationCoordinator.sharedInstance;
  coordinator.injectReactInstanceManager(mReactNativeHost.getReactInstanceManager());
  coordinator.start(this);
}
```

--------------------------------

### Start Native Navigation Development Server

Source: https://github.com/airbnb/native-navigation/blob/master/README.md

Command to start the development server for the native-navigation project.

```bash
npm start
```

--------------------------------

### Complete AppDelegate Implementation for Native Navigation

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

This comprehensive `AppDelegate.m` file consolidates all the steps for integrating Native Navigation, including `RCTBridge` initialization, `ReactNavigationCoordinator` setup, root view controller configuration, and delegate method implementations for `RCTBridge` and `ReactNavigationCoordinator`.

```Objective-C
#import "AppDelegate.h"

#import <React/RCTBundleURLProvider.h>
@import NativeNavigation;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  RCTBridge *bridge = [[RCTBridge alloc] initWithDelegate:self
                                      launchOptions:launchOptions];
  ReactNavigationCoordinator *coordinator = [ReactNavigationCoordinator sharedInstance];

  [coordinator setBridge:bridge];
  [coordinator setDelegate:self];

  self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
  ReactViewController *mainViewController = [[ReactViewController alloc] initWithModuleName:@"Home"];
  self.window.rootViewController = [[coordinator navigation] makeNavigationControllerWithRootViewController:mainViewController];
  [self.window makeKeyAndVisible];
  return YES;
}

- (NSURL *)sourceURLForBridge:(RCTBridge *)bridge {
  return [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index.ios" fallbackResource:nil];
}

- (UIViewController *)rootViewControllerForCoordinator: (ReactNavigationCoordinator *)coordinator {
  return self.window.rootViewController;
}

@end
```

--------------------------------

### Run Native Navigation Example on Android

Source: https://github.com/airbnb/native-navigation/blob/master/README.md

Command to run the native-navigation example project on an Android emulator or device.

```bash
npm run run:android
```

--------------------------------

### Run Native Navigation Example on iOS

Source: https://github.com/airbnb/native-navigation/blob/master/README.md

Command to run the native-navigation example project on an iOS simulator or device.

```bash
npm run run:ios
```

--------------------------------

### Create New React Native Project

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

These commands initialize a new React Native project named 'MyNewProject' and then navigate into its directory. This is the first step after installing the CLI and before adding Native Navigation.

```bash
react-native init MyNewProject
cd MyNewProject
```

--------------------------------

### Install Pod Dependencies

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Runs CocoaPods to install the dependencies defined in the Podfile. This command creates an Xcode workspace file (`.xcworkspace`) that should be used for opening the project going forward.

```bash
pod install
```

--------------------------------

### Install React Native CLI Globally

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

This command installs the React Native command-line interface globally on your system. It is a prerequisite for creating and managing React Native projects.

```bash
npm i -g react-native-cli
```

--------------------------------

### Initialize Podfile for iOS Project

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Navigates into the iOS project directory and initializes a new Podfile. This file will be used to define and manage project dependencies via CocoaPods.

```bash
cd ios
pod init
```

--------------------------------

### Example Usage of `registerConnectedScreen`

Source: https://github.com/airbnb/native-navigation/blob/master/docs/guides/project-structure.md

Illustrates how to use the custom `registerConnectedScreen` utility in `index.js` to register a screen. This example shows passing a `getStore` option to automatically connect the `SomeScreen` component to the Redux store.

```javascript
// index.js
import registerConnectedScreen from './utils/registerConnectedScreen';

registerConnectedScreen(
  'SomeScreen',
  () => require('./screens/SomeScreen'),
  {
    getStore: () => require('./path/to/redux/store'),
  },
);
```

--------------------------------

### Check Native Navigation Codebase for Linting Compliance

Source: https://github.com/airbnb/native-navigation/blob/master/CONTRIBUTING.md

This command runs ESLint to check the source code against the Airbnb Styleguide, ensuring code quality and consistency.

```bash
npm run lint
```

--------------------------------

### Extend NativeNavigation ReactActivity and define initial screen in MainActivity.java

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Updates `MainActivity.java` to extend `com.airbnb.android.react.navigation.ReactActivity` and replaces `getMainComponentName()` with `getInitialScreenName()`, specifying the initial screen name for Native Navigation.

```Java
import com.airbnb.android.react.navigation.ReactActivity;

public class MainActivity extends ReactActivity {

    /**
     * Returns the name of the screen registered from JavaScript.
     */
    @Override
    protected String getInitialScreenName() {
        return "Home";
    }
}
```

--------------------------------

### Install CocoaPods Gem

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Installs the CocoaPods dependency manager using RubyGems. This is a prerequisite for managing iOS project dependencies with CocoaPods.

```bash
sudo gem install cocoapods
```

--------------------------------

### Install Native Navigation Dependency

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

This command installs the `native-navigation` package as a dependency in your React Native project. It saves the package to your `package.json` file. Note that `react-native link` is not supported for this package.

```bash
npm i --save native-navigation
```

--------------------------------

### Complete AppDelegate Header File for Native Navigation

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

This is the full `AppDelegate.h` file, demonstrating the necessary imports (`UIKit`, `React/RCTBridge.h`, `NativeNavigation`) and protocol adoptions (`UIApplicationDelegate`, `RCTBridgeDelegate`, `ReactNavigationCoordinatorDelegate`) required for Native Navigation integration.

```Objective-C
#import <UIKit/UIKit.h>
#import <React/RCTBridge.h>
@import NativeNavigation;

@interface AppDelegate : UIResponder <UIApplicationDelegate, RCTBridgeDelegate, ReactNavigationCoordinatorDelegate>

@property (nonatomic, strong) UIWindow *window;

@end
```

--------------------------------

### Add NativeNavigationPackage to MainApplication.java getPackages()

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Imports `NativeNavigationPackage` and adds it to the list of `ReactPackage`s returned by `getPackages()` in `MainApplication.java`, integrating Native Navigation with the React Native package system.

```Java
import com.airbnb.android.react.navigation.NativeNavigationPackage;

// ...

@Override
protected List<ReactPackage> getPackages() {
  return Arrays.<ReactPackage>asList(
      new MainReactPackage(),
      new NativeNavigationPackage()
  );
}
```

--------------------------------

### Open Xcode Workspace

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Opens the newly created Xcode workspace file. It is crucial to use this `.xcworkspace` file instead of the original `.xcodeproj` file after CocoaPods installation to ensure all dependencies are correctly linked.

```bash
open MyNewProject.xcworkspace
```

--------------------------------

### Include Native Navigation in Android settings.gradle

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Configures `android/settings.gradle` to include Native Navigation as a source project, enabling the build system to compile it directly from `node_modules`.

```Gradle
include ':native-navigation'
project(':native-navigation').projectDir = new File(rootProject.projectDir, '../node_modules/native-navigation/lib/android')
```

--------------------------------

### Configure packagingOptions in Android app build.gradle

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Adds a `packagingOptions` block to the `android` section of `android/app/build.gradle` to exclude various META-INF files, preventing potential conflicts during the build process.

```Gradle
    packagingOptions {
        exclude 'META-INF/LICENSE'
        exclude 'META-INF/DEPENDENCIES.txt'
        exclude 'META-INF/LICENSE.txt'
        exclude 'META-INF/NOTICE.txt'
        exclude 'META-INF/NOTICE'
        exclude 'META-INF/DEPENDENCIES'
        exclude 'META-INF/notice.txt'
        exclude 'META-INF/license.txt'
        exclude 'META-INF/dependencies.txt'
        exclude 'META-INF/LGPL2.1'
    }
```

--------------------------------

### Add Native Navigation dependencies to Android app build.gradle

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Adds required Android support libraries and the Native Navigation project dependency to the `dependencies` block in `android/app/build.gradle`.

```Gradle
dependencies {
    // ... any dependencies you already had
    
    // if you don't already depend on the support libraries, add these
    compile 'com.android.support:appcompat-v7:25.2.0'
    compile 'com.android.support:support-annotations:25.2.0'
    
    // add native-navigation
    compile project(':native-navigation')
}
```

--------------------------------

### Initialize React Native Bridge (RCTBridge)

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

This snippet demonstrates how to create an instance of `RCTBridge`, which is essential for React Native to communicate with native modules. The `AppDelegate` typically acts as its delegate.

```Objective-C
RCTBridge *bridge = [[RCTBridge alloc] initWithDelegate:self
                                          launchOptions:launchOptions];
```

--------------------------------

### Define a React Native Screen Component

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/registerScreen.md

Example of a basic React component (`ScreenOne.js`) that can be registered as a native screen. This component serves as the definition for screens used in `registerScreen` examples.

```js
// ScreenOne.js
import React from 'react';

export default class ScreenOne extends React.Component {
  render() {
    // ...
  }
}
```

--------------------------------

### Configure Podfile for Native Navigation and React Native

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Edits the Podfile to include Native Navigation, React Native (with necessary subspecs like Core, RCTText, RCTNetwork, RCTWebSocket, RCTAnimation, RCTImage), and Yoga. It also enables `use_frameworks!` for Swift compatibility, which is required by Native Navigation.

```ruby
target 'MyNewProject' do
  # Native Navigation uses Swift, so this line is required!
  use_frameworks!

  # Native Navigation!
  pod 'native-navigation', :path => '../node_modules/native-navigation'

  # To use CocoaPods with React Native, you need to add this specific Yoga spec as well
  pod 'Yoga', :path => '../node_modules/react-native/ReactCommon/yoga/Yoga.podspec'

  # You don't necessarily need all of these subspecs, but this would be a typical setup.
  pod 'React', :path => '../node_modules/react-native', :subspecs => [
    'Core',
    'RCTText',
    'RCTNetwork',
    'RCTWebSocket', # needed for debugging
    'RCTAnimation',
    'RCTImage',
    'RCTNetwork'

    # Add any other subspecs you want to use in your project
  ]
  
  # Add any other dependencies here, including any 3rd party native libraries that you depend on for
  # React Native.
end
```

--------------------------------

### Verify CocoaPods Version

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Checks the installed version of CocoaPods. React Native requires version 1.2.0 or greater, so it's important to verify the current version.

```bash
pod --version
```

--------------------------------

### Register React Native Root Component (Standard)

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

This JavaScript snippet shows the standard way to register the main component of a React Native application using `AppRegistry.registerComponent`. It defines the entry point for the application before Native Navigation modifications.

```js
AppRegistry.registerComponent('MyNewProject', () => MyNewProject);
```

--------------------------------

### Configure Shared Native Navigation Coordinator

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

The `ReactNavigationCoordinator` is a central component of the Native Navigation library. This code shows how to obtain its shared instance and provide it with the initialized `RCTBridge` and its own delegate.

```Objective-C
ReactNavigationCoordinator *coordinator = [ReactNavigationCoordinator sharedInstance];

[coordinator setBridge:bridge];
[coordinator setDelegate:self];
```

--------------------------------

### Set App's Root View Controller with Native Navigation

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

This code snippet illustrates how to create the application's initial React Native screen (`ReactViewController`) and wrap it within a navigation controller provided by Native Navigation, then assign it as the window's root view controller.

```Objective-C
ReactViewController *mainViewController = [[ReactViewController alloc] initWithModuleName:@"Home"];
self.window.rootViewController = [[coordinator navigation] makeNavigationControllerWithRootViewController:mainViewController];
```

--------------------------------

### Example Usage of Navigator.SharedElement in React Native

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator-shared-element.md

Demonstrates how to use the `<SharedElement />` component to wrap an `Image` component, enabling shared element transitions. This example shows a `UserImage` component that uses `SharedElement` with `type` and `typeId` props to identify a user's profile image for transitions.

```jsx
import React from 'react';
import { Image } from 'react-native';
import { SharedElement } from 'native-navigation';

export default class UserImage extends React.Component {
  render() {
    const { user } = this.props;
    return (
      <SharedElement
        type="user-image"
        typeId={user.id}
        style={sizeStyle}
      >
        <Image
          style={[styles.image, sizeStyle]}
          source={{ uri: user.profile_image }}
        />
      </SharedElement>
    );
  }
}
```

--------------------------------

### Provide Root View Controller for Native Navigation Coordinator

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

The `rootViewControllerForCoordinator:` delegate method of `ReactNavigationCoordinatorDelegate` is used by Native Navigation to understand the app's current navigation stack. It should return the main root view controller of the application window.

```Objective-C
- (UIViewController *)rootViewControllerForCoordinator: (ReactNavigationCoordinator *)coordinator {
  return self.window.rootViewController;
}
```

--------------------------------

### Test React Native Welcome Screen Rendering

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

This test method demonstrates how to programmatically check if a specific UI element (e.g., a welcome screen) is rendered in a React Native application's view hierarchy within a timeout period. It's useful for UI testing.

```Objective-C
- (void)testRendersWelcomeScreen
{
  UIViewController *vc = [[[[UIApplication sharedApplication] delegate] window] rootViewController];
  NSDate *date = [NSDate dateWithTimeIntervalSinceNow:TIMEOUT_SECONDS];
  BOOL foundElement = NO;

  while ([date timeIntervalSinceNow] > 0 && !foundElement) {
    [[NSRunLoop mainRunLoop] runMode:NSDefaultRunLoopMode beforeDate:[NSDate dateWithTimeIntervalSinceNow:0.1]];
    [[NSRunLoop mainRunLoop] runMode:NSRunLoopCommonModes beforeDate:[NSDate dateWithTimeIntervalSinceNow:0.1]];

    foundElement = [self findSubviewInView:vc.view matching:^BOOL(UIView *view) {
      if ([view.accessibilityLabel isEqualToString:TEXT_TO_LOOK_FOR]) {
        return YES;
      }
      return NO;
    }];
  }

  XCTAssertTrue(foundElement, @"Couldn't find element with text '%@' in %d seconds", TEXT_TO_LOOK_FOR, TIMEOUT_SECONDS);
}
```

--------------------------------

### Example Usage of `present` function in React Native

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/present.md

Demonstrates how to use the `native-navigation` `present` function within a React component to navigate to a 'Register' screen and handle the result upon dismissal.

```javascript
import React from 'react';

import Navigator from 'native-navigation';

class Foo extends React.Component {
  constructor(props) {
    super(props);
    this.state = {
      registered: false,
    };
    this.onPress = this.onPress.bind(this);
  }
  onPress() {
    return Navigator
      .present('Register', { source: 'Foo' })
      .then(({ code }) => this.setState({ registered: code === Navigator.RESULT_OK })); 
  }
  render() {
    return (
      <View>
        {!registered &&  (
          <Button
            title="Register Now"
            onPress={this.onPress} 
          />
        )}
        {!!registered &&  (
          <Button
            title="Continue"
            onPress={this.onPress} 
          />
        )}
      </View>
    );
  }
}
```

--------------------------------

### Defining Screen Route Constants in routes.js

Source: https://github.com/airbnb/native-navigation/blob/master/docs/guides/project-structure.md

Shows an example of `routes.js`, a file used to define string constants that uniquely identify each screen. These constants act as 'URLs' for navigation within the application.

```javascript
export const FOO = 'MyApp/Foo';
export const BAR = 'MyApp/Bar';
```

--------------------------------

### Modify AppDelegate Header for Protocols

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Updates the `AppDelegate.h` header file to declare that the `AppDelegate` class conforms to `RCTBridgeDelegate` and `ReactNavigationCoordinatorDelegate` protocols. This conformance is essential for Native Navigation to manage `RCTRootView` instances.

```objective-c
@interface AppDelegate : UIResponder <UIApplicationDelegate, RCTBridgeDelegate, ReactNavigationCoordinatorDelegate>
```

--------------------------------

### Register Native Navigation Screen

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

This JavaScript code demonstrates how to register a React Native component as a 'Screen' using `NativeNavigator.registerScreen`. It imports the `native-navigation` library and registers the 'MyNewProject' component as the 'Home' screen, which is required for Native Navigation's multi-root view architecture.

```js
// top of the file
import Navigator from 'native-navigation';

// bottom of the file 
Navigator.registerScreen('Home', () => MyNewProject);
```

--------------------------------

### Add DevSupport Module to React Pod (v0.43.0+)

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Modifies the React Pod entry in the Podfile to include the 'DevSupport' subspec. This is required for the debug menu to function correctly in React Native versions 0.43.0 and above.

```ruby
pod 'React', :path => './React/node_modules/react-native', :subspecs => [
    'Core',
    'xxx',
    'xxx',
    'xxx',
    'DevSupport']
```

--------------------------------

### Configure JavaScript Bundle URL for RCTBridge

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

This method, part of the RCTBridgeDelegate protocol, specifies the URL for the JavaScript bundle that React Native will load. It typically points to 'index.ios' for iOS applications.

```Objective-C
(NSURL *)sourceURLForBridge:(RCTBridge *)bridge {
  return [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index.ios" fallbackResource:nil];
}
```

--------------------------------

### Dismissing a Native Screen in JavaScript

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/dismiss.md

Example demonstrating how to use `Navigator.dismiss()` to programmatically close the current native screen. This snippet shows the basic usage without passing a payload.

```js
import Navigator from 'native-navigation';

Navigator.dismiss();
```

--------------------------------

### Add Required Headers to AppDelegate

Source: https://github.com/airbnb/native-navigation/blob/master/docs/installation.md

Adds necessary import statements to `AppDelegate.h` for `RCTBridge.h` and the `NativeNavigation` module. These imports provide access to the React Native bridge functionalities and Native Navigation's core components.

```objective-c
#import <React/RCTBridge.h>
@import NativeNavigation;
```

--------------------------------

### Example Usage of Navigator.Spacer in React Native

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator-spacer.md

Demonstrates how to integrate the `Spacer` component within a React Native `ScrollView` to ensure content is correctly positioned below the navigation bar. The `animated` prop is used to enable height transitions.

```jsx
import React from 'react';
import { ScrollView, View, Text } from 'react-native';
import { Spacer } from 'native-navigation';

export default class Screen extends React.Component {
  render() {
    return (
      <ScrollView>
      
        {/* This view will be the exact height of the Navigation Bar */}
        <Spacer animated />
        
        {/* This content will be rendered below the navigation bar */}
        <View>
          <Text>Hello World</Text>
        </View>
      </ScrollView>
    )
  }
}
```

--------------------------------

### Implement Shared Element Transitions in React Native

Source: https://github.com/airbnb/native-navigation/blob/master/docs/guides/shared-element-transitions.md

These React Native components demonstrate the setup for shared element transitions using `native-navigation`. The `FromScreen` initiates the transition by wrapping elements in `SharedElementGroup` and `SharedElement`, while the `ToScreen` defines the matching `SharedElement` to receive the transition.

```jsx
import React from 'react';
import { View, Image } from 'react-native';
import Navigator, { SharedElement, SharedElementGroup } from 'native-navigation';

const onPress = id => () => 
 Navigator.push('ToScreen', { id }, {
  transitionGroup: id,
 });

class FromScreen extends React.Component {
 render() {
  const { posters } = this.props;
  return (
   <View>
    {posters.map(poster => (
     <SharedElementGroup id={poster.id}>
      <Touchable onPress={onPress(poster.id)}>
       <SharedElement
        type="poster"
        typeId={poster.id}
       >
        <Image source={{ uri: poster.url }} />
       </SharedElement>
      </Touchable>
     </SharedElementGroup>
    ))}
   </View>
  );
 }
}
```

```jsx
import React from 'react';
import { View, Image } from 'react-native';
import Navigator, { SharedElement, SharedElementGroup } from 'native-navigation';

class ToScreen extends React.Component {
 render() {
  return (
   <View>
    {/* ... */}
    <SharedElement
     type="poster"
     typeId={poster.id}
    >
     <Image source={{ uri: poster.url }} />
    </SharedElement>
    {/* ... */}
   </View>
  );
 }
}
```

--------------------------------

### React Native Shared Element Component Usage

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator-shared-element-group.md

This example demonstrates how to implement a shared element transition for a user image using the SharedElement component in a React Native class component. It shows how to wrap an Image component and configure shared element properties like type and typeId.

```jsx
import React from 'react';
import { Image } from 'react-native';
import { SharedElement } from 'native-navigation';

export default class UserImage extends React.Component {
  render() {
    const { user } = this.props;
    return (
      <SharedElement
        type="user-image"
        typeId={user.id}
        style={sizeStyle}
      >
        <Image
          style={[styles.image, sizeStyle]}
          source={{ uri: user.profile_image }}
        />
      </SharedElement>
    );
  }
}
```

--------------------------------

### Clone Native Navigation Repository

Source: https://github.com/airbnb/native-navigation/blob/master/README.md

Instructions to clone the native-navigation repository from GitHub.

```bash
git clone https://github.com/airbnb/native-navigation.git
cd native-navigation
```

--------------------------------

### API Reference for push(screenName[, props, options]) method

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/push.md

Detailed API documentation for the `push` method, outlining its parameters, their types, descriptions, and the expected return value. It also lists related types.

```APIDOC
push(screenName[, props, options])

Arguments:
  1. screenName (string): The screen identifier of the screen to be pushed.
  2. props (Object): Props to be passed into the pushed screen.
  3. options (Object): Options for the navigation transition:
     - options.transitionGroup (string): The shared element group ID to use for the shared element transition

Returns:
  (Promise<NavigationResult>): A Promise that resolves upon successful navigation.

Related Types:
  - NavigationResult
```

--------------------------------

### API Reference for `present` function

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/present.md

Details the `present` function, its parameters, and return values for native-navigation.

```APIDOC
present(screenName[, props, options])
  screenName: string
    The screen identifier of the screen to be pushed.
  props: Object
    Props to be passed into the presented screen.
  options: Object
    Options for the navigation transition:
    transitionGroup: string
      The shared element group ID to use for the shared element transition
    modalPresentationStyle: string (iOS only)
      The presentation style to use when presenting the view modally. Either `fullScreen` (default), `pageSheet`, `formSheet`, `currentContext`, `custom`, `overFullScreen`, `overCurrentContext`, `popover` or `none`.
Returns: Promise<NavigationResult>
  A promise that resolves when the presented screen gets dismissed.
```

--------------------------------

### Native Navigation API Reference

Source: https://github.com/airbnb/native-navigation/blob/master/README.md

Overview of the core API components and methods available in the Native Navigation library. Detailed documentation for each API is linked externally.

```APIDOC
Navigator.registerScreen(...)
Navigator.push(...)
Navigator.present(...)
Navigator.pop(...)
Navigator.dismiss(...)
Config
Spacer
Tab
TabBar
SharedElement
SharedElementGroup
```

--------------------------------

### Navigator API Methods

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/README.md

Provides an overview of the core methods available in the Navigator API for screen management and navigation, including registering screens, pushing, presenting, popping, and dismissing views.

```APIDOC
Methods:
  registerScreen(screenName, getScreen[, options])
  push(screenName[, props, options]): Promise
  present(screenName[, props, options]): Promise
  pop([payload])
  dismiss([payload])
```

--------------------------------

### Recommended Native Navigation Project Directory Structure

Source: https://github.com/airbnb/native-navigation/blob/master/docs/guides/project-structure.md

Illustrates the suggested file and folder organization for a Native Navigation application, highlighting the distinction between `components` and `screens` directories, and the roles of top-level `routes.js` and `index.js` files.

```plaintext
root/
├── components/
├── screens/
│   ├── FooScreen.js
│   └── BarScreen.js
├── routes.js
└── index.js
```

--------------------------------

### Registering Native Navigation Screens in index.js

Source: https://github.com/airbnb/native-navigation/blob/master/docs/guides/project-structure.md

Demonstrates how the main `index.js` file, serving as the JavaScript bundle entry point, registers individual screens with `native-navigation` using the route constants defined in `routes.js`.

```javascript
import Navigator from 'native-navigation';
import { FOO, BAR } from './routes';

Navigator.registerScreen(FOO, () => require('./screens/FooScreen'));
Navigator.registerScreen(BAR, () => require('./screens/BarScreen'));
```

--------------------------------

### Navigator.Config Component Events Reference

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator-config.md

Documentation for the event handlers supported by the `Navigator.Config` component, detailing their signatures and when they are triggered. These callbacks allow reacting to various lifecycle and user interaction events related to the screen and navigation bar.

```APIDOC
onAppear: () => void
onDisappear: () => void
onEnterTransitionCompleted: () => void
onBarHeightChanged: (height: number) => void
onLeftPress: () => void
onRightPress: (index: number) => void
```

--------------------------------

### Navigator.Config Component Props Reference

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator-config.md

Detailed documentation for the properties available on the `Navigator.Config` component, including their types, descriptions, and default values where applicable. These props allow extensive customization of the screen and its navigation bar.

```APIDOC
children: node
  If `children` are passed into the component, the `Config`'s `render` method will return the result of `React.Children.only(this.props.children)`. Otherwise, `render` will just return `null`.
title: string
  The title of the screen. This shows up in the center of the navigation bar by default.
titleColor: Color
  The text color of the title.
subtitle: string
  The subtitle of the screen. This shows up as a string below the title of the screen.
subtitleColor: Color
  The text color of the subtitle.
alpha: number
  The opacity of the navigation bar. Should be between `0` and `1`.
rightTitle: string
rightImage: Image
rightButtons: Array<Button>
screenColor: Color
  The background color of the entire screen.
  If the color is translucent, the old screen will be kept below this one (to use it like a modal, for instance).
  Defaults to `#FFFFFF`.
hidden: boolean
  If true, the navigation bar will not be visible.
  Defaults to `false`.
backgroundColor: Color
foregroundColor: Color
statusBarHidden: boolean
  If true, the status bar will not be visible.
  Defaults to `false`.
statusBarAnimation: 'slide' | 'none' | 'fade'
  Configures how the status bar should animate between configurations.
  Defaults to `'fade'`.
statusBarStyle: 'light' | 'default'
```

--------------------------------

### Importing Navigator from native-navigation

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/README.md

This snippet demonstrates how to import the `Navigator` component from the `native-navigation` library, which serves as the primary entry point for utilizing its navigation functionalities in a JavaScript or React Native project.

```JavaScript
import Navigator from 'native-navigation';
```

--------------------------------

### Register React Native Screen with Initial Configuration

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/registerScreen.md

Shows how to register a screen (`ScreenOne`) and pass static initial configuration options, such as `waitForRender` and `initialConfig`, directly during registration. These options merge with any `Navigator.Config` defined within the rendered screen.

```js
// register.js
import Navigator from 'native-navigation';

Navigator.registerScreen('ScreenOne', () => require('./ScreenOne'), {
  waitForRender: false,
  initialConfig: {
    title: 'ScreenOne',
  },
});
```

--------------------------------

### Basic Usage of Navigator.Config Component

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator-config.md

Demonstrates how to import and use the `Navigator.Config` component within a React class component. It shows how to set properties like `title`, `backgroundColor`, `elevation`, and attach event handlers such as `onBackPress`, `onLeftPress`, `onRightPress`, and `onAppear` to configure the screen and navigation bar.

```jsx
import React from 'react';
import Navigator from 'native-navigation';

export default class Screen extends React.Component {
  render() {
    const {
      children,
      title,
    } = this.props;

    return (
      <Navigator.Config
        title={title}
        backgroundColor="#F7F7F7"
        elevation={4}
        onBackPress={() => console.log('onBackPress')}
        onLeftPress={() => console.log('onLeftPress')}
        onRightPress={(index) => console.log('onRightPress', index)}
        onAppear={() => console.log('onAppear')}
      >
        {children}
      </Navigator.Config>
    );
  }
}
```

--------------------------------

### APIDOC: `registerScreen` Function Definition

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/registerScreen.md

Defines the `registerScreen` function, its parameters, and available options for configuring screen behavior and initial properties.

```APIDOC
registerScreen(screenName: string, getScreen: Thunk<Component>, options?: ScreenOptions)
  Parameters:
    screenName: string
      Description: The screen identifier to be registered with this screen.
    getScreen: Thunk<Component>
      Description: A function returning the component to use for the screen.
    options: ScreenOptions (optional)
      Description: Configuration options for the screen.
      Properties:
        waitForRender: boolean (optional)
          Description: If true, the screen will not get pushed or presented until it renders once. Defaults to true.
        initialConfig: ScreenConfig (optional)
          Description: Any ScreenConfig props to apply initially to the screen. Values passed here will get merged with values passed into any Navigator.Config. Defaults to {}.
        mode: 'screen' | 'tabs'
          Description: Screen display mode. Defaults to 'screen'.
```

--------------------------------

### Navigator API Components

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/README.md

Lists the UI components provided by the Navigator API, designed to facilitate the creation of navigation-related user interfaces such as configuration, spacing, tab bars, and shared elements.

```APIDOC
Components:
  Config
  Spacer
  TabBar
  Tab
  SharedElement
  SharedElementGroup
```

--------------------------------

### Push a new screen onto the navigation stack in JavaScript

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/push.md

This snippet demonstrates how to use the `Navigator.push` method to navigate to a new screen named 'ScreenOne' and pass an object `{ foo: 'bar' }` as props to it. This is a fundamental operation for screen-to-screen navigation.

```javascript
import Navigator from 'native-navigation';

Navigator.push('ScreenOne', { foo: 'bar' });
```

--------------------------------

### Inject Custom Android Navigation Implementation into Coordinator

Source: https://github.com/airbnb/native-navigation/blob/master/docs/guides/custom-navigation-implementations.md

Shows how to inject a custom `NavigationImplementation` instance into the `ReactNavigationCoordinator` in Java, enabling the library to utilize custom navigation logic on Android.

```Java
NavigationImplementation implementation = new MyCustomNavigationImplementation();
ReactNavigationCoordinator.sharedInstance.injectImplementation(implementation);
```

--------------------------------

### Type Definitions for Native Navigation Configuration

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator-config.md

Defines the data structures for `Image`, `Button`, `SystemItem` enums, and `NavigatorConfigProps`. These types specify the properties available for configuring UI elements and behaviors within a native navigation system, distinguishing between properties common across platforms, and those specific to iOS or Android.

```typescript
type Image = {
  uri: string;
  width: number;
  height: number;
}

type Button = {
  // shared
  title: string;
  image: Image;
  
  // ios-only-but-should-share
  enabled: boolean;
  tintColor: boolean;
  fontName: string;
  fontSize: number;
  
  // ios-only
  style: 'plain' | 'default';
  systemItem: SystemItem;

  // android-only
};

type SystemItem = 'done' 
  | 'cancel' 
  | 'edit' 
  | 'save' 
  | 'add' 
  | 'flexibleSpace' 
  | 'compose' 
  | 'reply' 
  | 'action' 
  | 'organize' 
  | 'bookmarks' 
  | 'search' 
  | 'refresh' 
  | 'stop' 
  | 'camera' 
  | 'trash' 
  | 'play' 
  | 'pause' 
  | 'rewind' 
  | 'fastForward' 
  | 'undo' 
  | 'redo' 
  | 'pageCurl'

type NavigatorConfigProps = {

  // shared
  title: string;
  titleColor: Color;
  subtitle: string;
  subtitleColor: Color;
  alpha: number;
  rightTitle: string;
  rightImage: Image;
  rightButtons: Array<Button>;
  leftButtons: Array<Button>;
  screenColor: Color;
  hidden: boolean;
  backgroundColor: Color; 
  foregroundColor: Color;
  statusBarHidden: boolean;
  statusBarAnimation: 'slide' | 'none' | 'fade'; // 'fade' is default
  statusBarStyle: 'light' | 'default';
  
  // ios-only-but-should-share
  backIndicatorImage: Image;
  titleFontName: string;
  titleFontSize: number;
  subtitleFontName: string;
  subtitleFontSize: number;
  leftTitle: string;
  leftImage: Image;
  
  // android-only-but-should-share
  navIcon: Image;
  logo: Image;
  textAlign: 'left' | 'center' | 'right';
  
  // ios-only
  prompt: string;
  hidesBackButton: boolean;
  hidesBarsOnTap: boolean;
  hidesBarsOnSwipe: boolean;
  hidesBarsWhenKeyboardAppears: boolean;
  isToolbarHidden: boolean;
  backIndicatorTransitionMaskImage: Image;
  translucent: boolean;
  rightSystemItem: SystemItem;
  leftSystemItem: SystemItem;
  
  // android-only
  statusBarColor: Color;
  statusBarTranslucent: boolean;
  windowTitle: string;
  elevation: number;
  overflowIcon: Image;
  displayHomeAsUp: boolean;
  homeButtonEnabled: boolean;
  showHome: boolean;
  showTitle: boolean;
  showCustom: boolean;
  useLogo: boolean;
  useShowHideAnimation: boolean;
  hideOnScroll: boolean;
  hideOffset: number;
}
```

--------------------------------

### Define iOS ReactNavigationImplementation Protocol

Source: https://github.com/airbnb/native-navigation/blob/master/docs/guides/custom-navigation-implementations.md

Outlines the `ReactNavigationImplementation` protocol for iOS, detailing methods for creating navigation controllers, reconciling screen and tab configurations, and calculating bar heights. This protocol enables custom UI logic for native iOS navigation components.

```APIDOC
protocol ReactNavigationImplementation {

  func makeNavigationController(rootViewController: UIViewController) -> UINavigationController

  func reconcileScreenConfig(
    viewController: ReactViewController,
    navigationController: UINavigationController?,
    prev: [String: AnyObject],
    next: [String: AnyObject]
  )

  func reconcileTabConfig(
    tabBarItem: UITabBarItem,
    prev: [String: AnyObject],
    next: [String: AnyObject]
  )

  func reconcileTabBarConfig(
    tabBar: UITabBar,
    prev: [String: AnyObject],
    next: [String: AnyObject]
  )

  func getBarHeight(
    viewController: ReactViewController, 
    navigationController: UINavigationController?, 
    config: [String: AnyObject]
  ) -> CGFloat;
}
```

--------------------------------

### Inject Custom iOS Navigation Implementation into Coordinator

Source: https://github.com/airbnb/native-navigation/blob/master/docs/guides/custom-navigation-implementations.md

Illustrates how to assign a custom `ReactNavigationImplementation` instance to the `sharedInstance` of `ReactNavigationCoordinator` in Swift, integrating custom navigation behavior into the library.

```Swift
let implementation: ReactNavigationImplementation = MyCustomNavigationImplementation();
ReactNavigationCoordinator.sharedInstance.navigation = implementation;
```

--------------------------------

### Navigator.Tab Component Props Reference

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator-tab.md

Defines the configurable properties for the <Navigator.Tab /> component, including required route, general props, and specific implementation-defined properties for visual presentation and behavior.

```APIDOC
<Navigator.Tab /> Component Props:
  route: string (required)
  props: Object

Implementation Props (from DefaultImplementation):
  enabled: boolean
  image: Image
  selectedImage: Image
  title: string
  titleFontSize: number
  titleFontColor: Color
  titleFontName: string
  badgeValue: number
  badgeColor: Color
  badgeFontSize: number
  badgeFontColor: Color
  badgeFontName: string
```

--------------------------------

### Navigator.TabBar Component Implementation Props Reference

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator-tab-bar.md

Defines the properties available for customizing the appearance and behavior of the `Navigator.TabBar` component. These props are part of the `DefaultImplementation` and allow control over colors, images, elevation, and translucency.

```APIDOC
Navigator.TabBar Implementation Props:
  enabled: boolean
  backgroundColor: Color
  backgroundImage: Image
  shadowImage: Image
  selectionIndicatorImage: Image
  elevation: number
  translucent: boolean
  tintColor: Color
  barTintColor: Color
  itemIconColor: Color
  itemIconActiveColor: Color
  itemIconSelectedColor: Color
  itemIconDisabledColor: Color
  itemTextColor: Color
  itemTextActiveColor: Color
  itemTextSelectedColor: Color
  itemTextDisabledColor: Color
```

--------------------------------

### Custom `registerConnectedScreen` for Redux Integration

Source: https://github.com/airbnb/native-navigation/blob/master/docs/guides/project-structure.md

Presents a utility function `registerConnectedScreen` designed to streamline Redux integration. This function wraps a given screen component with a Redux `Provider`, automatically connecting it to the Redux store provided via options, thereby reducing boilerplate for each screen registration.

```javascript
import React from 'react';
import { Provider } from 'react-redux';
import Navigator from 'native-navigation';

// This ensures that we can use `() => require('./foo')` as a `getScreen` or `getStore` option,
// even if `foo.js` is an ES6 module.  It's not really important to this example.
function unwrapDefaultExport(module) {
  if (module != null && module.__esModule === true) {
    return module.default;
  }
  return module;
}

// provided a `getScreen` function and a `getStore` function, we want to return a new function
// that returns a new react component that renders the old one, but with the redux store provided
// through context.
function wrapScreenGetter(route, getScreen, { getStore }) {

  class ConnectedScreen extends React.Component {
    render() {
      const Screen = unwrapDefaultExport(getScreen());
      const store = unwrapDefaultExport(getStore());
      return (
        <Provider store={store}>
          <Screen {...this.props} />
        </Provider>
      );
    }
  }
  
  // customize the display name for better React dev tools interop.
  ConnectedScreen.displayName = `ConnectedScreen(${route})`;

  return () => {
    // invoking this here ensures that our original `getScreen` function gets called, which we want
    // to happen to make sure that `Navigator.preload` still does meaningful work.
    getScreen();
    return ConnectedScreen;
  };
}

export default function registerConnectedScreen(route, getScreen, options = {}) {
  const getWrapper = wrapScreenGetter(route, getScreen, options);
  return Navigator.registerScreen(route, getWrapper, options);
}
```

--------------------------------

### dismiss Function API Reference

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/dismiss.md

Detailed API documentation for the `dismiss` function, including its arguments and their purpose. The `payload` argument allows data to be passed back to the screen that initiated the presentation.

```APIDOC
dismiss([payload])

Arguments:
1. payload (Object): An optional payload to pass back to the presenting screen. This is what the promise returned from `present(...)` will resolve with.
```

--------------------------------

### Navigator.Spacer Component Props

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator-spacer.md

Defines the properties available for the `Navigator.Spacer` component, detailing their types and purpose.

```APIDOC
Navigator.Spacer Props:
  animated: boolean
    description: Whether or not you want this view's height to animate when the size of the navigation bar changes.
    default: false
```

--------------------------------

### Pop Current Screen using native-navigation (JavaScript)

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/pop.md

Illustrates how to use the `pop()` method from the `native-navigation` library to dismiss the topmost screen on the navigation stack, returning to the previous screen in the application flow.

```js
import Navigator from 'native-navigation';

Navigator.pop();
```

--------------------------------

### Define Android NavigationImplementation Interface

Source: https://github.com/airbnb/native-navigation/blob/master/docs/guides/custom-navigation-implementations.md

Specifies the `NavigationImplementation` interface for Android, including methods for reconciling navigation properties, managing options menus, retrieving bar heights, and handling tab bar configurations. This interface allows for custom UI control over native Android navigation.

```APIDOC
interface NavigationImplementation {
  void reconcileNavigationProperties(
      ReactInterface component,
      ReactToolbar toolbar,
      ActionBar bar,
      ReadableMap previous,
      ReadableMap next,
      boolean firstCall
  );

  void prepareOptionsMenu(
      ReactInterface component,
      ReactToolbar toolbar,
      ActionBar bar,
      Menu menu,
      ReadableMap previous,
      ReadableMap next
  );

  boolean onOptionsItemSelected(
      ReactInterface component,
      ReactToolbar toolbar,
      ActionBar bar,
      MenuItem item,
      ReadableMap config
  );

  float getBarHeight(
      ReactInterface component,
      ReactToolbar toolbar,
      ActionBar actionBar,
      ReadableMap config,
      boolean firstCall
  );

  void makeTabItem(
      ReactBottomNavigation bottomNavigation,
      Menu menu,
      int index,
      Integer itemId,
      ReadableMap config
  );

  void reconcileTabBarProperties(
      ReactBottomNavigation bottomNavigation,
      Menu menu,
      ReadableMap prev,
      ReadableMap next
  );
}
```

--------------------------------

### Navigator.SharedElementGroup Props

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator-shared-element-group.md

Documents the 'id' prop available for the Navigator.SharedElementGroup component, specifying its accepted types.

```APIDOC
id: number | string
```

--------------------------------

### Props for Navigator.SharedElement Component

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator-shared-element.md

Defines the properties available for the `<Navigator.SharedElement />` component, used to identify and group elements for shared transitions. These props are crucial for linking elements across different screens during a transition.

```APIDOC
Props:
  type: string
  typeId: number | string
  subType: string
  subTypeId: number | string
```

--------------------------------

### Register React Native Screen Lazily

Source: https://github.com/airbnb/native-navigation/blob/master/docs/api/navigator/registerScreen.md

Demonstrates how to register a React Native screen (`ScreenOne`) with `native-navigation` using a 'Thunk' (lazy value) to defer component loading until needed. This promotes separation of screen registration from screen definition.

```js
// register.js
import Navigator from 'native-navigation';

Navigator.registerScreen('ScreenOne', () => require('./ScreenOne'));
```

--------------------------------

### JavaScript Type Definition for NavigationResult

Source: https://github.com/airbnb/native-navigation/blob/master/docs/types/NavigationResult.md

Defines the `NavigationResult` type, which represents the outcome of a navigation operation. It includes a `code` property indicating success or cancellation (1 for OK, 0 for Cancelled) and a `payload` property for additional data.

```js
type RESULT_OK = 1;
type RESULT_CANCELLED = 0;

type NavigationResult = {
  code: RESULT_OK | RESULT_CANCELLED;
  payload: Object;
}
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.