Android Integration

Integrate the Marketfront SDK into your Android app using the native Kotlin library.

Coming Soon

The Marketfront SDK for Android is currently in development.

Contact your partner manager for early access.

All integrations require a session token created by your backend. See Sessions for details.

Expected Features

Installation

Add to your build.gradle.kts:

dependencies {
    implementation("com.gett:marketfront:1.0.0")
}

View Integration

class OrderActivity : AppCompatActivity() {
    private lateinit var marketfront: MarketfrontView
    private lateinit var sessionToken: String // From your backend

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_order)

        marketfront = findViewById(R.id.marketfront)
        marketfront.configure(sessionToken = sessionToken)

        marketfront.setListener(object : MarketfrontListener {
            override fun onReady() {
                // SDK is ready
            }

            override fun onOrderComplete(order: Order) {
                // Handle completed order
            }
        })
    }
}

Jetpack Compose Integration

@Composable
fun OrderScreen(sessionToken: String) { // From your backend
    Marketfront(
        sessionToken = sessionToken,
        onOrderComplete = { order ->
            // Handle completed order
        }
    )
}

Event Handling

interface MarketfrontListener {
    fun onReady()
    fun onError(error: MarketfrontError)
    fun onStoreSelected(store: Store)
    fun onItemAdded(item: CartItem)
    fun onCheckoutStarted(checkout: Checkout)
    fun onOrderComplete(order: Order)
    fun onOrderFailed(error: OrderError)
}

Coroutines Support

// Collect events as Flow
lifecycleScope.launch {
    marketfront.events.collect { event ->
        when (event) {
            is MarketfrontEvent.OrderComplete -> handleOrder(event.order)
            is MarketfrontEvent.ItemAdded -> handleItemAdded(event.item)
            is MarketfrontEvent.Error -> showError(event.error)
        }
    }
}

Theming and configuration options are managed via the Partner Dashboard—see the Feature Comparison for what's configurable.

Next Steps

• Events — Handle user actions
• Sessions — Session creation details