### Start React Native Metro Packager

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/CONTRIBUTING.md

This command starts the Metro packager for the example application, allowing JavaScript code changes to be reflected without a rebuild.

```sh
yarn example start
```

--------------------------------

### Run React Native Example App on iOS

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/CONTRIBUTING.md

Execute this command to build and run the example application on an iOS device or simulator. Native code changes will require a rebuild of the app.

```sh
yarn example ios
```

--------------------------------

### Run React Native Example App on Android

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/CONTRIBUTING.md

Execute this command to build and run the example application on an Android device or emulator. Native code changes will require a rebuild of the app.

```sh
yarn example android
```

--------------------------------

### Install react-native-ringer-mode package

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/README.md

Instructions to install the `react-native-ringer-mode` package using npm, which is required before utilizing its functionalities in a React Native project.

```sh
npm install react-native-ringer-mode
```

--------------------------------

### Install Project Dependencies with Yarn

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/CONTRIBUTING.md

This command installs all required dependencies for the project's packages from the root directory. It is recommended to use Yarn over npm for development.

```sh
yarn
```

--------------------------------

### Get current ringer mode with React Native getRingerMode function

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/README.md

Illustrates how to asynchronously fetch the current ringer mode of an Android device using the `getRingerMode` function. This example uses a `useEffect` hook to retrieve the mode when the component mounts and then displays it.

```js
import React, { useEffect, useState } from 'react';

import { View, Text } from 'react-native';
import {
  RINGER_MODE,
  getRingerMode,
  RingerModeType,
} from 'react-native-ringer-mode';

const modeText = {
  [RINGER_MODE.silent]: 'Silent',
  [RINGER_MODE.normal]: 'Normal',
  [RINGER_MODE.vibrate]: 'Vibrate',
};

export default function App() {
  const [mode, setMode] = useState<RingerModeType | undefined>();

  useEffect(() => {
    (async () => {
      try {
        const currentMode = await getRingerMode();
        setMode(currentMode);
      } catch (error) {
        console.error(error);
      }
    })();
  }, []);

  return (
    <View>
      <Text>Ringer Mode: {mode !== undefined ? modeText[mode] : null}</Text>
    </View>
  );
}
```

--------------------------------

### Get and set ringer mode using React Native useRingerMode hook

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/README.md

Demonstrates how to use the `useRingerMode` hook in a React Native component to dynamically retrieve and update the device's ringer mode. This example displays the current mode and provides interactive buttons to change it, also showing any potential error messages.

```js
import React from 'react';

import { View, Text, Button } from 'react-native';
import { useRingerMode, RINGER_MODE } from 'react-native-ringer-mode';

const modeText = {
  [RINGER_MODE.silent]: 'Silent',
  [RINGER_MODE.normal]: 'Normal',
  [RINGER_MODE.vibrate]: 'Vibrate',
};

export default function App() {
  const { mode, error, setMode } = useRingerMode();

  return (
    <View>
      <Text>Ringer Mode: {mode !== undefined ? modeText[mode] : null}</Text>

      <View>
        <Button title="Silent" onPress={() => setMode(RINGER_MODE.silent)} />
        <Button title="Normal" onPress={() => setMode(RINGER_MODE.normal)} />
        <Button title="Vibrate" onPress={() => setMode(RINGER_MODE.vibrate)} />
      </View>

      <View>
        <Text>{error?.message}</Text>
      </View>
    </View>
  );
}
```

--------------------------------

### Conventional Commit Message Types

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/CONTRIBUTING.md

Defines the standard commit message types used in the project, following the conventional commits specification, along with their purpose and examples.

```APIDOC
fix: bug fixes, e.g. fix crash due to deprecated method.
feat: new features, e.g. add new method to the module.
refactor: code refactor, e.g. migrate from class components to hooks.
docs: changes into documentation, e.g. add usage example for the module..
test: adding or updating tests, e.g. add integration tests using detox.
chore: tooling changes, e.g. change CI config.
```

--------------------------------

### Check and Request Do Not Disturb Access in React Native

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/README.md

This React Native example demonstrates how to use `checkDndAccess` and `requestDndAccess` from `react-native-ringer-mode`. It ensures the app has Do Not Disturb permission before attempting to change the ringer mode to or from silent, preventing errors on Android N+ devices.

