Home

Awesome

🔒📱 OakOTP

iOS Version Swift Build Status codecov License

OakOTP is an iOS app built with SwiftUI for managing your 2FA codes.

Download

<br> <div> <img style="float: right;" width=200 src="https://github.com/AlexCatch/Oak/blob/master/DesignAssets/setup.png"> <img style="float: right;" width=200 src="https://github.com/AlexCatch/Oak/blob/master/DesignAssets/accounts.png"> <img style="float: right;" width=200 src="https://github.com/AlexCatch/Oak/blob/master/DesignAssets/new.png"> <img style="float: right;" width=200 src="https://github.com/AlexCatch/Oak/blob/master/DesignAssets/settings.png"> </div> <!-- GETTING STARTED -->

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

OakOTP uses Fastlane for running tests so make sure you have Fastlane setup and configured on your machine.

Installation

  1. Clone the repo
    git clone git@github.com:AlexCatch/Oak.git
    
  2. Run Bundler
    bundle install
    
  3. Open OakOTP.xcodeproj and configure signing for each target (Automatically managing signing will suffice.)

Running Tests

You can either run tests through Xcode or run bundle exec fastlane test from your terminal to run all unit and UI tests

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Make sure your changes are tested either with unit or UI tests. (bundle exec fastlane test)
  4. Commit your Changes (git commit -m 'Add some AmazingFeature')
  5. Push to the Branch (git push origin feature/AmazingFeature)
  6. Open a Pull Request
<!-- CONTACT -->

Contact

If you need to reach out, shoot me an email at alex@alexcatchpoledev.me or you can find me on LinkedIn

Built With

A few open-source packages are used in OakOTP - you can find them listed below.

<!-- LICENSE -->

License

Distributed under the MIT License. See LICENSE for more information.