README

Usage

// settings.gradle.kts
dependencyResolutionManagement {
    versionCatalogs {
        create("sb") {
            from("com.xenoterracide.gradle.vc:version-catalog-spring-boot:3.5.0")
        }
    }
}

// build.gradle.kts
dependencies {
    // or however you want we aren't generating the BOM.
    implementation(platform("org.springframework.boot:spring-boot-dependencies:3.5.0"))
    implementation(sb.spring.boot.starter.data.jpa.test)
}

See the version catalog documentation for more details.

Available libraries can be found in the Spring Boot documentation. Since this catalog does not supply versions, you must still use the spring-boot-dependencies BOM.

FAQ

Versions

The major and minor versions of this catalog align with the Spring Boot version. The patch version is incremented for updates to the catalog itself.

Gradle Support

Gradle 7.2 or later is required. Stable support for version catalogs was introduced in Gradle 7.4.

Development

Languages

asdf is suggested, you can use whatever you'd like to get

• Java 17+
• NodeJs
• Python 3.11+

add a way to export these to your PATH in your ~/.profile

if you have asdf installed, you can run asdf install to install the versions`

Build Tools

• Gradle
• Yarn 4 - formatting commit hooks (via Corepack)
• PIP - reuse license header commit hooks

Setup & Dependencies

Use Yarn 4 (via Corepack) for dev tooling and helper scripts. Commit hooks are installed via a helper script.

# Enable Corepack and install Node dev tools defined in package.json
corepack enable
yarn install --immutable

# Install Python tools and set up commit hooks
yarn contributor

# Optional: verify/refresh Gradle dependency locks
yarn ug          # fast (no scan)
yarn ug:scan     # with build scan and extra output

Committing

Use Conventional Commits.

Releasing

git tag -m "v0.12.1" -a v0.12.1 && git push --tags

License

All licenses are documented explicitly using SPDX identifiers in their file

• Java: GPLv3
  with Classpath Exception
• Gradle Kotlin and Config Files: MIT
• Documentation including Javadoc: CC BY 4.0

Copyright © 2024 - 2025 Caleb Cushing