📱 React-Native mobile application for Buttercup
Clone or download
Latest commit 2314cc7 Dec 13, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
__tests__ Prettify all the things May 29, 2018
android Upgrade react-native to 0.57 Sep 24, 2018
crypto Fix description for base64 enc Jul 15, 2018
ios Merge branch 'rn057' of github.com:buttercup/buttercup-mobile into rn057 Nov 5, 2018
resources/images Add readonly icons Aug 12, 2018
scripts Testable android (#107) Jul 14, 2018
source Remove console log Dec 13, 2018
.babelrc Fix jest tests Dec 13, 2018
.buckconfig Add react-native application Feb 13, 2017
.editorconfig Fix prettier globbing Oct 14, 2017
.flowconfig Upgrade react-native to 0.57 Sep 24, 2018
.gitattributes Add react-native application Feb 13, 2017
.gitignore Upgrade react-native to 0.57 Sep 24, 2018
.prettierrc Prettify all the things May 29, 2018
.travis.yml Testable android (#107) Jul 14, 2018
.watchmanconfig Add react-native application Feb 13, 2017
CHANGELOG.md Bump to 1.5.0 Aug 13, 2018
LICENSE Initial commit Feb 12, 2017
README.md Add features to readme Aug 13, 2018
app.json Add react-native application Feb 13, 2017
bcup-1.png Replace preview image Jul 3, 2018
bcup-2.png Add screenshots Oct 8, 2017
index.android.js Setup back-button handler for android only Oct 31, 2017
index.ios.js Enable background-status monitoring on iOS only Oct 25, 2017
index.shared.js Remove commented code Dec 12, 2018
package-lock.json Fix jest tests Dec 13, 2018
package.json Fix jest tests Dec 13, 2018
shim.js Fix jest tests Dec 13, 2018


Buttercup Mobile

The mobile application for the Buttercup Credentials Manager.

Buttercup Build Status Backers on Open Collective Sponsors on Open Collective Join the community on Spectrum

Get it from iTunes Get it on Google Play

Main screen Groups screen


This repository holds the source for the Buttercup mobile application, which is available for the following platforms:

  • iOS 10+
  • Android 6.0+

The mobile application allows for full integration with Buttercup archives stored on a variety of platforms. Like the other applications, this mobile application makes use of AES 256bit encryption with over 200k PBKDF2 password derivation interations.

The Buttercup for Mobile application boasts the following features:

  • On-device encryption and decryption
  • Auto-hide screen when app is sent to background (like banking apps)
  • Auto-lock vaults after a certain period of inactivity
  • Add/Edit/Delete entries
  • Unlock vaults even when offline (read-only)

You can read about the changes and releases of the application in the changelog.


This project uses React Native to build native iOS and Android applications from a React/JavaScript codebase. The majority of the codebase is JavaScript which utilises the following platforms:

  • ReactJS
  • Redux
  • React Native Router Flux

As Buttercup makes use of strong cryptography, certain encryption/decryption tasks are performed using pure native code (Objective-C/Java). Only the bare minimum required for increased performance is handled on the native side, with the rest being solely JavaScript.


Ensure that you're using NodeJS 6 or newer on OSX. Android projects can be built and tested on Linux and Windows, but these platforms are not officially supported.

Before getting started, ensure you follow the official React Native Getting Started guide for your desired platform (iOS/Android). It is also recommended to have the react-native-cli installed:

npm install -g react-native-cli

Run the following to initialise the project:

npm install

Once all dependencies are installed and your target development environments are setup (Xcode for iOS and Android Studio for Android), it should be possible to begin development with virtual devices.

Important note about Node.js support: Development for this project should be performed on Node version 8. Although it may work on versions 6 and newer, we will not be supporting issues raised for these versions. Similarly, we do not currently support NodeJS version 9.

iOS development

Providing Xcode is setup correctly, running the following will launch the application in an iPhone emulator:

npm run start:ios

Android development

Ensure that Android Studio is setup correctly and that an AVD has been created. The virtual device must be on API level 23 or greater running Android 6.0 or newer. You must have the AVD started before continuing with no other devices connected. To ensure you only have one device running, execute the following on the command-line:

adb devices

To run the application in the virtual device, run the following:

npm run start:android

Running on an Android device

To run on an actual device, first terminate any AVDs that are running. Connect the phone over USB and run adb devices to ensure that it shows up. You can then run npm run start:android to launch the application on the device.

The same software version restrictions apply to real devices.

Building an APK

To build a signed APK:

  1. Close all other development resources for the project.
  2. Run npm run build:android to first build the project.
  3. In Android Studio, choose Build > Generate Signed APK.
  4. Build a release APK by following the instructions in the GUI.

Crypto Library Development

Buttercup Mobile's crypto functionality is written in Rust and lives under ./crypto directory. The binaries are already built and placed inside the relevant directories and you don't usually need to change those. However, if you want to work on the Rust library, the following are required:

  1. Install Rust & Cargo using rustup toolchain
  2. Install cargo lipo to build iOS binaries
  3. Add iOS and Android targets to your rustup toolchain:
# iOS
rustup target add aarch64-apple-ios
rustup target add armv7-apple-ios
rustup target add i386-apple-ios
rustup target add x86_64-apple-ios

# Android
rustup target add aarch64-linux-android
rustup target add armv7-linux-androideabi
rustup target add i686-linux-android
  1. Get Android NDK. We recommend installing it via Android Studio or sdkmanager:
sdkmanager --verbose ndk-bundle
  1. Create the standalone NDKs.
cd crypto && ./create-ndk-standalone.sh
  1. Finally build the binaries:


We love contributions - anything from new features and bug fixes to suggestions and questions. Please follow our contribution guide.


Please keep in-line with the code style of each file, regardless of what tests are run (linting etc.). When creating new files their format is expected to closely resemble that of other existing source files.


This project exists thanks to all the people who contribute. [Contribute].


Thank you to all our backers! 🙏 [Become a backer]


Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]