eduMFA Authenticator

This is the Expo app for the eduMFA authenticator.

Get started

1. Install dependencies

   bun install

2. Start the app

   bunx expo start

In the output, you'll find options to open the app in a

• development build
• Android emulator
• iOS simulator
• Expo Go, a limited sandbox for trying out app development with Expo

You can start developing by editing the files inside the app directory. This project uses file-based routing.

Releases

Releases are tag-driven through EAS Workflows. The main branch is the development branch and does not publish store builds by itself.

Beta releases use pre-release tags:

git tag beta/0.1.0-beta.1
git push origin beta/0.1.0-beta.1

git tag beta/0.1.0-beta.2
git push origin beta/0.1.0-beta.2

Production releases use final version tags:

git tag v0.1.0
git push origin v0.1.0

The beta workflow builds Android and iOS store binaries. Android is submitted to the Google Play open testing track. iOS is distributed to the TestFlight external group External Testers.

The production workflow builds Android and iOS store binaries, then waits for approval in EAS before submitting to Google Play production and App Store Connect.

Both workflows build the downloadable APK after the Android store build has reserved the next remote build number. EAS then publishes the APK to the matching GitHub release, so no GitHub Actions runner waits in the EAS build queue.

Required setup:

• Connect this GitHub repository to EAS Workflows.
• Configure EAS credentials for iOS and Android.
• Configure Android Google Play submission credentials in EAS.
• Configure iOS App Store Connect submission credentials in EAS.
• Add GITHUB_RELEASE_TOKEN as a secret EAS environment variable in the production environment. Use a fine-grained GitHub token for this repository with read/write access to Contents.