Mint is a cross-platform collectible application focused on ownership, trading, and competitive auctions. Users can open packs, discover collectibles with different rarity tiers, list items on a marketplace, or participate in live auctions with anti-sniping mechanics that extend the timer when last-second bids are placed. The app is designed around real-time updates, rich visuals, and push notifications so users stay informed about bids, wins, and market activity even when the app is not open.
Mint is built with React Native and Expo, and uses Firebase as its main backend platform. Authentication is handled through Firebase Authentication with Single Sign-On providers, Firestore is used for real-time data storage, and Firebase Cloud Messaging powers push notifications. Live auction updates are delivered through a Socket.IO backend service.
Clone the repository and pull the latest changes from the main branch. Once the project is up to date, install the dependencies using npm.
git clone git@github.com:Ale866/mint-frontend.git
cd mint-frontned
npm installTo run Mint on Android, you must have Android Studio installed and an Android SDK available on your machine. Java 17 is required; other Java versions will cause Gradle to fail during the build process.
To list all the java versions installed in your system, use
# on mac/linux
/usr/libexec/java_home -V
#on windows
# You must find it using where, java -V or by looking at common install locationsYou must set the ANDROID_HOME environment variable to the location of your Android SDK. The SDK is usually installed in the following path:
C:\Users<your-username>\AppData\Local\Android\Sdk
After setting the environment variable, restart your terminal to ensure the change is applied.
Next, from the project root, run the following command to generate the native Android project:
npx expo prebuild --clean
At this point, you have two options to run the app: using an Android emulator or a physical Android device.
If you choose to use Android Studio, open it and start an Android emulator from the Device Manager. Once the emulator is running, go back to your terminal and run:
npx expo run:android
Wait for the build process to complete. When it finishes, the Mint app will automatically launch on the emulator.
If you want to use a physical Android device instead, additional setup is required, including enabling developer options and USB debugging on your phone. This process is slightly more complex and is not covered here.
iOS development requires macOS and a recent version of Xcode. Xcode must be opened at least once after installation to complete its initial setup. An iOS simulator can be launched from Xcode’s Devices and Simulators menu, or you can connect a physical iPhone for testing.
From the project root, install iOS native dependencies using CocoaPods, then run the app through Expo or Xcode using the generated workspace.