---
title: Installation
description: Learn how to use Compose Unstyled in a new or existing projects.
---

## Quick Start

The fastest way to start a new project with Compose Unstyled is by using an app boilerplate:

<div class="flex flex-col gap-3 not-prose mt-8 unstyled-quickstart-list">
  <a href="https://github.com/composablehorizons/jetpack-compose-boilerplate" target="_blank" rel="noopener noreferrer" class="flex items-center gap-6 bg-white/5 rounded-2xl px-6 py-5 hover:bg-zinc-100 transition-colors unstyled-quickstart-card">
    <div class="overflow-clip flex-shrink-0 w-16 h-16 bg-white rounded-full flex items-center justify-center outline outline-slate-900/5 shadow unstyled-quickstart-icon">
      <img src="/icons/android.svg" class="w-10 h-10 object-contain unstyled-quickstart-icon-image android" loading="lazy"/>
    </div>
    <div class="flex-1 unstyled-quickstart-copy">
      <div class="font-semibold text-lg mb-1 unstyled-quickstart-title">Android Boilerplate</div>
      <div>Build Android apps using Compose Unstyled and Jetpack Compose</div>
    </div>
  </a>

  <a href="https://github.com/composablehorizons/compose-multiplatform-boilerplate" target="_blank" rel="noopener noreferrer" class="flex items-center gap-6 bg-white/5 rounded-2xl px-6 py-5 hover:bg-zinc-100 transition-colors unstyled-quickstart-card">
    <div class="overflow-clip flex-shrink-0 w-16 h-16 bg-white rounded-full flex items-center justify-center outline outline-slate-900/5 shadow unstyled-quickstart-icon">
      <img src="/icons/compose.svg" class="size-16 p-3 unstyled-quickstart-icon-image" loading="lazy" />
    </div>
    <div class="flex-1 unstyled-quickstart-copy">
      <div class="font-semibold text-lg mb-1 unstyled-quickstart-title">Compose Multiplatform Boilerplate</div>
      <div>Build apps for every platform using Compose Unstyled and Compose Multiplatform</div>
    </div>
  </a>
</div>

---

## Add to an existing project

### Add Maven Central

We distribute Compose Unstyled via Maven Central. Maven Central is the most popular repository for Kotlin packages and
it should be included in your list of repositories
out of the box.

To make sure you have it, check your `settings.gradle.kts`:

```kotlin
// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        mavenCentral() // <- Add this
    }
}

```

### Add to Jetpack Compose project

Add the dependency in your project, and set JVM version to 17:

```kotlin title="app/build.gradle.kts"
// app/build.gradle.kts
android {
    kotlinOptions {
        jvmTarget = "17" // <- Update this
    }
    compileOptions {
        // make sure these are set to VERSION_17
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
    // keep the rest the same
}

dependencies {
    // adds all APIs (recommended for bootstrapping new projects)
    implementation("com.composables:composeunstyled:{{compose_unstyled_version}}")

    // adds theming APIs
    implementation("com.composables:composeunstyled-theming:{{compose_unstyled_version}}")

    // adds component primitives for building components
    implementation("com.composables:composeunstyled-primitives:{{compose_unstyled_version}}")

    // adds themes for native look and feel
    implementation("com.composables:composeunstyled-platformtheme:{{compose_unstyled_version}}")
}
```

### Add to Compose Multiplatform project

For Compose Multiplatform apps:

```kotlin title="composeApp/build.gradle.kts"
// composeApp/build.gradle.kts
kotlin {
    androidTarget {
        compilerOptions {
            jvmTarget.set(JvmTarget.JVM_17) // <- Update this
        }
    }
    sourceSets {
        commonMain.dependencies {
            // adds all APIs (recommended for bootstrapping new projects)
            implementation("com.composables:composeunstyled:{{compose_unstyled_version}}")
            
            // adds theming APIs
            implementation("com.composables:composeunstyled-theming:{{compose_unstyled_version}}")

            // adds component primitives for building components
            implementation("com.composables:composeunstyled-primitives:{{compose_unstyled_version}}")

            // adds themes for native look and feel
            implementation("com.composables:composeunstyled-platformtheme:{{compose_unstyled_version}}")
        }
    }
}
```