Initial version

Author: Randy Coulman

.eslintrc.js

@@ -0,0 +1,10 @@
+module.exports = {
+  extends: [
+    "zeal",
+    "zeal/react",
+    "zeal/react-native",
+    "prettier",
+    "prettier/react"
+  ],
+  root: true
+};

CHANGELOG.md

@@ -0,0 +1,9 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.  This project adheres to [Semantic Versioning](http://semver.org/).
+
+## [Unreleased](https://github.com/CodingZeal/react-native-appstate-listener/compare/v1.0.0...HEAD)
+
+## 1.0.0 - 2017-06-02
+
+Happy birthday!

README.md

@@ -1,2 +1,89 @@
-# react-native-appstate-listener
-Adapt React Native AppState changes to the React component lifecycle
+# AppStateListener
+
+[![npm version](https://badge.fury.io/js/react-native-appstate-listener.svg)](https://www.npmjs.com/package/react-native-appstate-listener)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+Adapt React Native AppState changes to the React component lifecycle.
+
+Instead of setting up your own event listeners for `AppState` changes, include an `AppStateListener` component in your application, passing callbacks as props for the `AppState` changes you are interested in.  `AppStateListener` sets up the listeners for you and then calls your callbacks whenever `AppState` changes.
+
+If you're using [Redux](http://redux.js.org/) in your application and you'd rather have `AppState` changes mapped into Redux actions, see [redux-enhancer-react-native-appstate](https://www.npmjs.com/package/redux-enhancer-react-native-appstate).
+
+## Installation
+
+```
+yarn add react-native-appstate-listener
+```
+
+(or `npm install react-native-appstate-listener` if you prefer).
+
+## Usage
+
+When some part of your application needs to respond to `AppState` changes, add an `AppStateListener` to the relevant component.
+
+`AppStateListener` takes three callbacks as props:
+
+- `onActive` is called when the application starts running in the foreground.  This happens when it first starts up, or when returning from the background or inactive state. `onActive` is also called when the `AppStateListener` component is first mounted.
+
+- `onBackground` is called when the application moves into the background, either because the user switches to the home screen or another application.  `onBackground` is also called when the `AppStateListener` component is unmounted.
+
+- `onInactive` is called when the application moves into an inactive state.  This occurs when transitioning between foreground and background, and during periods of inactivity such as entering the Multitasking view or in the event of an incoming call.
+
+`AppStateListener` provides default callbacks that do nothing, so you only need to provide the callbacks you're interested in.
+
+## Example
+
+```js
+import React from "react";
+import { Text, View } from "react-native";
+import AppStateListener from "react-native-appstate-listener";
+
+function handleActive() {
+  console.log("The application is now active!");
+}
+
+function handleBackground() {
+  console.log("The application is now in the background!");
+}
+
+function handleInactive() {
+  console.log("The application is now inactive!");
+}
+
+export default function MyComponent() {
+  return (
+    <View>
+      <AppStateListener
+        onActive={handleActive}
+        onBackground={handleBackground}
+        onInactive={handleInactive}
+      />
+      <Text>Hello, World!</Text>
+    </View>
+  );
+}
+```
+
+## Contributing
+
+Pull requests are welcome!
+
+To get started:
+
+- Clone the project.
+
+- Run `yarn install` to install dependencies.
+
+- Make your desired changes.  We don't currently have any tests, but if you are adding significant functionality, please get in touch and we'll talk about how to introduce testing.
+
+- Ensure that you format the code with [prettier](https://www.npmjs.com/package/prettier) by running `yarn run format`.
+
+- Ensure that the code follows the current style guidelines by running `yarn run lint`.
+
+- Submit your pull request.
+
+## License
+
+Authored by the Engineering Team of [Zeal](https://codingzeal.com?utm_source=github).
+
+Copyright (c) 2017 Zeal, LLC.  Licensed under the [MIT license](https://opensource.org/licenses/MIT).

index.js

@@ -0,0 +1,51 @@
+import PropTypes from "prop-types";
+import React from "react";
+import { AppState } from "react-native";
+
+const noop = () => null;
+
+class AppStateListener extends React.PureComponent {
+  static propTypes = {
+    onActive: PropTypes.func.isRequired,
+    onBackground: PropTypes.func.isRequired,
+    onInactive: PropTypes.func.isRequired
+  };
+
+  static defaultProps = {
+    onActive: noop,
+    onBackground: noop,
+    onInactive: noop
+  };
+
+  componentDidMount() {
+    const { onActive } = this.props;
+
+    onActive();
+    AppState.addEventListener("change", this.handleAppStateChange);
+  }
+
+  componentWillUnmount() {
+    const { onBackground } = this.props;
+
+    onBackground();
+    AppState.removeEventListener("change", this.handleAppStateChange);
+  }
+
+  handleAppStateChange = newState => {
+    const { onActive, onBackground, onInactive } = this.props;
+    const callbacks = {
+      active: onActive,
+      background: onBackground,
+      inactive: onInactive
+    };
+    const callback = callbacks[newState] || noop;
+
+    callback();
+  };
+
+  render() {
+    return null;
+  }
+}
+
+export default AppStateListener;

package.json

@@ -0,0 +1,55 @@
+{
+  "name": "react-native-appstate-listener",
+  "version": "1.0.0",
+  "description": "Adapt React Native AppState changes to the React component lifecycle",
+  "main": "index.js",
+  "files": ["index.js"],
+  "scripts": {
+    "format": "prettier --write '**/*.js'",
+    "lint": "eslint '**/*.js' --max-warnings 0",
+    "precommit": "lint-staged",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CodingZeal/react-native-appstate-listener.git"
+  },
+  "author": "Randy Coulman <[email protected]> (http://open.codingzeal.com)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/CodingZeal/react-native-appstate-listener/issues"
+  },
+  "homepage": "https://github.com/CodingZeal/react-native-appstate-listener#readme",
+  "keywords": [
+    "react-native-component",
+    "react-component",
+    "react-native",
+    "appstate",
+    "ios",
+    "android"
+  ],
+  "lint-staged": {
+    "*.js": "prettier --list-different"
+  },
+  "dependencies": {
+    "prop-types": "^15.5.10"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "devDependencies": {
+    "babel-eslint": "^7.2.3",
+    "eslint": "^3.19.0",
+    "eslint-config-prettier": "^2.1.1",
+    "eslint-config-zeal": "^1.0.0",
+    "eslint-plugin-import": "^2.3.0",
+    "eslint-plugin-react": "^7.0.1",
+    "eslint-plugin-react-native": "^2.3.2",
+    "husky": "^0.13.4",
+    "lint-staged": "^3.6.0",
+    "prettier": "^1.4.0",
+    "react": "16.0.0-alpha.6",
+    "react-native": "^0.44.2"
+  }
+}