react-navigation / experimental-transitioner

A navigator for custom screen transitions with React Navigation and React Native

React Navigation 7

Routing and navigation for your React Native apps.

Documentation can be found at reactnavigation.org.

This branch contains the code for the pre-release version of React Navigation 7. You can find the code for the latest stable version in the 6.x branch.

Package Versions

Name	Latest Version
@react-navigation/bottom-tabs
@react-navigation/core
@react-navigation/devtools
@react-navigation/drawer
@react-navigation/elements
@react-navigation/material-top-tabs
@react-navigation/native-stack
@react-navigation/native
@react-navigation/routers
@react-navigation/stack
react-native-tab-view

Contributing

Please read through our contribution guide to get started!

Installing from a fork on GitHub

Since we use a monorepo, it's not possible to install a package from the repository URL. If you need to install a forked version from Git, you can use gitpkg.

First install gitpkg:

yarn global add gitpkg

Then follow these steps to publish and install a forked package:

1. Fork this repo to your account and clone the forked repo to your local machine
2. Open a Terminal and cd to the location of the cloned repo
3. Run yarn to install any dependencies
4. If you want to make any changes, make them and commit
5. Run yarn lerna run prepack to perform the build steps
6. Now cd to the package directory that you want to use (e.g. cd packages/stack for @react-navigation/stack)
7. Run gitpkg publish to publish the package to your repo

After publishing, you should see something like this:

Package uploaded to [email protected]:<user>/<repo>.git with the name <name>

You can now install the dependency in your project:

yarn add <user>/<repo>.git#<name>

Remember to replace <user>, <repo> and <name> with right values.

experimental-transitioner's Issues

transitioner throws error, in real app and also the example app

From the example app

 [23:42:21] TypeError: TypeError: undefined is not an object (evaluating 'descriptors[transitionRouteKey].options')

This error is located at:
    in Transitioner (at createNavigator.js:59)
    in Navigator (at SceneView.js:9)
    in SceneView (at SwitchView.js:12)
    in SwitchView (at createNavigator.js:59)
    in Navigator (at createAppContainer.js:380)
    in NavigationContainer (at App.js:52)
    in RCTView (at View.js:60)
    in View (at LayoutContext.js:133)
    in RCTView (at View.js:60)
    in View (at LayoutContext.js:207)
    in InternalLayoutProvider (at LayoutContext.js:219)
    in LayoutProvider (at App.js:51)
    in App (at registerRootComponent.js:35)
    in RootErrorBoundary (at registerRootComponent.js:34)
    in ExpoRootComponent (at renderApplication.js:33)
    in RCTView (at View.js:60)
    in View (at AppContainer.js:102)
    in RCTView (at View.js:60)
    in View (at AppContainer.js:122)
    in AppContainer (at renderApplication.js:32)```

Is this package actually used by anything?

I am incredibly intrigued by what I think this package is trying to accomplish, but I can't tell if it should even be attempted to be used. As referenced in issue #5, using the Transitioner from this package with createNavigator does not work in either the example project or an external project. Also, the react-navigation package uses a Transitioner from the react-navigation-stack project, so it seems like this isn't used by anything related to react-navigation (at the moment at least).

Is this an artifact of a past time or idea that was never fleshed out? Something that used to work but has since been deprecated? Or is it being actively worked on and will be released properly in the future? Am I missing something?

I've been wrestling with it for a while and would love to know if I should continue to invest any time trying to use it.

Thanks for your help.