# with-rn-get-social

> An Expo config plugin for painless setup of `getsocial-react-native-sdk`

Latest version **1.1.0** (published 2021-08-17) · MIT license · 0 weekly downloads

## Install

```sh
npm install with-rn-get-social
pnpm add with-rn-get-social
yarn add with-rn-get-social
bun add with-rn-get-social
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.0 |
| Published | 2021-08-17 |
| First published | 2021-08-17 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 15.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Hersey Aguilar |
| Maintainers | lhersey |
| Keywords | react-native, expo, config-plugins |

## Links

- npm: https://www.npmjs.com/package/with-rn-get-social
- Repository: https://github.com/lHersey/with-rn-get-social
- Homepage: https://github.com/lHersey/with-rn-get-social#readme
- Issues: https://github.com/lHersey/with-rn-get-social/issues
- npm.io page: https://npm.io/package/with-rn-get-social

## Dependencies (2)

- [glob](https://npm.io/package/glob.md) ^7.1.7
- [@expo/config-plugins](https://npm.io/package/@expo/config-plugins.md) ^3.0.7

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 1.1.0 (latest) — 2021-08-17
- 1.0.1 — 2021-08-17
- 1.0.0 — 2021-08-17

## README

# Expo - `with-rn-get-social`

An [Expo config plugin](https://docs.expo.io/guides/config-plugins) to setup [`getsocial-react-native-sdk`](https://docs.getsocial.im/guides/getting-started/react-native/), without touching native code


You can learn more about it here:

- [Config Plugins - Expo docs](https://docs.expo.io/guides/config-plugins)
- Expo Managed Workflow in 2021: [part 1](https://blog.expo.io/expo-managed-workflow-in-2021-5b887bbf7dbb), [part 2](https://blog.expo.io/expo-managed-workflow-in-2021-d1c9b68aa10)

## Getting started

Some points you need to be aware of before use this plugin
- **This plugin only works on Android**
- The plugin relays on regex to make some file modifications, so if it doesn't work with your configuration feel free to open an issue

## Installation

#### Prerequisites:

- App project using Expo SDK 41+.
- Installed `expo-cli@4.4.4` or later.
- Installed `getsocial-react-native-sdk` JavaScript libraries: `yarn add getsocial-react-native-sdk`

#### With `expo install`

```
expo install with-rn-get-social
```

#### Without `expo install`

```sh
# using yarn
yarn add with-rn-get-social

# using npm
npm install with-rn-get-social
```

Open your `app.json` or `app.config.js` and update your `plugins` section (`expo install` would do it for you):

```json
{
  "plugins": ["with-rn-get-social"]
}
```

## Configuration

The plugin needs to know the appId from `GetSocial`, you can read about how to configure GetSocial and get your appId on [Enable supported stores](https://docs.getsocial.im/guides/getting-started/react-native/#enable-supported-app-stores-on-the-dashboard)

Optionally you can pass the hostnames to configure the android manifest, if ommited default values will be used (`getsocialdemo5.gsc.im` and `getsocialdemo5-gsalt.gsc.im`) You can read more about in [Setup app links](https://docs.getsocial.im/knowledge-base/manual-integration/android/#setup-app-links-for-android-6)
```json
{
  "plugins": [
    [
      "with-rn-get-social", { appId: "YOUR_APP_ID_HERE", hostnames: ["HOSTNAME_1", "HOSTNAME_2"] }
    ]
  ]
}
```


## Building and running

You can either:

- Use `expo prebuild` or `expo run:android`/`expo run:ios` to update your native projects,
- Use _[EAS Build](https://docs.expo.io/build/introduction/)_ to build your development client.

## Credits

- The Expo team ❤️

## License

MIT

---
_Source: https://npm.io/package/with-rn-get-social · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._