# diffplug/spotless

Keep your code spotless

Repository: https://github.com/diffplug/spotless
Canonical: https://ross.abutalabs.com/products/spotless
Language: Java
License: Apache-2.0
License Family: permissive
Topics: gradle, java, plugin-gradle, formatter, kotlin, scala, groovy, maven, prettier, javascript, typescript, sql, css, sass
Last push: 2026-08-22T18:13:32+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 86, longevity 100
- inputs: {"age_days": 4146, "days_push": 11, "days_rel": 16, "gap_med": 0, "n_releases_24m": 70}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5624, forks 553 (observed 2026-08-28T04:09:23.137106+00:00)

## What it is
Spotless is a code formatting plugin for Gradle, Maven, and SBT that checks and automatically fixes formatting violations across many languages including Java, Kotlin, Scala, Groovy, JavaScript, TypeScript, SQL, and more. It integrates formatters like google-java-format, Prettier, and ktlint, and can enforce license headers and git ratcheting.

## Use cases
- enforce consistent code style across a java project
- auto-format kotlin and scala code in gradle builds
- fail CI builds when formatting violations exist
- apply prettier to typescript and javascript files via maven
- manage license headers across source files
- format sql, yaml, markdown, and css files in a repo

## When to choose
- you build with gradle or maven and want automated, enforceable formatting
- you need multi-language formatting in a single plugin
- you want format checks integrated into your build and CI

## When to avoid
- you need a standalone formatter outside a build tool
- your language or build system is unsupported
- you want an editor-first formatting experience rather than build-integrated

## Facets
- artifact type: plugin
- maturity: stable
- function: formatter, build-tool, linter, developer-tools
- domain: developer-tools, version-control, web-development, testing
- platform: jvm, cross-platform
- tags: code-formatting, gradle-plugin, maven-plugin, java, kotlin, prettier, license-headers, code-style, gradle, maven

## Member repositories
- diffplug/spotless (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:23.137106+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:55:22.454159+00:00, confidence not recorded.
  - readme: https://github.com/diffplug/spotless (fetched 2026-08-28T04:09:23.137106+00:00, sha 57ee1c189dd3)
- Data as of 2026-08-30T08:39:29.467469+00:00.