> For the complete documentation index, see [llms.txt](https://henkcorporaal.gitbook.io/react-native-share-app-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://henkcorporaal.gitbook.io/react-native-share-app-theme/installation.md).

# Installation

Finished your purchase? Then you completed the hardest part, because installation of the application can be done in a few simple steps.

{% hint style="warning" %}
**Skip (Step 1 and Step 2) if you already have node and npm or yarn installed.**
{% endhint %}

**Step 1: Install Homebrew** 

Homebrew is "The missing package manager for macOS". Open terminal and type the following command.

```
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```

This will install Homebrew on your Mac. To check the version type the following command:

```
$ brew -v
```

**Step 2: Install Node via Homebrew**

In the terminal type the following command to install Node:

```
$ brew install node

or

$ brew install yarn         # this will install node and yarn
```

If everything installed successfully then you can type in the following command in the terminal to check the Node and NPM version.

```
$ node -v

$ npm -v
```

**Step 3: Get the command line tool**

You will run this tool locally to package, test, and publish your projects:

```
npm install expo-cli --global
```

**Step 4: Clone the app from the repo**

Clone the repo into your local disk. You can name it whichever name you like:

```
$ git clone [app_repo_url] [your_chosen_name]

$ cd [your_chosen_name]
```

**Step 5: Setup Facebook App Id & Google Client Ids**

The application offers social login and signup functionality. For this feature to work, you will need to update a number of variable strings that are located inside `/config/constants.js:`

```
// FACEBOOK / GOOGLE LOGIN DEVELOPER IDS
export const FB_APP_ID = '';
export const FB_APP_NAME = '';
export const GOOGLE_ANDROID_CLIENT_ID = '';
export const GOOGLE_IOS_CLIENT_ID = '';
```

A complete tutorial about how apply for and activate your personal Facebook and Google login API can be found in [this step-by-step tutorial](https://medium.com/@henkcorporaal/react-native-social-login-2a7945fa19) that I've written on this topic.

**Step 6: Install and test the app**

```
$ yarn install

$ yarn start
```

{% hint style="warning" %}
**Test on your phone or on your laptop/desktop**

If you'd like to test your app on your device, then visit your app store and install the Expo app on your device, [or follow this link](https://expo.io/tools#client) and download on your device.

If you'd like to test your app on your laptop / desktop with iOS simulator, then follow [these installation instructions](https://docs.expo.io/workflow/ios-simulator/).

If you'd like to test your app on your laptop / desktop with android emulator, then follow [these installation instructions](https://docs.expo.io/workflow/android-studio-emulator/).
{% endhint %}