Migrating to Kolt

Step-by-step instructions for upgrading projects from the legacy io.github.appspiriment.kolt namespace to Kolt (io.github.koltalabs.kolt).

1. Gradle Convention Plugin IDs

In all module build.gradle.kts files, replace legacy io.github.appspiriment.kolt.* IDs:

2. Version Catalog Wiring

In settings.gradle.kts, pull from io.github.koltalabs.kolt:

dependencyResolutionManagement {
    versionCatalogs {
        create("koltlibs") {
            from("io.github.koltalabs.kolt:kolt-catalog:<version>")
        }
        create("kmplibs") {
            from("io.github.koltalabs.kolt:kmp-catalog:<version>")
        }
    }
}

3. Runtime Dependencies & BOM

// Update coordinates in build.gradle.kts:
dependencies {
    implementation(platform("io.github.koltalabs.kolt:kolt-bom:<version>"))
    implementation("io.github.koltalabs.kolt:utils")
    implementation("io.github.koltalabs.kolt:logutils")
    implementation("io.github.koltalabs.kolt:compose-kmp")
}

4. Source Package Updates

Replace package imports across your Kotlin code:

• io.github.appspiriment.kolt.utils.* → io.github.koltalabs.kolt.utils.*
• io.github.appspiriment.kolt.logutils.* → io.github.koltalabs.kolt.logutils.*
• io.github.appspiriment.kolt.composekmp.* → io.github.koltalabs.kolt.composekmp.*
• io.github.appspiriment.kolt.composeutils.* → io.github.koltalabs.kolt.composeutils.*
• io.github.appspiriment.kolt.location.* → io.github.koltalabs.kolt.location.*
• io.github.appspiriment.kolt.locationpicker.* → io.github.koltalabs.kolt.locationpicker.*
• io.github.appspiriment.kolt.updateutils.* → io.github.koltalabs.kolt.updateutils.*

5. Component Renames

All UI widgets have transitioned to the unified Kolt* prefix:

• AppsButton → KoltButton
• AppsPageScaffold → KoltPageScaffold
• AppsTopBar → KoltTopBar
• AppsCard → KoltCard
• AppsAccordion → KoltAccordion
• AppsBadge → KoltBadge
• AppsTooltip → KoltTooltip
• AppsStatusTag → KoltStatusTag
• AppspirimentText → KoltText
• AppspirimentTheme → KoltTheme