Skip to content

the-mold/mobile-authenticator

Repository files navigation

Authenticator App

Secure, cross-platform, and user-friendly TOTP (Time-based One-Time Password) authenticator application built with React Native. It provides a simple and effective way to manage two-factor authentication (2FA) codes for all your online accounts, compiling for both Android and iOS from a single codebase.

Features

  • Cross-platform: Android and iOS support from a single codebase
  • Secure Storage: All secret keys are stored securely on the device
  • Offline functionality: Generates TOTP codes even when your device is offline
  • QR Code Scanner: Easy setup by scanning QR codes from service providers
  • Auto-refresh: TOTP codes automatically refresh every 30 seconds

Installation

Prerequisites

  • Node.js (v16 or higher)
  • React Native CLI
  • Android Studio (for Android development)
  • Xcode (for iOS development, macOS only)

Running the App

Android

npx react-native run-android

iOS

npx react-native run-ios

Security

This app implements several security measures:

  • Encrypted Storage: All sensitive data is encrypted before storage
  • No Network Transmission: TOTP generation happens entirely offline
  • Secure Key Storage: Uses iOS Keychain and Android Keystore
  • App Lock: Optional biometric or PIN protection (if implemented)

Development

Running Tests

npm test
# or
yarn test

Building for Production

Android

cd android
./gradlew assembleRelease

iOS

  1. Open the project in Xcode
  2. Select "Product" > "Archive"
  3. Follow the App Store submission process

Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Secure, cross-platform, and user-friendly TOTP authenticator application built with React Native.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors