Facebook Account Kit SDK wrapper for React Native
Clone or download
Latest commit 6ae9115 Sep 18, 2018



A Facebook Account Kit SDK wrapper for react-native.

Supported versions - React Native / Facebook Account Kit

The table below shows the supported versions of React Native and the different versions of react-native-facebook-account-kit.

React Native Facebook Account Kit 0.4.x 0.6.x 0.10.x 1.0.x
React Native 0.24 <0.48 0.48-56 0.57

For RN <0.40.0 Check the Troubleshooting Guide


yarn add react-native-facebook-account-kit


Semi-automatic (suggested)

react-native link react-native-facebook-account-kit
  • Done!
iOS (via Cocoapods)
  1. Undo changes in iOS folder (which were made by react-native-link) in order to avoid duplicate compilations

    git checkout ios
  2. Add RNAccountKit Pod to your Podfile (if you don't have a podfile follow these instructions)

    target 'MyApp' do
    +  pod 'RNAccountKit', :path => '../node_modules/react-native-facebook-account-kit/ios'
  3. Run pod install in your ios folder

iOS (without Cocoapods)
  1. Open your project with XCode

  2. Open with Finder the node_modules/react-native-facebook-account-kit/ios folder

  3. Drag and drop AccountKit.framework and AccountKitStrings.bundle from Finder to your project in XCode (IMPORTANT: select the "Copy items if needed" option)



Add your Facebook credentials to your project's Info.plist file

  <plist version="1.0">

This is the minimal required configuration. Take a look to the Account Kit documentation for iOS for a more detailed guide.

  1. In android/app/src/main/res/values/strings.xml
<string name="fb_app_id">YOUR_FACEBOOK_APP_ID</string>
<string name="ak_client_token">YOUR_CLIENT_TOKEN</string>
  1. In android/app/src/main/AndroidManifest.xml
        android:value="@string/fb_app_id" />
        android:value="@string/app_name" />
        android:value="@string/ak_client_token" />
  1. Check the RNAccountKitPackage is registered in your MainApplication.java file. This should be done by react-native link but sometimes it doesn't. You should see something like the following
protected List<ReactPackage> getPackages() {
    return Arrays.<ReactPackage>asList(
        new MainReactPackage(),
        new RNAccountKitPackage() // <-- the package is registered

This is the minimal required configuration. Take a look to the Account Kit documentation for Android for a more detailed guide.

(Optional) Exclude backup for Access Tokens on Android >= 6.0

As per this documentation, Account Kit does not support automated backup (introduced in Android 6.0). The following steps will exclude automated backup

  1. Create a file android/app/src/main/res/xml/backup_config.xml that contains the follwoing:
<?xml version="1.0" encoding="utf-8"?>
  <exclude domain="sharedpref" path="com.facebook.accountkit.AccessTokenManager.SharedPreferences.xml"/>
  1. In your AndroidManifest.xml add the following to exclude backup of Account Kit's Access Token.
  //other configurations here
  android:fullBackupContent="@xml/backup_config" // add this line


import RNAccountKit, {
} from 'react-native-facebook-account-kit'

  theme: {
    // Background
    backgroundColor: Color.rgba(0, 120, 0, 0.1),
    backgroundImage: 'background.png',
    // Button
    buttonBackgroundColor: Color.rgba(0, 153, 0, 1.0),
    buttonBorderColor: Color.rgba(0, 255, 0, 1),
    buttonTextColor: Color.rgba(0, 255, 0, 1),
    // Button disabled
    buttonDisabledBackgroundColor: Color.rgba(100, 153, 0, 0.5),
    buttonDisabledBorderColor: Color.rgba(100, 153, 0, 0.5),
    buttonDisabledTextColor: Color.rgba(100, 153, 0, 0.5),
    // Header
    headerBackgroundColor: Color.rgba(0, 153, 0, 1.0),
    headerButtonTextColor: Color.rgba(0, 153, 0, 0.5),
    headerTextColor: Color.rgba(0, 255, 0, 1),
    // Input
    inputBackgroundColor: Color.rgba(0, 255, 0, 1),
    inputBorderColor: Color.hex('#ccc'),
    inputTextColor: Color.hex('#0f0'),
    // Others
    iconColor: Color.rgba(0, 255, 0, 1),
    textColor: Color.hex('#0f0'),
    titleColor: Color.hex('#0f0'),
    // Header
    statusBarStyle: StatusBarStyle.LightContent, // or StatusBarStyle.Default

To see the statusBarStyle reflected you must set the UIViewControllerBasedStatusBarAppearance property to true on your app's Info.plist file. You can do it from XCode screen shot 2016-08-02 at 11 44 07 am


Check this commit to see how it's done in our sample app

  1. In your application styles.xml file (usually located in android/app/src/main/res/values folder) create a Theme with the following schema
<style name="LoginThemeYellow" parent="Theme.AccountKit">
    <item name="com_accountkit_primary_color">#f4bf56</item>
    <item name="com_accountkit_primary_text_color">@android:color/white</item>
    <item name="com_accountkit_secondary_text_color">#44566b</item>
    <item name="com_accountkit_status_bar_color">#ed9d00</item>

    <item name="com_accountkit_input_accent_color">?attr/com_accountkit_primary_color</item>
    <item name="com_accountkit_input_border_color">?attr/com_accountkit_primary_color</item>

See the full set of customizable fields here

  1. In your app AndroidManifest.xml file (usually under android/app/src/main folder) set that Theme to the AccountKitActivity
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools" <-- Add this line

    <!-- Set the AccountKitActivity theme -->
      android:theme="@style/LoginThemeYellow" />



If you have issues with the method signatures you may be using an older version. Check the Releases Notes for breaking changes

import RNAccountKit from 'react-native-facebook-account-kit'

// Shows the Facebook Account Kit view for login via SMS
  .then((token) => {
    if (!token) {
      console.log('Login cancelled')
    } else {
      console.log(`Logged with phone. Token: ${token}`)

// Shows the Facebook Account Kit view for login via email
  .then((token) => {
    if (!token) {
      console.log('Login cancelled')
    } else {
      console.log(`Logged with email. Token: ${token}`)

// Logouts the user, so getCurrentAccessToken() will retrieve null
  .then(() => {
    console.log('Logged out')

// Retrieves the logged user access token, if any user is logged
  .then((token) => {
    console.log(`Current access token: ${token}`)

// Retrieves the logged user account info, if any user is logged
  .then((account) => {
    console.log(`Current account: ${account}`)

// Configures the SDK with some options
  responseType: 'token'|'code' // 'token' by default,
  titleType: 'login',
  initialAuthState: '',
  initialEmail: 'some.initial@email.com',
  initialPhoneCountryPrefix: '+1', // autodetected if none is provided
  initialPhoneNumber: '123-456-7890',
  facebookNotificationsEnabled: true|false, // true by default
  readPhoneStateEnabled: true|false, // true by default,
  receiveSMS: true|false, // true by default,
  countryWhitelist: ['AR'], // [] by default
  countryBlacklist: ['US'], // [] by default
  defaultCountry: 'AR',
  theme: {...} // for iOS only, see the Theme section


Try the examples. They are related to different React Native versions.

git clone https://github.com/underscopeio/react-native-facebook-account-kit
cd react-native-facebook-account-kit/examples/RN033 # or /RN024
react-native run-ios # or react-native run-android


I have problems running the example

If you have trouble running any example try the following:

  1. Move the example out of the repo

  2. Remove this package local dependency from package.json

    -    "react-native-facebook-account-kit": "file:../.."
  3. Run yarn react-native-facebook-account-kit

  4. Re-run react-native run-android or react-native run-ios

"A system issue occured, Please try again" when sending SMS

A. Check your FacebookAppID and AccountKitClientToken on iOS Info.plist and Android strings.xml are correct

B. If you have enabled the client access token flow in fb account kit dashboard, then responseType should be set to code when calling configure

// Configures the SDK with some options
    responseType: 'code'

Issue: #68

I cannot integrate the library with RN versions < 0.40.0

A. Modify the android/build.gradle file to override the com.facebook.android:account-kit-sdk library with com.facebook.android:account-kit-sdk:4.15.0 and the compileSdkVersion and buildToolsVersion as depicted below

subprojects { subproject ->
        dependencies {
            compile ('com.facebook.android:account-kit-sdk:4.15.0'){
                force = true
                exclude group: 'com.parse.bolts', module: 'bolts-android';
                exclude group: 'com.parse.bolts', module: 'bolts-applinks';
                exclude group: 'com.parse.bolts', module: 'bolts-tasks';

        if(subproject.name == 'react-native-facebook-account-kit') {
            android {
                compileSdkVersion 23
                buildToolsVersion "23.0.3"


License is MIT