AnyPass is your one-stop solution for password management, password generation, and password health analysis.

Architecture

The app architecture has three layers: a data layer, a domain layer and a UI layer. AnyPass uses Meteor KMP to create application using MVI architecture. It provides a unidirectional data flow (UDF), allowing you to handle state changes and propagate them to the UI efficiently.

Single source of truth

When a new data type is defined in your app, you should assign a Single Source of Truth (SSOT) to it. The SSOT is the owner of that data, and only the SSOT can modify or mutate it. To achieve this, the SSOT exposes the data using an immutable type, and to modify the data, the SSOT exposes functions or receive events that other types can call.

This pattern brings multiple benefits:

• It centralizes all the changes to a particular type of data in one place.
• It protects the data so that other types cannot tamper with it.
• It makes changes to the data more traceable. Thus, bugs are easier to spot.

In an offline-first application, the source of truth for application data is typically a database. In some other cases, the source of truth can be a ViewModel or even the UI.

Technology

• Kotlin
• Compose Multiplatform
• Kotlin Coroutine
• Swift
• SqlDelight
• Koin
• Meteor
• Firebase
• Sentry
• Google Admob
• Multiplatform Settings
• Moko Resource
• Sentry Multiplatform
• BuildKonfig
• Coil
• Meteor ViewModel
• Turbine
• Ktlint
• Spotless
• Jacoco

1. Check your Xcode version is 14.1 or newer. Additionally, check your Android Studio version is Flamingo or newer.

2. Clone the repository using the following command:

   https://github.com/getspherelabs/anypass-kmp.git
   

3. When building the iOS app, you may face common issues:

   • Issue: Unicode Normalization not appropriate for ASCII-8BIT

   • Solution: Try add your ~/.zprofile, ~/.zshrc files:

      LANG=en_US.UTF-8
      LANGUAGE=en_US.UFT-8
      LC_ALL=en_US.UFT-8
     

   • Issue: Sometimes you can not build your iOS app from Xcode

   • Solution: Follow these steps after executing the cleanup script:

     1. pod deintegrate
     2. pod init
     3. Copy the pod modules
     4. pod install

4. Build and run the app on your Android / iOS device or simulator.

⚠️ Make fake google-services.json for building properly.

5. We recommend including linkers from Xcode. To include linkers from Xcode, follow these steps:

   1. Navigate to iosApp/Build Settings/Linking.
   2. Add the following linkers to your Other Linking Flags:
      • lsqlite3
      • ObjC

Contribute

Want to contribute? See CONTRIBUTING.md 

Project Requirements

• Java 17+
• iOS: 14.0+

AnyPass on GitHub: https://github.com/getspherelabs/anypass-kmp
Platform: Android/Crossplatform
⭐️: 92