8.6 Released with 🥽 visionOS support and more!
Check it out

View on GitHub

@nativescript/jetpack-compose ​

A plugin that allows you to use Jetpack Compose in NativeScript.

Contents ​

Installation ​

npm install @nativescript/jetpack-compose

Use @nativescript/jetpack-compose ​

Add Jetpack Compose version and dependencies ​

Adjust App_Resources/Android/app.gradle to include your desired Jetpack Compose version and dependencies:

dependencies {
    def compose_version = "1.2.1"
    implementation "androidx.compose.ui:ui:$compose_version"
    // Tooling support (Previews, etc.)
    implementation "androidx.compose.ui:ui-tooling:$compose_version"

    // Add any other dependencies your Jetpack Compose UI needs

android {
    // other settings like targetSdk, etc.

    buildFeatures {
        compose true
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    kotlinOptions {
        jvmTarget = "1.8"
    composeOptions {
        kotlinCompilerExtensionVersion '1.3.2'

Create a Compose view ​

Any Kotlin file can be created in your App_Resources, for example:

  • App_Resources/Android/src/main/java/BasicView.kt
class BasicView {
    data class ExampleUIState(
        val text: String = ""
    ) {}

    class ExampleViewModel(
    ) : ViewModel() {
        var uiState by mutableStateOf(ExampleUIState())

    var mViewModel = ExampleViewModel()

    fun generateComposeView(view: ComposeView): ComposeView {
        return view.apply {
            setContent {
                MaterialTheme {
                    val uiState = mViewModel.uiState;

    fun updateData(value: Map<Any, Any>) {
        val v = value["data"] as String;
        mViewModel.uiState = ExampleUIState(v);

    var onEvent: ((String) -> Unit)? = null

Register your Compose view ​

This can be done in the bootstrap file (often app.ts or main.ts) or even the view component that needs it.

  • app.ts
import {
} from '@nativescript/jetpack-compose'

// A. You can generate types for your own Compose Provider with 'ns typings android --aar {path/to/{name}.aar}'
// B. Otherwise you can ignore by declaring the package resolution path you know you provided
declare var com
  (view) => new ComposeDataDriver(new com.example.FlyingHearts(), view)

Use Compose view with any NativeScript layout ​

This illustrates what is often called a "vanilla" flavored NativeScript app. However, you can use this plugin with any flavor (Angular, React, Svelte, Vue, etc.)

<Page xmlns="http://schemas.nativescript.org/tns.xsd" navigatingTo="navigatingTo" class="page" xmlns:jc="@nativescript/jetpack-compose">
    <jc:JetpackCompose composeId="flyingHearts" composeEvent="{{ onEvent }}" data="{{ text }}"/>

Use Jetpack Compose with Angular ​

import { registerElement } from '@nativescript/angular'
import { JetpackCompose } from '@nativescript/jetpack-compose'

registerElement('JetpackCompose', () => JetpackCompose)

It can now be used within any Angular component, eg:

    <JetpackCompose composeId="flyingHearts" (composeEvent)="onEvent($event)" [data]="data"></JetpackCompose>

Credits ​

Valor Software

NativeScript is proudly supported by Valor Software as an official partner. We are proud to offer guidance, consulting, and development assistance in all things NativeScript.

Contact Valor for assistance.

License ​