{"id":21440668,"url":"https://github.com/malaa-tech/react-native-intercom-expo-config-plugin","last_synced_at":"2025-08-24T01:17:00.348Z","repository":{"id":180745460,"uuid":"665646226","full_name":"Malaa-tech/react-native-intercom-expo-config-plugin","owner":"Malaa-tech","description":"Expo plugin for react-native-intercom","archived":false,"fork":false,"pushed_at":"2024-02-14T08:20:29.000Z","size":3792,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-05-14T15:22:01.310Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Malaa-tech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-07-12T17:06:18.000Z","updated_at":"2023-07-13T09:24:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"a45e05df-b162-4072-99af-199f977fb3f1","html_url":"https://github.com/Malaa-tech/react-native-intercom-expo-config-plugin","commit_stats":null,"previous_names":["malaa-tech/react-native-intercom-expo-config-plugin"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Malaa-tech%2Freact-native-intercom-expo-config-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Malaa-tech%2Freact-native-intercom-expo-config-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Malaa-tech%2Freact-native-intercom-expo-config-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Malaa-tech%2Freact-native-intercom-expo-config-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Malaa-tech","download_url":"https://codeload.github.com/Malaa-tech/react-native-intercom-expo-config-plugin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225986030,"owners_count":17555570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-23T01:17:18.401Z","updated_at":"2024-11-23T01:17:18.996Z","avatar_url":"https://github.com/Malaa-tech.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"This repo is a continuation on the work of https://github.com/expo/config-plugins since it is not updated frequently \n\n# Expo Config Plugin `@intercom/intercom-react-native`\n\nAn unofficial [Expo config plugin](https://docs.expo.io/guides/config-plugins) for easily setting up [React Native Intercom](https://github.com/intercom/intercom-react-native) with expo dev clients\n\n## Installation\n\n### Prerequisites\n\n#### Versions \u003e= 1.10\n\n- App project using Expo SDK 49.\n- Installed `expo-cli@4.4.4` or later.\n- Installed `@intercom/intercom-react-native@4.0.1`\n- For Android it Intercom requires `compileSdkVersion` and `targetSdkVersion` to be set on 33 or higher. [expo-build-properties](https://docs.expo.dev/versions/latest/sdk/build-properties/) is used to set it \n\n#### Versions \u003c 1.10\n\n- App project using Expo SDK 45.\n- Installed `expo-cli@4.4.4` or later.\n- Installed `@intercom/intercom-react-native@4.0.1`\n- For Android it Intercom requires `compileSdkVersion` and `targetSdkVersion` to be set on 33 or higher. [expo-build-properties](https://docs.expo.dev/versions/latest/sdk/build-properties/) is used to set it\n\n#### Versions \u003c 1.3\n\n- App project using Expo SDK 44.\n- Installed `expo-cli@4.4.4` or later.\n- Installed `@intercom/intercom-react-native`\n\n#### With `expo install`\n\n```\nexpo install react-native-intercom-expo-config-plugin expo-build-properties\n```\n\n#### Without `expo install`\n\n```sh\n# using yarn\nyarn add react-native-intercom-expo-config-plugin expo-build-properties\n\n# using npm\nnpm install react-native-intercom-expo-config-plugin expo-build-properties\n```\n\nOpen your `app.json` and update your `plugins` section:\n\n```json\n{\n  \"plugins\": [\n    [\n      \"expo-build-properties\",\n      { \"android\": { \"compileSdkVersion\": 33, \"targetSdkVersion\": 33 } }\n    ],\n    \"react-native-intercom-expo-config-plugin\"\n  ]\n}\n```\n\n## Configuration\n\nThe plugin needs your intercom api key so that it can communicate with the intercom application.\n\n```json\n{\n  \"plugins\": [\n    [\n      \"creact-native-intercom-expo-config-plugin\",\n      {\n        \"iosApiKey\": \"\u003cyour-api-key\u003e\",\n        \"androidApiKey\": \"\u003cyour-api-key\u003e\",\n        \"appId\": \"\u003cyour-app-id\u003e\"\n      }\n    ]\n  ]\n}\n```\n\n### Other configuration options\n\n\u003cdetails\u003e\n\u003csummary\u003eAdd a custom photo usage description\u003c/summary\u003e\n\n```json\n{\n  \"plugins\": [\n    [\n      \"react-native-intercom-expo-config-plugin\",\n      {\n        //...\n        \"iosPhotoUsageDescription\": \"Upload to support center\"\n      }\n    ]\n  ]\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eAdd EU Region support\u003c/summary\u003e\n\n### On iOS Add to `app.json`\n\n```json\n{\n  \"ios\": {\n    \"infoPlist:\":{\n        \"IntercomRegion\": \"EU\"\n      }\n  }\n}\n\n```\n\n### On Android\n```json\n{\n  \"plugins\": [\n    [\n      \"react-native-intercom-expo-config-plugin\",\n      {\n        //...\n        \"intercomEURegion\": \"true\"\n      }\n    ]\n  ]\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eEnable push notifications\u003c/summary\u003e\n\n### On iOS\n\n```json\n{\n  \"plugins\": [\n    [\n      \"react-native-intercom-expo-config-plugin\",\n      {\n        //...\n        \"isPushNotificationsEnabledIOS\": true\n      }\n    ]\n  ]\n}\n```\n### On Android\n\n```json\n{\n  \"plugins\": [\n    [\n      \"react-native-intercom-expo-config-plugin\",\n      {\n        //...\n        \"isPushNotificationsEnabledAndroid\": true,\n        \"androidIcon\": \"\u003cstring\u003e\" //Customize the icon for intercom push notifications from the intercom default\n      }\n    ]\n  ]\n}\n```\n\u003c/details\u003e\n\n## Android push notifications\nIf you want push notifications to fire when new messages are sent in a conversation, it is necesssary\nto create a push notification channel for these. Push notifications for new conversations require no additoonal setup.\n```jsx\nuseEffect(() =\u003e {\n  if (Platform.OS === 'android') {\n    Notifications.setNotificationChannelAsync('intercom_chat_replies_channel', {\n      name: 'Intercom Replies Channel',\n      description: 'Channel for intercom replies',\n      importance: Notifications.AndroidImportance.MAX,\n    })\n  }\n}, [])\n```\n\n\n## Building and running\n\nYou can either:\n\n- use `expo prebuild` or `expo run:android`/`expo run:ios` to update your native projects,\n- use _[EAS Build](https://docs.expo.io/build/introduction/)_ to build your development client.\n  - Keep in mind that if you are using environment variables for `androidApiKey`, `iosApiKey` and `appId` in your `app.config.js`, you need to configure these secrets with `eas secret:create` or at _[Expo](https://expo.dev)_.\n\n## Contributing\n\nContributions are very welcome! The package uses `expo-module-scripts` for most tasks. You can find detailed information [at this link](https://github.com/expo/expo/tree/master/packages/expo-module-scripts#-config-plugin).\n\nPlease make sure to run `yarn build`/`yarn rebuild` to update the `build` directory before pushing. The CI will fail otherwise.\n\n## Credits\n\n- _the Expo team_\n\n- \u003chttps://github.com/expo/config-plugins\u003e\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmalaa-tech%2Freact-native-intercom-expo-config-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmalaa-tech%2Freact-native-intercom-expo-config-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmalaa-tech%2Freact-native-intercom-expo-config-plugin/lists"}