Overview

Qrivo is a native Android QR scanner and generator built with Kotlin, Jetpack Compose, Material 3, Hilt, Room and DataStore. It includes scanning, generating, history, favorites, settings, localization and monetization support through AdMob and a one-time Google Play Billing purchase for Remove Ads.

Architecture

The project follows a practical clean structure that is easy to maintain and easy to reskin.

app/src/main/java/com/madcat/smartsuite/
  config/
  core/
  data/
  domain/
  features/
    about/
    app/
    favorites/
    generator/
    history/
    home/
    onboarding/
    premium/
    scanner/
    settings/
  navigation/
  ui/

Installation

Requirements

• Android Studio Iguana or newer
• JDK 17
• Android SDK installed
• Windows, macOS or Linux environment that supports Android Studio

First open

1. Open Android Studio.
2. Choose Open.
3. Select the project folder.
4. Let Gradle sync.

First build

gradlew.bat assembleDebug

Debug APK output:

app/build/outputs/apk/debug/app-debug.apk

Reskin Guide (Summary)

Use this order for the fastest reskin process:

1. Change the app name and support data.
2. Replace icon, logo and splash assets.
3. Change colors in the theme config.
4. Edit Home and onboarding content.
5. Edit About, Privacy and Support text.
6. Configure AdMob and Billing if needed.

Change App Name

Edit the base visible name in:

app/src/main/res/values/brand_strings.xml

You need to edit strings on every language.

Reference 1

Main keys:

• app_name
• brand_tagline
• brand_short_description
• about_description

The app name is exposed through centralized config in AppConfig.kt and BrandingConfig.kt.

reference 2

Change Package Name

Current package name:

com.yourdevname.smartsuite

1. Disable "Compact Middle Packages": In the Project pane, click the Gear icon and uncheck Compact Empty Middle Packages. This breaks the package name (e.g., com.example.app) into individual folders.
2. Use Android Studio Refactor > Rename on the Java package.

Package name reference images

3. Update applicationId in app/build.gradle.kts.

Package name final check

6. Sync gradle
7. Go to menu / build / clean project



8. Now you can build app on your device!

The FileProvider authority in the manifest uses ${applicationId}.fileprovider, so it follows the new application ID automatically.

Logo, Icon and Splash

Launcher icon

Replace assets:

1. Right click the RES folder.
2. Click on Image Asset.

3. Upload your icon or logo in the Path field.
4. You can resize it before applying the changes.
5. Click OK.

6. Click Finish.

In-app brand mark

The app brand mark is controlled by BrandingConfig.kt and currently points to R.drawable.ic_brand_mark.

Splash

Splash appearance is controlled by SplashScreen.kt, theme colors and the brand mark resource. (Just for reference)

Colors and Theme

All core palette values are centralized in:

app/src/main/java/com/yourdevname/smartsuite(name of your app)/config/ThemeConfig.kt

1. Click on the color square to change colors easily.

Texts and Informational Content

These are the main content sources:

• app/src/main/res/values/brand_strings.xml
• app/src/main/res/values/strings.xml
• app/src/main/res/values/phase_strings.xml

Change the text values in these files and all files includes for every language you have. You can use default text (Branding text you should change it!)

Add Languages

1. Create a new folder such as app/src/main/res/values-de.
2. Add a strings.xml file for that language.
3. Translate the keys from the base English resources.
4. Add the language to AppLanguage.kt.
5. Test the language switch in the app.

Current supported languages: English, Spanish, Portuguese, French and Italian.

Configure AdMob

Main files:

• config/AdsConfig.kt - You can change with true or false where to show ads and also the number of taps
AdsConfig reference



• res/values/monetization_strings.xml - Here you add yor own Admob ad codes, if you don't add app will use test ads, please use them all

Monetization strings reference

Included ad types

• Banner
• App open
• Interstitial after a configurable number of interactions

Main switches

• adsEnabled
• bannerAdsEnabled
• appOpenAdsEnabled
• interstitialAdsEnabled

Configure Google Play Billing Remove Ads

This project includes a single non-consumable product for permanently removing ads.

1. Create a one-time product in Google Play Console.

Billing setup steps 1 and 2

2. Create the product ID.

Billing product ID reference

3. Update removeAdsProductId in BillingConfig.kt.
4. Set billingEnabled = true.

Billing config reference

5. Test purchase and restore on a valid testing track.

Build AAB for Google Play Store

AAB output:

app/build/outputs/bundle/release/app-release.aab

Bundle build reference sequence

1. Open the Android Studio build flow for a signed release and choose the App Bundle option.
2. Select or create the keystore that will sign the release build.
3. Confirm the key alias, passwords and output configuration shown by the wizard. (Choose a path to store the key, be aware you should have it and remember to do updates)
4. Choose the release variant and continue through the signing flow.
5. Finish the wizard and wait for Gradle to generate the final .aab file.
6. Open the generated output folder and verify that the release bundle was created successfully.

Updating Safely

If you already customized Qrivo and later receive a new update, do not copy the new project over your edited project. The safest method is to keep both versions and move changes carefully from the new update into your customized app.

Files to review first

• config/AppConfig.kt
• config/BrandingConfig.kt
• config/ThemeConfig.kt
• config/HomeContentConfig.kt
• config/OnboardingConfig.kt
• config/AdsConfig.kt
• config/BillingConfig.kt
• res/values/brand_strings.xml
• res/values/strings.xml and other language folders

Troubleshooting

Release Checklist

Hire Our Services

If you want to save time, we can customize the app for you and leave it ready to build.

Thank You

Thank you for purchasing the app. We truly appreciate your support.

If you enjoyed the product, we would be grateful if you leave a rating.

If you need help, contact us at hello@madcatdev.com.