@nativescript-community/systemui

Provides API for changing the styles of SystemUI (StatusBar, NavigationBar...) on iOS.
3,744 11
Install
npm install @nativescript-community/systemui
Latest Version:1.1.26
License:MIT
Last Updated:Oct 21, 2026
Links: GitHub  ·  npm
Maintainer: classicoldsong

NativeScript System UI

A NativeScript plugin to change System UI.

IOS

To show/hide the statusBar you need to have UIViewControllerBasedStatusBarAppearance set to false in your Info.plist

Usage

npm install @nativescript-community/systemui --save

If you are using version ^1.0.0 then we now use mixins

import { installMixins } from '@nativescript-community/systemui';
installMixins();

Then new properties are added to the Page class See typings for properties types. (they are added to Page type)

  • statusBarColor (css property status-bar-color)
  • statusBarStyle (css property status-bar-style)
  • statusBarHidden (css property status-bar-hidden)
  • navigationBarColor (css property navigation-bar-color)
  • navigationBarStyleANDROID (css property navigation-bar-style)
  • windowBgColorIOS (css property window-bg-color)
  • keepScreenAwake (css property keep-screen-awake)
  • screenOrientation (css property screen-orientation)
  • screenBrightness (css property screen-brightness)

Development workflow

If you would like to contribute to this plugin in order to enabled the repositories code for development follow this steps:

  • Fork the repository locally
  • Open the repository in your favorite terminal
  • Navigate to the src code that contains the plugin's code cd /src
  • Execute the npm script nmp run build.wrappers or npm run build.wrappers.watch
  • When running the Vanila NativeScript demo app execute: npm run demo.android or npm run demo.ios
  • When running the Angular NativeScript demo app execute: npm run demo.angular.android or npm run demo.angular.ios

Related Packages

@akylas/nativescript-app-utils

Provides API for changing the styles of SystemUI (StatusBar, NavigationBar...) o...

3,900 0
@nativescript-community/ui-checkbox

Checkbox: Material 3 MaterialCheckBox on Android, SF Symbols toggle button on iO...

7,082 1
@nativescript-community/perms

An unified permissions API for NativeScript on iOS and Android.

171,921 15
@nativescript-community/ui-canvas

Implement Canvas into your NativeScript apps.

45,311 38
@nativescript-community/ui-label

Alternative to the built-in NativeScript Label but with better performance and a...

34,779 20

Version History

Version Released License
1.1.26 MIT
1.1.25 MIT
1.1.24 MIT
1.1.23 MIT
1.1.22 MIT