Skip to main content
The values belong to your app. When it is closed or sent to the background the shell restores its own appearance, and reapplies yours when your app becomes active again. Both hooks return stable objects, so they are safe in an effect’s dependency list.

Options

'light' | 'dark'
Text and icon color. 'light' means white icons, for dark backgrounds.
string
Painted by the shell behind the bar.
boolean
Hide the bar entirely, for an immersive reader or video player. Shown again when your app closes.
The navigation bar exists only on Android; on iOS useNavigationBar / setNavigationBar are ignored. Without hooks, use setStatusBar(options) and setNavigationBar(options).