react-native-override-color-scheme

react-native-override-color-scheme

React Native package to let users override the app's color scheme/theme

Installation

npm install react-native-override-color-scheme

or

yarn add react-native-override-color-scheme

RN >= 0.60

If you are using RN >= 0.60, only run npx pod-install. Then rebuild your project.

iOS

Optional support for alerts on iOS

:warning: By default, overriding the interface style (light or dark) using this package doesn't work for alerts on iOS. We use method swizzling for the viewWillAppear method of UIAlertController class which might create problems in some cases (for example, if another package is also swizzling the same class method). That's why we have made this step optional.

To enable this, please follow the steps below:

• Open your /ios/{projectName}/AppDelegate.m file
• At the top of the file, import the OverrideColorScheme module: #import <OverrideColorScheme.h>
• And then, within your existing didFinishLaunchingWithOptions method, add [OverrideColorScheme fixAlerts]; to the top of the method (see below).

#import <OverrideColorScheme.h> // <--- import

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  [OverrideColorScheme fixAlerts]; // <--- and add this line
  //...
}

Android

No additional step is required.

Usage

import overrideColorScheme from 'react-native-override-color-scheme';

// ...

overrideColorScheme.setScheme('dark'); // or `light` or `undefined` for system default

See the example for advanced use cases.

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT