# Android SDK customisation

An interactive tool that restyles the Android payment sheet and previews it live in an Appetize device simulator running a real Android app. This page is highly interactive — use the interactive version to adjust the theme and watch the simulator restyle in real time.

## What this page covers
- Three control tabs: Presets, Customise (colour pickers + shape sliders), and Code
- Colour controls for Primary, Background, Text, and Error
- Corner radius (0–24px) and border width (0–3px) sliders
- Generated Kotlin `PaymentSheetAppearance` code you can copy
- A live Android simulator (Appetize) with a device selector that restyles as you change values

## How it works

The preview embeds an `AppetizeSimulator` running a real Android build (default device `pixel7`). Colour and shape values are passed to the simulator as parameters, and the embedded app restyles its payment sheet live. The simulator loads from an external service, so it can take several seconds to appear.

Built-in mobile presets (from `mobilePresets`): Default (Peach orange), Dark Mode, Branded Blue, Branded Purple, Minimal. Each defines `primary`, `background`, `text`, and `error` colours.

The Code tab generates Kotlin like:
```kotlin
import io.hyperswitch.paymentsheet.PaymentSheetAppearance
import android.graphics.Color

val appearance = PaymentSheetAppearance(
    colorsLight = PaymentSheetAppearance.Colors(
        primary = Color.parseColor("#ec5228"),
        background = Color.parseColor("#FFFFFF"),
        text = Color.parseColor("#000000"),
        error = Color.parseColor("#C91C00")
    ),
    shapes = PaymentSheetAppearance.Shapes(
        cornerRadiusDp = 12f,
        borderStrokeWidthDp = 1f
    )
)
```

## Related
- [Android SDK](/sdk-mobile-android.md): full integration and the `PaymentSheet.Appearance` API
- [iOS SDK customisation](/sdk-customization-ios.md): the iOS equivalent
- [Web SDK customisation](/sdk-customization.md): the web equivalent (live SDK preview)
- [Testing](/docs/testing.md): test cards and sandbox guidance

---

Interactive version: https://playground.peachpayments.com/sdk-customization/android