# React Native generator

![List](images/react-native/create-client-react-native-list.png)

## Install

To use this generator you need [Node.js](https://nodejs.org/).

Create a React Native application using [Expo CLI](https://docs.expo.io/workflow/expo-cli/):

```console
npm install -g expo-cli
npm init expo-app my-app
```

When asked, choose to use the blank template, then move to the created directory:

```console
cd my-app
```

Install the required dependencies:

```console
npm install redux react-redux redux-thunk redux-form react-native-elements react-native-router-flux react-native-vector-icons prop-types whatwg-url buffer react-native-event-source react-native-gesture-handler react-native-reanimated react-native-screens
````

## Generating a Native App

In the app directory, generate the files for the resource you want:

```console
npm init @api-platform/client https://demo.api-platform.com . -- --generator react-native --resource book
```

Replace the URL with the entrypoint of your Hydra-enabled API.
You can also use an OpenAPI documentation with `-f openapi3`.

Omit the resource flag to generate files for all resource types exposed by the API.

Create a `Router.js` file to import all routes:

```javascript
// Router.js
import React from 'react';
import { Router, Stack } from 'react-native-router-flux';
// Replace "book" with the name of the resource type
import BookRoutes from './routes/book';

const RouterComponent = () => (
  <Router>
    <Stack key="root">
      {BookRoutes}
    </Stack>
  </Router>
);

export default RouterComponent;
```

Here is an example of an `App.js` file:

```javascript
// App.js
import React, { Component } from 'react';
import { Provider } from 'react-redux';
import thunk from 'redux-thunk';
import { createStore, applyMiddleware, combineReducers } from 'redux';
import { View } from 'react-native';
import {reducer as form} from 'redux-form';

// see https://github.com/facebook/react-native/issues/14796
import { Buffer } from 'buffer';
global.Buffer = Buffer;

// see https://github.com/facebook/react-native/issues/16434
import { URL, URLSearchParams } from 'whatwg-url';
global.URL = URL;
global.URLSearchParams = URLSearchParams;

// see https://github.com/facebook/react-native/issues/12890
import RNEventSource from 'react-native-event-source';
global.EventSource = RNEventSource;

// Replace "book" with the name of resource type
import book from './reducers/book';
import Router from './Router';

export default class App extends Component {
  render() {
    const store = createStore(combineReducers({
      book,
      form
    }), {}, applyMiddleware(thunk));
    return (
      <Provider store={store}>
        <View style={{flex: 1}}>
          <Router/>
        </View>
      </Provider>
    );
  }
}
```

The code is ready to be executed!

```console
expo start
```

## Screenshots in iOS Simulator

![List](images/react-native/create-client-react-native-list.png) ![Show](images/react-native/create-client-react-native-show.png)
![Add](images/react-native/create-client-react-native-add.png) ![Delete](images/react-native/create-client-react-native-delete.png)