# Running the Sample App with Expo

The best way to familiarize yourself with the social.plus UIKit is by exploring our built-in sample app. This application serves as a live demonstration of the toolkit's capabilities and can be used to test your code while customizing it. Feel free to deep-dive into the features and the extendibility of our UIKit using this application!

Follow these easy steps:

1. **Install Packages**: Use yarn to install all the necessary packages by running the command

```
yarn
```

2. **Configuration**: Configure your apiKey, apiRegion, userId, and displayName in the [/example/src/App.tsx](https://github.com/AmityCo/Amity-Social-UIKit-React-Native-OpenSource/blob/main/example/src/App.tsx) file before launching the sample app.

<figure><img src="/files/2MHi8BYotQfMnBE4Fi3I" alt=""><figcaption></figcaption></figure>

3. **Run the Sample App**: Choose between iOS or Android using

```
yarn example ios
```

or

```
yarn example android
```

<figure><img src="/files/BIk68iqsJUAbjXtPytWM" alt="" width="563"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.social.plus/social-plus-uikit/uikit-3/react-native-beta/running-the-sample-app-with-expo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
