Skip to main content

⚙️ Global notifications settings

The react-native-notificated library gives you a lot of possibilities to change the default configuration.

In the beginning, you can set the configuration for all the notifications used in the app.

Let's take a look at what exactly can we set globally:

durationNumber3000Use this property to set how long the notifications should be displayed on the screen. Value expressed in milliseconds.
notificationPosition'top' / 'top-right' / 'top-left' / 'center' / 'bottom' / 'bottom-right' / 'bottom-left''top'Set where the notifications should appear on the screen. You can choose one of seven default options: top / top-right / top-left / center / bottom / bottom-right / bottom-left. To read more about the notification position please go to the NOTIFICATION POSITION section.
notificationWidthNumber343Use this property to set the width, in pixels, of the notifications that will be displayed on the screen.
animationConfigObjectSlideInLeftSlideOutRightProperty responsible for the notification animation. You can set one of the animations prepared by us, or make your own config. To read more about the animation settings please go to the ANIMATIONS SETTINGS section.
isNotchBooleanfalseProperty responsible for read if the device has notch. You can use one of the libraries (for example 'react-native-device-info') to read if the specific device has Notch and pass the value here.
gestureConfigObjectiOS: 'y' / android: 'x'Object responsible for setting gesture direction that triggers swipe-dismiss of notification. To read more about gesture config, please go to the GESTURE CONFIG section.
defaultStylesSettingsObject-Object responsible for setting global styles for the notifications. You can also set here styles, for all the notifications of the specific type. For example for the error notifications. To read more about global style settings please go to the GLOBAL STYLES SETTINGS section.

Here we can see the global notifications settings in their basic form with default settings:

const { useNotifications, NotificationsProvider } = createNotifications({
duration: 300,
notificationPosition: 'top',
animationConfig: SlideInLeftSlideOutRight,
isNotch: undefined,
defaultStylesSettings: {},
gestureConfig: { direction: 'y' },

Notch handling

The library handles notch detection automatically so you don't have to worry about configuring this on your side. However, if you wish to take control over this by yourself, you can do that by declaring isNotch property in the global config.

const { useNotifications, NotificationsProvider } = createNotifications({
isNotch: true,

Feel free to use for example react-native-device-info.