Enables seamless status bar customization across Android and iOS, offering unified API for color configuration, edge-to-edge design support, and independent system bar control.
A Kotlin Multiplatform library for managing status bar appearance in Compose applications. While
Android's enableEdgeToEdge can handle status bar management, iOS lacks a direct equivalent. This
library provides a unified solution for both platforms, making status bar management seamless across
Android and iOS.
| Default iOS Status Bar | Custom Status Bar |
|---|---|
 |  |
| Default Android Status Bar | Custom Status Bar |
|---|---|
 |  |
Status bar customization with compose-statusbar on both platforms
enableEdgeToEdgeAdd the dependency to your project:
dependencies {
implementation("io.github.bentleypark:compose-statusbar:1.0.6")
}
While Android provides enableEdgeToEdge() for status bar management, iOS lacks equivalent
functionality in SwiftUI. This library bridges that gap by offering:
Basic usage examples:
// Basic status bar configuration
@Composable
fun BasicExample() {
ConfigureStatusBar(
color = Color.Green,
onDispose = { /* Optional cleanup */ }
)
// Your screen content
}
// Status bar with bottom bar configuration
@Composable
{
ConfigureStatusBar(
color = Color.Green,
bottomBarColor = Color.White,
onDispose = { }
)
}
Note: bottomBarColor is optional. When not specified, the bottom bar (navigation bar on Android,
tab bar on iOS) remains in its default state.
Check out the sample app in the sample directory for comprehensive examples demonstrating various
features and implementation patterns.
MIT License
Copyright (c) 2025 Bentley Park
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Surfaced from shared tags and platforms — no rankings paid for.