> For the complete documentation index, see [llms.txt](https://docs.sfbx.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sfbx.io/configuration/step-3-notice-implementation-web-app-tv/android/unified-sdk/git-sample.md).

# Git sample

## 🎯 Purpose

This project is a complete Android application that demonstrates how to integrate the **UnifiedSDK** in a real-world scenario. It gives you a quick overview of the key steps for a successful integration: initialization, configuration, and usage of the SDK's main features.

***

## 📦 What's included

* SDK initialization at app startup
* Required dependency setup
* Sample API calls using the SDK
* Callback and error handling

***

## 🚀 Quick start

### **1. Clone the repository**

```bash
git clone https://gitlab.datalf.chat/customers/unifiedsdk-sample.git
```

### **2. Open in Android Studio**

Open Android Studio → **File > Open** → select the cloned folder.

### **3. Sync and run**

Let Gradle sync the dependencies, then run the app on an emulator or a physical device.

***

## 🔗 Repository access

👉 [**View the project on GitLab**](https://gitlab.datalf.chat/customers/unifiedsdk-sample) — Clone, fork, or browse the source code directly.

***

## 📸 Preview

<figure><img src="/files/YyZOAQtw6T3vrHbZLnWT" alt="A screenshot of the project structure in Android Studio"><figcaption><p>project structure in Android Studio</p></figcaption></figure>

<figure><img src="/files/mHUkDvmMz1pfLxNx6x6T" alt="A screenshot of the running app (main screen)"><figcaption><p>Running app (main screen)</p></figcaption></figure>

<figure><img src="/files/LiYvf3YoFuYQkWIwwQhE" alt="A screenshot of the console/logs showing the SDK successfully initialized"><figcaption><p>console/logs showing the SDK successfully initialized</p></figcaption></figure>

***

## 💡 Tips

{% hint style="info" %}
Make sure you have completed **Step 1: Repository** and **Step 2: Dependency** before running the sample, so that all dependencies resolve correctly.
{% endhint %}