```js
import React from 'react';
import { View, Button } from 'react-native';

import {
  useRingerMode,
  RINGER_MODE,
  checkDndAccess,
  requestDndAccess,
  RingerModeType,
} from 'react-native-ringer-mode';

export default function App() {
  const { mode, setMode } = useRingerMode();

  const changeMode = async (newMode: RingerModeType) => {
    // From N onward, ringer mode adjustments that would toggle Do Not Disturb
    // are not allowed unless the app has been granted Do Not Disturb Access.
    // @see https://developer.android.com/reference/android/media/AudioManager#setRingerMode(int)
    if (newMode === RINGER_MODE.silent || mode === RINGER_MODE.silent) {
      const hasDndAccess = await checkDndAccess();
      if (hasDndAccess === false) {
        // This function opens the DND settings.
        // You can ask user to give the permission with a modal before calling this function.
        requestDndAccess();
        return;
      }
    }

    setMode(newMode);
  };

  return (
    <View>
      <Button title="Silent" onPress={() => changeMode(RINGER_MODE.silent)} />
      <Button title="Normal" onPress={() => changeMode(RINGER_MODE.normal)} />
      <Button title="Vibrate" onPress={() => changeMode(RINGER_MODE.vibrate)} />
    </View>
  );
}
```

--------------------------------

### Project Scripts Reference

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/CONTRIBUTING.md

A list of common scripts available in the `package.json` file for various development tasks, providing quick access to frequently used commands.

```APIDOC
yarn bootstrap: setup project by installing all dependencies and pods.
yarn typescript: type-check files with TypeScript.
yarn lint: lint files with ESLint.
yarn test: run unit tests with Jest.
yarn example start: start the Metro server for the example app.
yarn example android: run the example app on Android.
yarn example ios: run the example app on iOS.
```

--------------------------------

### Publish New Versions to npm with Release-it

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/CONTRIBUTING.md

This command uses release-it to automate the publishing process, including bumping versions based on semver, creating tags, and releasing to npm.

```sh
yarn release
```

--------------------------------

### Verify Code Quality with TypeScript and ESLint

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/CONTRIBUTING.md

These commands run TypeScript for type checking and ESLint for linting, ensuring code adheres to quality standards before committing. Both checks must pass.

```sh
yarn typescript
yarn lint
```

--------------------------------

### Run Unit Tests with Jest

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/CONTRIBUTING.md

This command executes the project's unit tests using Jest, ensuring that code changes do not introduce regressions and existing functionality remains intact.

```sh
yarn test
```

--------------------------------

### Fix Code Formatting with ESLint

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/CONTRIBUTING.md

This command automatically fixes common formatting errors identified by ESLint, helping maintain consistent code style across the project.

```sh
yarn lint --fix
```

--------------------------------

### Add Do Not Disturb Permission to Android Manifest

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/README.md

Adds the necessary `ACCESS_NOTIFICATION_POLICY` permission to your `AndroidManifest.xml` file. This permission is required for your application to be able to request and manage Do Not Disturb access, allowing it to appear in the system's DND settings.

```xml
<uses-permission android:name="android.permission.ACCESS_NOTIFICATION_POLICY" />
```

--------------------------------

### Set ringer mode with React Native setRingerMode function

Source: https://github.com/reyhankaplan/react-native-ringer-mode/blob/master/README.md

Shows how to programmatically set the device's ringer mode using the `setRingerMode` asynchronous function. This snippet provides buttons to change the ringer mode to silent, normal, or vibrate, including basic error handling.

```js
import React from 'react';

import { View, Button } from 'react-native';
import {
  setRingerMode,
  RINGER_MODE,
  RingerModeType,
} from 'react-native-ringer-mode';

export default function App() {
  const setMode = (mode: RingerModeType) => {
    try {
      setRingerMode(mode);
    } catch (error) {
      console.error(error);
    }
  };
  return (
    <View>
      <Button title="Silent" onPress={() => setMode(RINGER_MODE.silent)} />
      <Button title="Normal" onPress={() => setMode(RINGER_MODE.normal)} />
      <Button title="Vibrate" onPress={() => setMode(RINGER_MODE.vibrate)} />
    </View>
  );
}
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.