{"id":31506910,"url":"https://github.com/zoontek/react-native-navigation-bar","last_synced_at":"2026-02-26T12:10:37.581Z","repository":{"id":313649337,"uuid":"1051619424","full_name":"zoontek/react-native-navigation-bar","owner":"zoontek","description":"React Native StatusBar long-lost twin: A component to control your Android app's navigation bar.","archived":false,"fork":false,"pushed_at":"2025-11-29T12:12:43.000Z","size":499,"stargazers_count":81,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-30T07:41:01.706Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zoontek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["zoontek"]}},"created_at":"2025-09-06T11:30:22.000Z","updated_at":"2026-01-16T11:52:59.000Z","dependencies_parsed_at":"2025-09-08T03:00:51.299Z","dependency_job_id":null,"html_url":"https://github.com/zoontek/react-native-navigation-bar","commit_stats":null,"previous_names":["zoontek/react-native-navigation-bar"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/zoontek/react-native-navigation-bar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoontek%2Freact-native-navigation-bar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoontek%2Freact-native-navigation-bar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoontek%2Freact-native-navigation-bar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoontek%2Freact-native-navigation-bar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zoontek","download_url":"https://codeload.github.com/zoontek/react-native-navigation-bar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoontek%2Freact-native-navigation-bar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29858509,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-26T08:51:08.701Z","status":"ssl_error","status_checked_at":"2026-02-26T08:50:19.607Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-02T21:01:19.355Z","updated_at":"2026-02-26T12:10:37.573Z","avatar_url":"https://github.com/zoontek.png","language":"TypeScript","funding_links":["https://github.com/sponsors/zoontek"],"categories":[],"sub_categories":[],"readme":"# @zoontek/react-native-navigation-bar\n\nReact Native [`StatusBar`](https://reactnative.dev/docs/statusbar) long-lost twin: A component to control your Android app's navigation bar.\n\n[![mit licence](https://img.shields.io/dub/l/vibe-d?style=for-the-badge)](https://github.com/zoontek/react-native-navigation-bar/blob/main/LICENSE)\n[![npm version](https://img.shields.io/npm/v/@zoontek/react-native-navigation-bar?style=for-the-badge)](https://www.npmjs.com/package/@zoontek/react-native-navigation-bar)\n[![npm downloads](https://img.shields.io/npm/dt/@zoontek/react-native-navigation-bar?label=downloads\u0026style=for-the-badge)](https://www.npmjs.com/package/@zoontek/react-native-navigation-bar)\n\n\u003cimg width=\"210\" src=\"./docs/logo.svg\" alt=\"Logo\"\u003e\n\n## Credits\n\nThis project has been built and is maintained thanks to the support from [Expo](https://expo.dev).\n\n\u003ca href=\"https://expo.io\"\u003e\n  \u003cimg width=\"180\" src=\"./docs/expo.svg\" alt=\"Expo\"\u003e\n\u003c/a\u003e\n\n## Installation\n\n```bash\n$ npm i -S @zoontek/react-native-navigation-bar\n# --- or ---\n$ yarn add @zoontek/react-native-navigation-bar\n```\n\n\u003e [!IMPORTANT]\n\u003e This library requires React Native 0.81+ or Expo 54+ with edge-to-edge enabled. To turn it on, set `edgeToEdgeEnabled` to `true` in your project's `gradle.properties` file (this step is not required for Expo, as it is enabled by default).\n\n```ruby\nedgeToEdgeEnabled=true # 👈 set this to true\n```\n\n## Considerations\n\n### Transparency\n\nCompared to [`react-native-edge-to-edge`](https://github.com/zoontek/react-native-edge-to-edge), this library adopts React Native [`StatusBar`](https://reactnative.dev/docs/statusbar) API and its defaults: the navigation bar is transparent with a `light-content` bar style. To enforce a contrasting (semi-opaque) button navigation bar, set the `enforceNavigationBarContrast` option to `true`.\n\n#### React Native\n\nEdit your `android/app/src/main/res/values/styles.xml` file to add the `enforceNavigationBarContrast` attribute:\n\n```xml\n\u003cresources\u003e\n  \u003cstyle name=\"AppTheme\" parent=\"Theme.AppCompat.DayNight.NoActionBar\"\u003e\n    \u003c!-- … --\u003e\n    \u003c!-- enforce a contrasting navigation bar background (optional) --\u003e\n    \u003citem name=\"enforceNavigationBarContrast\"\u003etrue\u003c/item\u003e\n  \u003c/style\u003e\n\u003c/resources\u003e\n```\n\n#### Expo\n\nAdd the library plugin to your app configuration file and [create a new build](https://docs.expo.dev/develop/development-builds/create-a-build) 👷:\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cstrong\u003eDynamic configuration (app.config.js, app.config.ts)\u003c/strong\u003e\u003c/summary\u003e\n\n```ts\nimport type { ConfigContext, ExpoConfig } from \"expo/config\";\nimport navigationBar from \"@zoontek/react-native-navigation-bar/expo\"; // use `require` in app.config.js\n\nexport default ({ config }: ConfigContext): ExpoConfig =\u003e ({\n  plugins: [\n    navigationBar({\n      android: { enforceNavigationBarContrast: true },\n    }),\n  ],\n});\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eStatic configuration (app.json)\u003c/strong\u003e\u003c/summary\u003e\n\n```json\n{\n  \"expo\": {\n    \"plugins\": [\n      [\n        \"@zoontek/react-native-navigation-bar\",\n        { \"android\": { \"enforceNavigationBarContrast\": true } }\n      ]\n    ]\n  }\n}\n```\n\n\u003c/details\u003e\n\n## API\n\n### NavigationBar\n\nA React component to control the Android button navigation bar (with back / home / recents buttons).\n\n\u003e [!NOTE]\n\u003e This component has no effect on other platforms or when gesture navigation is used.\n\n```tsx\nimport { NavigationBar } from \"@zoontek/react-native-navigation-bar\";\n\ntype NavigationBarStyle = \"default\" | \"light-content\" | \"dark-content\";\n\ntype NavigationBarProps = {\n  barStyle?: NavigationBarStyle; // set the color of the navigation bar content\n  hidden?: boolean; // hide the navigation bar\n};\n\nconst App = () =\u003e (\n  \u003c\u003e\n    \u003cNavigationBar barStyle=\"light-content\" /\u003e\n    {/* … */}\n  \u003c/\u003e\n);\n```\n\n#### NavigationBar.pushStackEntry\n\nPush a `NavigationBar` entry onto the stack. The return value should be passed to `popStackEntry` when complete.\n\n```ts\nconst entry: NavigationBarProps = NavigationBar.pushStackEntry(\n  props /*: NavigationBarProps */,\n);\n```\n\n#### NavigationBar.popStackEntry\n\nRemove an existing `NavigationBar` stack entry from the stack.\n\n```ts\nNavigationBar.popStackEntry(entry /*: NavigationBarProps */);\n```\n\n#### NavigationBar.replaceStackEntry\n\nReplace an existing `NavigationBar` stack entry with new props.\n\n```ts\nconst entry: NavigationBarProps = NavigationBar.replaceStackEntry(\n  entry /*: NavigationBarProps */,\n  props /*: NavigationBarProps */,\n);\n```\n\n#### NavigationBar.setBarStyle\n\nSet the navigation bar style.\n\n```ts\nNavigationBar.setBarStyle(style /*: NavigationBarStyle */);\n```\n\n#### NavigationBar.setHidden\n\nShow or hide the navigation bar.\n\n```ts\nNavigationBar.setHidden(style /*: boolean */);\n```\n\n## Troubleshooting 🤔\n\n#### The bar style blinks at app start\n\nSince the navigation bar is set at runtime rather than through themes, you may notice a brief style change at startup. This can be avoided by [adding a splash screen](https://github.com/zoontek/react-native-bootsplash).\n\n#### The bar style behavior is erratic\n\nThere's currently [an open issue](https://issuetracker.google.com/issues/346386744) with the Android 15 emulator image regarding the navigation bar style when it is fully transparent. This issue does not occur on physical devices.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoontek%2Freact-native-navigation-bar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzoontek%2Freact-native-navigation-bar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoontek%2Freact-native-navigation-bar/lists"}