Introduction: A ktlint gradle plugin
More: Author   ReportBugs   

Join the chat at https://gitter.im/ktlint-gradle/Lobby Build Status

Provides a convenient wrapper plugin over the ktlint project.

This plugin can be applied to any project but only activates if that project has the kotlin plugin applied. The assumption being that you would not want to lint code you weren't compiling.


This plugin was written using the new API available for gradle script kotlin builds. This API is available in new versions of gradle.

This plugin has only been tested with gradle 3.5 and should work with versions 3.5+.

If you find this plugin works with older versions feel free to update this readme to reflect this.

How to use

Build script snippet for use in all Gradle versions:

buildscript {
  repositories {
    maven {
      url "https://plugins.gradle.org/m2/"
  dependencies {
    classpath "gradle.plugin.org.jlleitschuh.gradle:ktlint-gradle:3.2.0"

apply plugin: "org.jlleitschuh.gradle.ktlint"

Build script snippet for new, incubating, plugin mechanism introduced in Gradle 2.1:

plugins {
  id "org.jlleitschuh.gradle.ktlint" version "3.2.0"

Optionally apply plugin to all project modules:

subprojects {
    apply plugin: "org.jlleitschuh.gradle.ktlint" // Version should be inherited from parent


The following configuration block is optional.

If you don't configure this the defaults defined in the KtlintExtension object will be used. The version of Ktlint used by default may change between patch versions of this plugin. If you don't want to inherit these changes then make sure you lock your version here.

ktlint {
    version = ""
    debug = true
    verbose = true
    android = false
    outputToConsole = true
    reporters = ["PLAIN", "CHECKSTYLE"]
    ignoreFailures = true

Tasks Added

This plugin adds two tasks to every source set: ktlint[source set name]Check and ktlint[source set name]Format. Additionally, a simple ktlintCheck task has also been added that checks all of the source sets for that project. Similarly, a ktlintFormat task has been added that formats all of the source sets.

If project has subprojects - plugin also adds two meta tasks ktlintCheck and ktlintFormat to the root project that triggers related tasks in subprojects.


IDE Support

Import the settings.gradle.kts file into your IDE.

To enable Android sample either define ANDROID_HOME environmental variable or add local.properties file to project root folder with following content:



./gradlew build

Future Development

Add support for linting *.kts for gradle script kotlin builds.

Ktlint Gradle Plugin on the Gradle Plugin Registry

Support Me
About Me
Google+: Trinea trinea
GitHub: Trinea