Detects device type on both android and ios
Java Objective-C JavaScript
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

React Native Device Specs

RNDeviceSpecs detects the specifications of the device it is running on. Requiring or importing the module will give you an object with properties that describe the user's device.

Add it to your project


npm install react-native-device-specs --save


Open your project in XCode, right click on Libraries, click Add files to (Your Project Name), and select RNDeviceSpecs.xcodeproj

Add libRNDeviceSpecs.a to Build Phases --> Link Binary With Libraries


In android/settings.gradle below include ':app' add:

include ':react-native-device-specs'
project(':react-native-device-specs').projectDir = new File(settingsDir, '../node_modules/react-native-device-specs')

In android/app/build.gradle

dependencies {
    compile project(':react-native-device-specs')

In android/app/src/main/java/com/YourProject/ add:

import com.joinpeach.react.device.specs.*; // <--- add this

public class MainActivity extends Activity implements DefaultHardwareBackBtnHandler {

    protected void onCreate(Bundle savedInstanceState) {
        mReactRootView = new ReactRootView(this);

        mReactInstanceManager = ReactInstanceManager.builder()
                .addPackage(new MainReactPackage())
                .addPackage(new RNDeviceSpecsModule())           // <- and add this

        mReactRootView.startReactApplication(mReactInstanceManager, "YourProject", null);


Use it!

Use import specs from 'react-native-device-specs' or var specs = require('react-native-device-specs') in your project!


  • platform: The platform code.
  • storageSize: The quoted storage size (GB) given by Apple (Ex: 32, 64, 128)
  • diskSpace: The actual size of the disk.
  • carrier: The carrier of device or 'No Carrier' for Simulators or Devices without a carrier.


Feel free to submit a pull request with feature suggestions or device updates. Please maintain a consistent syntax for new devices (See lib/iosModels.js for examples)