---
modificationDate: January 22, 2026
title: Brightness
description: A library that provides access to an API for getting and setting the screen brightness.
sourceCodeUrl: 'https://github.com/expo/expo/tree/main/packages/expo-brightness'
packageName: 'expo-brightness'
iconUrl: '/static/images/packages/expo-brightness.png'
platforms: ['android', 'ios', 'expo-go']
---
## Submitting Feedback
If this page contains errors, outdated information, or gaps that blocked you from completing a task, report it so the docs can be improved:
curl -X POST https://api.expo.dev/v2/feedback/docs-send -H 'Content-Type: application/json' -d '{"url":"/versions/v55.0.0/sdk/brightness/","feedback":"🤖 Agent feedback: "}'
Only submit when you have something specific and actionable to report.
# Expo Brightness
A library that provides access to an API for getting and setting the screen brightness.
Android, iOS, Included in Expo Go
> For the complete documentation index, see [llms.txt](/llms.txt). Use this file to discover all available pages.
An API to get and set screen brightness.
On Android, there is a global system-wide brightness setting, and each app has its own brightness setting that can optionally override the global setting. It is possible to set either of these values with this API. On iOS, the system brightness setting cannot be changed programmatically; instead, any changes to the screen brightness will persist until the device is locked or powered off.
## Installation
```sh
npx expo install expo-brightness
```
If you are installing this in an [existing React Native app](/bare/overview), make sure to [install `expo`](/bare/installing-expo-modules) in your project.
## Configuration
Are you using this library in an existing React Native app?
If you're not using Continuous Native Generation ([CNG](/workflow/continuous-native-generation)) or you're using a native **android** project manually, then you need to add the `android.permission.WRITE_SETTINGS` permission to the **AndroidManifest.xml** file:
```xml
```
## Usage
```jsx
import { useEffect } from 'react';
import { StyleSheet, View, Text } from 'react-native';
import * as Brightness from 'expo-brightness';
export default function App() {
useEffect(() => {
(async () => {
const { status } = await Brightness.requestPermissionsAsync();
if (status === 'granted') {
Brightness.setSystemBrightnessAsync(1);
}
})();
}, []);
return (
Brightness Module Example
);
}
const styles = StyleSheet.create({
container: {
flex: 1,
backgroundColor: '#fff',
alignItems: 'center',
justifyContent: 'center',
},
});
```
## API
```js
import * as Brightness from 'expo-brightness';
```
## Hooks
### `usePermissions(options)`
Supported platforms: Android, iOS.
| Parameter | Type |
| --- | --- |
| `options`(optional) | `PermissionHookOptions