v1.0.4

* add LICENSE file

fix #12

* rename sdk library from authfy-sdk-2.5.4 to authcube-sdk-2.5.4

* update README.md with build & run instructions

fix #11

* fix image layouts

---------

Co-authored-by: Vitor Cardoso <vitor.cardoso@sec4you.com.br>

Author: geavenx

LICENSE

@@ -0,0 +1,8 @@
+IT4YOU CONSULTORIA EM INFORMATICA LTDA Proprietary Software License Agreement.
+
+COPYRIGHTS (c) SINCE 2009, IT4YOU CONSULTORIA EM INFORMATICA LTDA.
+
+This software is proprietary and confidential. All rights reserved.
+Unauthorized copying of this file, via any medium, is strictly prohibited.
+Distribution, modification, or use of this software in source or binary forms is not allowed
+without explicit permission from IT4YOU CONSULTORIA EM INFORMATICA LTDA.

README.md

@@ -1,5 +1,82 @@
-# authfy-sample-android
-Authfy Native Sample App for Android
+# 1. Introduction
+This sample app lets you quickly test the integration of Authcube's Android SDK.
+
+## License
+This software is proprietary and protected under IT4YOU CONSULTORIA EM INFORMATICA LTDA's license.
+All rights reserved since 2009.
+
+Please refer to the LICENSE file in the repository for complete terms.
+
+# 2. Running the app
+
+### Prerequisites
+
+Make sure you have installed:
+- Git
+- [Android Studio](https://developer.android.com/studio)
+
+### Step 1: Clone this Repository
+Run the following command in your terminal:
+
+```bash
+git clone https://github.com/authcube/sample-app-android.git
+```
+
+### Step 2: Open the Project
+1. Open Android Studio
+2. Click **"Open"** on the welcome screen (or go to **File > Open...** in the top menu)
+3. Navigate to the directory where you cloned the project
+4. Wait for the project to load (you'll see a progress bar at the bottom saying "Gradle Build Running")
+
+### Step 3: Set Up and Configure the Emulator
+1. Click on "Tools" in the top menu
+2. Click "Device Manager"
+3. Click the "Add a new device" button and "Create a new device"
+4. In the "Phone" category, select Pixel 6 (or the any other phone)
+5. Click "Next"
+6. Select "API 34" (Android 14.0)
+   - If it's not installed, click **install**
+            ![](docs/images/api-version.png)
+7. Finish the virtual device setup
+
+### Step 4: Run the App
+1. Select your newly created device in the top bar
+2. Hit the `Run 'app'` button (or press **Shift + f10**)
+   ![](docs/images/run.png)
+
+# 3. Using the app
+Before logging in, you **MUST** configure the app with identity provider details:
+1. Click **Settings**
+ 
+![](docs/images/app-settings.png)
+
+2. Fill in the fields with **your** information
+ 
+![](docs/images/save-config.png)
+
+3. Go back and log in. You'll be redirected to the **home screen**
+
+## Troubleshooting
+### If the build fails
+Try these fixes in order:
+1. Click **File > Sync Project with Gradle Files**
+2. Click **Build > Clean Project** then **Build > Rebuild Project**
+3. Close Android Studio and reopen it
+
+### Additional help
+- Make sure Android Studio is fully updated:
+  1. Click **"Help"** in the top menu
+  2. Click **"Check for updates"**
+  3. Install any available updates
+
+- If nothing else works, try:
+  1. Close Android Studio
+  2. Delete the .gradle/ directory from your project
+  3. Reopen Android Studio and click the `Run 'app'` button
+  4. Let it rebuild the app
+
+### Important Information
+The Android Emulator is not aware of your local HOSTS configuration, so it is advised to use an 
+external server to develop and test your app
+
 
-## Important Information
-The Android Emulator is not aware of your local HOSTS configuration, so it is advised to use an external server to develop and test your app