java-template

template repo for Java (or Kotlin/Scala) Gradle projects

Features

• JDK 21 (Amazon Corretto)
• Gradle 8 (Kotlin DSL)
• GitHub Actions CI/CD
• Automatic code formatting via Spotless
  • Java: google-java-format
  • Kotlin: ktfmt
  • Scala: scalafmt
• Code style analysis via Checkstyle
• Static analysis via SpotBugs
• Unit and integration test support via JUnit 5 and TestSets plugin
• Code coverage reporting via Codecov
• Dependency upgrades via Renovate bot

Usage

• Click Use this template
  • This will prompt you to create a new repo with all the files setup
• Rename the root project (currently java-template) and group (currently com.willmolloy) to your liking
• Delete anything you won't use
• Update the README
• Other non-code setup like GitHub branch protections
• NOTE: if creating a private repo, you probably want to disable the windows and mac builds

Build and test

./gradlew spotlessApply build integrationTest

Upgrade Gradle

Renovate should cover this

• Find the version number on the releases page
  • Java Compatibility Matrix
• Run: ./gradlew wrapper --gradle-version <VERSION> --distribution-type all

Upgrade Java

• Download the JDK using IntelliJ
• Update all references

Promise

• Keep up to date with:
  • Future Java versions
  • Future Gradle versions
  • Other dependency upgrades
  • Any other cool tools or plugins

---

Generated from java-template