Skip to content

chore: deprecate createMaterialBottomTabNavigator #4694

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Apr 30, 2025

Conversation

lukewalczak
Copy link
Member

@lukewalczak lukewalczak commented Apr 23, 2025

Motivation

createMaterialBottomTabNavigator deprecation

This merge request drops support for createMaterialBottomTabNavigator, reflecting its deprecation since version 5.14.0 of react-native-paper.

For historical context, createMaterialBottomTabNavigator was introduced as part of the react-native-paper library due to its ability to animate transitions between tabs. Currently, the same feature, along with many others, is supported in the latest version of @react-navigation/bottom-tabs.

Supporting createMaterialBottomTabNavigator for both versions of react-navigation comes with typing issues that will require different annotations.

The example and related references to MaterialBottomTabNavigatorExample have been deleted to prevent confusion and to encourage migration to the supported solution.

createBottomTabNavigator as replacement

The documentation has been updated to clearly inform users about the deprecation and to recommend using createBottomTabNavigator from @react-navigation/bottom-tabs version 7.x or higher in combination with BottomNavigation.Bar for a Material Design look.

image

Users can also explore the snack example, which demonstrates how to combine createBottomTabNavigator with BottomNavigation.Bar.

Related issue

Fixes: #4601
Fixes: #4572

Test plan

@callstack-bot
Copy link

callstack-bot commented Apr 23, 2025

Hey @lukewalczak, thank you for your pull request 🤗. The documentation from this branch can be viewed here.

Copy link

The mobile version of example app from this branch is ready! You can see it here.

@lukewalczak lukewalczak added this to the 5.14.0 milestone Apr 23, 2025
@lukewalczak lukewalczak force-pushed the chore/support-navigation-v7 branch from d226905 to b606414 Compare April 29, 2025 08:38
@lukewalczak lukewalczak changed the title chore: react-navigation v7 support chore: deprecate createMaterialBottomTabNavigator Apr 29, 2025
@lukewalczak lukewalczak marked this pull request as ready for review April 29, 2025 08:45
@lukewalczak lukewalczak force-pushed the chore/support-navigation-v7 branch 3 times, most recently from 00332b0 to 4b3831e Compare April 30, 2025 09:06
@lukewalczak lukewalczak force-pushed the chore/support-navigation-v7 branch from 4b3831e to 52a0642 Compare April 30, 2025 09:59
@lukewalczak lukewalczak merged commit 53ca1f6 into main Apr 30, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add React Navigation 7 Support Incorrect types for createMaterialBottomTabNavigator
2 participants