4 min read

The status bar is situated at the top of your page and displays important information about the phone such as time, network connection, and battery status. While developing your Flutter app, you may want to change its color. Maybe the background color or the color of text and icon. So in this tutorial, we’ll see how to change status bar color in Flutter.

Here’s what we’ll cover:

Steps to change status bar color in Flutter

To change status bar color in Flutter, you should set the systemOverlayStyle. Inside the SystemUiOverlayStyle, you can use properties to specify the status bar color as well as the color for the icon and text.

Here’s how you do it:

  1. Locate the file where you have placed the AppBar widget.
  2. Inside the AppBar widget, add the systemOverlayStyle property.
  3. Inside the systemOverlayStyle assign the SystemUiOverlayStyle widget with three parameters.
  4. (Only for Android) Add the first parameter as statusBarColor and set the color.
  5. (Only for Android) add the second parameter as statusBarIconBrightness and set it to Brightness.dark (for black text and icons) or Brightness.light (for white text and icons).
  6. (Only for iOS) add the third parameter as statusBarBrightness and set it to Brightness.dark (for white text and icons) or Brightness.light (for black text and icons).
  7. Run the app.

Code Example:

AppBar(
  systemOverlayStyle: SystemUiOverlayStyle(
    statusBarColor: Colors.green, // <-- SEE HERE
    statusBarIconBrightness: Brightness.dark, //<-- For Android SEE HERE (dark icons)
    statusBarBrightness: Brightness.light, //<-- For iOS SEE HERE (dark icons)
  ),
  centerTitle: true,
  title: Row(
    mainAxisAlignment: MainAxisAlignment.center,
    children: [
      Image.asset(
        'assets/images/logo.png',
        scale: 12,
      ),
      const SizedBox(
        width: 10,
      ),
      const Text(
        'FlutterBeads',
        style: TextStyle(color: Colors.black),
      ),
    ],
  ),
)

Output:

change status bar color flutter - light color
statusBarColor: Colors.green, statusBarIconBrightness: Brightness.light, statusBarBrightness: Brightness.dark,
change status bar color flutter - dark color
statusBarColor: Colors.green, statusBarIconBrightness: Brightness.dark, statusBarBrightness: Brightness.light,

Changing status bar color globally

In the previous section, we saw how to change the status bar color at the page level. but sometimes you might be looking to have a common style across all the pages of your app. In that case, you might want to change the status bar color at the app level.

You can change the status bar color globally by defining the appBarTheme and then adding the AppBarTheme widget. Inside the AppBarTheme widget, you can specify the systemOverlayStyle parameter and then assign the actual color.

Steps to change status bar color globally:

  1. Locate the MaterialApp widget.
  2. Inside the MaterialApp, add the theme parameter with ThemeData class assigned.
  3. Inside the ThemeData add the appBarTheme parameter and then assign the AppBarTheme class.
  4. Inside the AppBarTheme, specify the systemOverlayStyle parameter and set the color.
  5. Inside the systemOverlayStyle assign the SystemUiOverlayStyle widget with three parameters.
  6. Add the first parameter as statusBarColor and set the color.
  7. (Only for Android) add the second parameter as statusBarIconBrightness and set it to Brightness.dark (for black text and icons) or Brightness.light (for white text and icons).
  8. (Only for iOS) add the third parameter as statusBarBrightness and set it to Brightness.dark (for white text and icons) or Brightness.light (for black text and icons).
  9. Run the app

Code Example:

MaterialApp(
  title: 'Flutter Demo',
  theme: ThemeData(
    primarySwatch: Colors.blue,
    appBarTheme: AppBarTheme(
      iconTheme: IconThemeData(color: Colors.black),
      color: Colors.deepPurpleAccent,
      foregroundColor: Colors.black,
      systemOverlayStyle: SystemUiOverlayStyle( //<-- SEE HERE
        // Status bar color
        statusBarColor: Colors.green,
        statusBarIconBrightness: Brightness.dark,
        statusBarBrightness: Brightness.light,
      ),
    ),
  ),
  home: ChangeStatusBarColorDemo(),
);

Changing status bar color without appbar

In the previous section, we saw changing the status bar color using the appbar. But what if you want to change the status bar color without the appbar. Here’s the solution. You can simply wrap your top widget inside another widget called AnnotatedRegion. Using the AnnotatedRegion’s value property, you can set the status bar color.

Code Example:

@override
Widget build(BuildContext context) {
  return AnnotatedRegion<SystemUiOverlayStyle>( 
    value: SystemUiOverlayStyle.dark, //<-- SEE HERE
    child: Scaffold(
      body: Center(
        child: Column(
          children: [
            SizedBox(
              height: 50,
            ),
            Container(
              width: 200,
              height: 200,
              color: Colors.red,
            ),
            ElevatedButton(
              onPressed: () {},
              child: const Text(
                'Elevated Button 1',
                style: TextStyle(fontSize: 24),
              ),
            ),
          ],
        ),
      ),
    ),
  );
}

Output:

change status bar color flutter without appbar

Conclusion

In this tutorial, we learned how to change status bar color in Flutter with practical examples, we first saw how to change the color at the page level and then explored the way to change color at the app level. Finally, we also learned how to change the status bar color for the pages that don’t have the appbar.

FAQs

How to make status bar transparent in flutter?

To make status bar transparent in flutter, you can use the SystemChrome class with statusBarColor: Colors.transparent from the flutter/services package.

Would you like to check other interesting Flutter tutorials?