---
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">
  <a href="https://github.com/composablehorizons/compose-multiplatform-boilerplate" 
    class="flex items-center gap-6 bg-white/5 rounded-2xl px-6 py-5 hover:bg-zinc-100 transition-colors">
    <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">
      <img src="/icons/compose.svg" class="size-16 p-3" loading="lazy" />
    </div>
    <div class="flex-1">
      <div class="font-semibold text-lg mb-1">Compose Multiplatform Boilerplate</div>
      <div>Build apps for every platform using Compose Unstyled and Compose Multiplatform</div>
    </div>
  </a>

  <a href="https://github.com/composablehorizons/jetpack-compose-boilerplate" class="flex items-center gap-6 bg-white/5 rounded-2xl px-6 py-5 hover:bg-zinc-100 transition-colors">
    <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">
      <img src="/icons/android.svg" class="w-10 h-10 object-contain" loading="lazy"/>
    </div>
    <div class="flex-1">
      <div class="font-semibold text-lg mb-1">Android Boilerplate</div>
      <div>Build Android apps using Compose Unstyled and Jetpack Compose</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 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}}")
        }
    }
}
```

### 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}}")
}
```