Skip to main content Skip to docs navigation


Document not reviewed yet, might be outdated. Please, let us know if you find something invalid here.
On this page

KorGE supports several desktop, web, and mobile targets. In this section you will find details for each supported target.

    The KorGE Gradle Plugin is the in handle of exposing all the tasks that allow to run and build the targets.

    Its development happens here:

    The korge extension

    The korge extension is a DSL to configure the application. For further reference you can find the source code here.

    korge {
        id = "com.unknown.unknownapp"
        version = "0.0.1"
        exeBaseName = "app"
        name = "unnamed"
        description = "description"
        orientation = Orientation.DEFAULT
        copyright = "Copyright (c) 2019 Unknown"
        // Configuring the author
        authorName = "unknown"
        authorEmail = "unknown@unknown"
        authorHref = "http://localhost"
        author("name", "email", "href")
        icon = File(rootDir, "icon.png")
        gameCategory = GameCategory.ACTION
        fullscreen = true
        backgroundColor = 0xff000000.toInt()
        appleDevelopmentTeamId = java.lang.System.getenv("DEVELOPMENT_TEAM") ?: project.findProperty("appleDevelopmentTeamId")?.toString()
        appleOrganizationName = "User Name Name"
        entryPoint = "main"
        jvmMainClassName = "MainKt"
        androidMinSdk = null
        config("MYPROP", "MYVALUE")
        // Korge Plugins
        plugin("com.soywiz:korge-admob:$korgeVersion", mapOf("ADMOB_APP_ID" to ADMOB_APP_ID))
        admob(ADMOB_APP_ID) // Shortcut for admob

    Project structure

    Three small files (plus Gradle 8.3) is all you need to get started:


    In this file you include and configure the KorGE Gradle plugin.

    The plugin does:

    • Choose and configure the right supported kotlin-multiplatform. At this point, it uses 1.9.20.
    • Include all the artifacts required for KorGE.
    • Add tasks to compile, install and run all the supported targets by the platform.
    • Enable an extension called korge where you can configure properties of your application (application title, id, icon…)
    import com.soywiz.korge.gradle.*
    buildscript {
    	repositories {
    		maven { url = uri("") }
    	dependencies {
    		classpath("com.soywiz:korge-gradle-plugin:1.0.2") // KorGE version here
    apply(plugin = "korge")
    korge {
    	id = "com.sample.demo"


    All your common source files must be stored here. If you want to have specific source files per platform, you can use the directory structure of Kotlin-Common. For example: src/androidMain/kotlin, src/jsMain/kotlin, src/jvmMain/kotlin, src/iosX64/kotlin


    KorGE requires the entry point to be a suspend fun main function without arguments. In most of the targets, this function is called directly. But in Android and iOS, this main will be called after from an Activity or a ViewController. All these details are handled by the KorGE gradle plugin.

    suspend fun main() = Korge {
        solidRect(100, 100, Colors.RED)

    Gradle Tasks

    In addition to all the low-level tasks offered by the kotlin-multiplatform plugin, KorGE offers additional tasks:

    For Windows, change all the ./gradlew for gradlew.bat.

    The most basic task to run your application is ./gradlew runJvm.

    For the rest of the tasks and details for each platform, check the Targets section:

    Was this article useful?