Skip to content
CAI
Software that uses CAICheck a score

GradleUp/shadow

65.0

Adequate · 13 November 2026

5.2k

lines of production code

Kotlin

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Introduce R8-based application minimization

Users can now minimize the final shadowed JAR using R8 instead of the previous dependency-analysis approach. This change adds internal support for an R8-based shrinker (R8Minimizer, DefaultR8Spec, DefaultMinimizeSpec) that runs after all relocations and resource merging, allowing configuration of obfuscation, optimization, ProGuard rules, and classpath files. It also includes supporting internal components for dependency filtering, manifest handling, and bytecode remapping to integrate this new minimization path.

src/main/kotlin/com/github/jengelman/gradle/plugins/shadow/internal · high confidence

Project initialization and documentation overhaul

The repository has been initialized with a comprehensive documentation structure, including a new MkDocs-based user guide, a detailed changelog, and updated contributing and releasing guidelines. The project now enforces consistent code formatting via EditorConfig and Spotless, standardizes line endings with Git attributes, and provides a Gradle wrapper for reproducible builds. The README has been expanded to clarify the plugin's purpose, display compatibility matrices for Gradle and Java versions, and note the maintenance transfer to the GradleUp organization.

(repo-wide) · high confidence

ShadowJar now supports R8-based minimization

The ShadowJar task now offers an R8-based minimization option alongside the existing dependency analyzer. Users can configure this via the new \minimize()\ DSL, selecting the \R8\ tool in \MinimizeSpec\ and providing rules through \R8Spec\ (including \proguardRules\, \proguardRuleFiles\, and classpath configuration). This enables more aggressive shrinking of the shadowed JAR. The previous \minimizeJar\ property is deprecated in favor of this new configuration.

src/main/kotlin/com/github/jengelman/gradle/plugins/shadow/tasks · high confidence

API

Initial public API surface for Gradle Shadow Plugin

The plugin now exposes a formal public API contract via the \api/shadow.api\ file, defining the stable interfaces and classes for users. This includes the core plugins (\ShadowApplicationPlugin\, \ShadowBasePlugin\, \ShadowJavaPlugin\, \ShadowKmpPlugin\, \ShadowPlugin\), the main extension point (\ShadowExtension\), and key task/transformer components like \DependencyFilter\, \FindResourceInClasspath\, and the relocation system (\Relocator\, \SimpleRelocator\, \RelocateClassContext\). This establishes the boundary for binary compatibility and documents the public-facing capabilities of the plugin.

api · high confidence

Behavioural changes

2 commits (1 fix) modifying src/testKit

A change to existing behaviour in src/testKit — 2 commits (1 fix), 1 file: “Revert "Narrow Log4j2Plugins.dat to test sources"”; “Share test kits in a new source set (\#1747)” (refs \#1747).

src/testKit · medium confidence · unverified

Add empty BuildLogicPlugin stub in build-logic

A new \BuildLogicPlugin\ class has been added to the \gradle/build-logic\ module. This class implements the Gradle \Plugin\<Project\>\ interface but performs no operations in its \apply\ method, serving as a placeholder or registration point for build logic configuration.

gradle/build-logic/src/main/kotlin/com/github/jengelman/gradle/plugins/shadow · high confidence

Add legacy plugin implementation class

A new properties file has been added to register the legacy shadow plugin implementation, pointing to the \LegacyShadowPlugin\ class. This change enables the plugin to be applied using legacy plugin IDs, supporting backward compatibility for users relying on older plugin application methods.

src/main · high confidence

Independent document test execution for Groovy and Kotlin snippets

Document tests now execute build snippets in isolated, independent Gradle projects rather than relying on a shared test infrastructure. The new \SnippetExecutable\ interface and its \GroovyBuildExecutable\ and \KotlinBuildExecutable\ implementations generate temporary multi-project builds (including \api\ and \main\ subprojects) to validate documentation examples against both Groovy (\build.gradle\) and Kotlin (\build.gradle.kts\) DSLs. This change ensures that each snippet is tested in a clean environment, improving reliability by preventing cross-test interference and allowing for more accurate validation of build script configurations.

src/documentTest/kotlin/com/github/jengelman/gradle/plugins/shadow · high confidence

Reproducible builds, deduplication, and relocation improvements

This release introduces several changes to improve build reproducibility, resource handling, and relocation logic. Reproducible properties are now serialized without comments and with sorted keys to ensure consistent output across builds. A new DeduplicatingResourceTransformer detects and fails on duplicate resources with different content, while allowing exclusions for legitimate duplicates like POM metadata. Relocation logic has been refined with new context objects (RelocateClassContext, RelocatePathContext) and extensions for Iterable\<Relocator\>, and SimpleRelocator now supports skipping string constant remapping. Additionally, ZIP entry writing is centralized with path traversal protection and case-insensitive filesystem handling, and the deprecated TransformerContext.Builder is marked for removal in Shadow 10. Also in this area: 1 commit (0 fixes) modifying repository; Updated Spotless and Ktfmt formatting rules.

repository · medium confidence · unverified

Reproducible builds, deduplication, and relocation improvements

This release introduces several changes to improve build reproducibility, resource handling, and relocation logic. Reproducible properties are now serialized without comments and with sorted keys to ensure consistent output across builds. A new DeduplicatingResourceTransformer detects and fails on duplicate resources with different content, while allowing exclusions for legitimate duplicates like POM metadata. Relocation logic has been refined with new context objects (RelocateClassContext, RelocatePathContext) and extensions for Iterable\<Relocator\>, and SimpleRelocator now supports skipping string constant remapping. Additionally, ZIP entry writing is centralized with path traversal protection and case-insensitive filesystem handling, and the deprecated TransformerContext.Builder is marked for removal in Shadow 10. Also in this area: 3 commits (0 fixes) modifying src/main/kotlin/com/github/jengelman/gradle/plugins/shadow; Updated Spotless and Ktfmt formatting rules; Relocator interface now supports skipping string constant remapping.

src/main/kotlin/com/github/jengelman/gradle/plugins/shadow/relocation · medium confidence · unverified

Resource transformers migrated to Kotlin with caching and pattern filtering

The resource transformers in the shadow plugin have been rewritten in Kotlin and annotated with @CacheableTransformer to enable Gradle build caching. Most transformers now implement PatternFilterableResourceTransformer, allowing users to filter which resources are processed using standard Gradle pattern sets. Several transformers have been deprecated in favor of simpler alternatives: ApacheLicenseResourceTransformer and DontIncludeResourceTransformer are replaced by ShadowJar.exclude, IncludeResourceTransformer by ShadowJar.from, and ManifestAppenderTransformer by ManifestResourceTransformer. New transformers have been added, including MergeLicenseResourceTransformer for aggregating license files, ProGuardFilesResourceTransformer for merging R8/ProGuard rules, and DeduplicatingResourceTransformer for content-based deduplication.

src/main/kotlin/com/github/jengelman/gradle/plugins/shadow/transformers · high confidence

Shadow plugin rewritten in Kotlin with modular architecture and new configuration options

The Shadow Gradle plugin has been completely rewritten in Kotlin and restructured into a modular architecture. The main entry point, ShadowPlugin, now delegates to specialized plugins (ShadowBasePlugin, ShadowJavaPlugin, ShadowApplicationPlugin, and ShadowKmpPlugin) based on the applied Gradle plugins, replacing the previous monolithic implementation. This change introduces a new ShadowExtension interface that allows users to configure behavior via properties such as addShadowVariantIntoJavaComponent, addTargetJvmVersionAttribute, bundlingAttribute, and addShadowJarToAssembleLifecycle. The plugin now supports Kotlin Multiplatform by configuring shadowJar tasks for JVM targets, while explicitly failing when used with the Android Gradle Plugin. Additionally, the ShadowDslMarker annotation has been renamed to ShadowDsl, with the old name deprecated as an error-level deprecation.

src/main/kotlin/com/github/jengelman/gradle/plugins/shadow · high confidence

Test coverage

Add test utility functions for object factories and ZIP streams; Added GenerateDocTests build task; Added functional tests for resource transformers; Added test resources for Maven Wagon component configuration; Added tests for Shadow plugin properties and task configurations; Added tests for ShadowCopyAction Zip64 handling and parallel remapping; Added unit tests for internal Shadow plugin components; Added unit tests for relocation logic and signature pattern mapping; Added unit tests for resource transformers; Expanded functional test coverage for Shadow plugin capabilities; New test utility classes for Maven repository simulation and JAR construction; New test-kit utilities for JAR inspection and Gradle runner configuration.

Dependencies

Initialize Gradle Wrapper with version 9.8.0

The project now includes a Gradle wrapper configuration file (gradle-wrapper.properties) that pins the build tool to version 9.8.0. This ensures that all developers and CI systems use the same specific Gradle distribution, downloaded from the official services URL, rather than relying on a globally installed version. The wrapper is configured to validate the distribution URL and store the downloaded archives in the user's home directory.

gradle/wrapper · high confidence

Shadow plugin 9.7.0-SNAPSHOT: Kotlin 2.4.20, Gradle 9.4.0+, and modernized build infrastructure

This release updates the Shadow Gradle plugin to version 9.7.0-SNAPSHOT, raising the minimum supported Gradle version to 9.4.0 and migrating the build to Kotlin 2.4.20. The project now uses a version catalog (libs.versions.toml) to manage dependencies, including updates to core libraries like jdependency (2.16), Log4j (2.26.1), and ASM/plexus components. The build infrastructure includes a dedicated build-logic subproject, integration with Develocity 4.6.0 for build scans, and configuration for publishing to Maven Central under the new \com.gradleup.shadow\ group. Users benefit from improved compatibility with modern Gradle features like the configuration cache and isolated projects, as well as stricter Kotlin ABI validation.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 68 → 65 (-2.6)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 98 → 96 (-1.8)
  • Architecture 100 → 100 (-0.1)
  • Maturity 63 → 59 (-3.9)
  • Readiness 60 → 59 (-1.5)
  • Security 68 → 68 (+0.0)

Resolved (10)

  • Change coupling: ShadowPlugin.kt ↔ ShadowJar.kt (src/main/kotlin/com/github/jengelman/gradle/plugins/shadow/ShadowPlugin.kt)
  • Dependency hygiene PARTLY measured — Maven/Gradle declarations read, no dependency graph resolved
  • Documentation: contradicts the code (docs/configuration/minimizing/README.md)
  • Documentation: contradicts the code (docs/configuration/reproducible-builds/README.md)
  • Duplicated block (5 lines × 2) (src/main/kotlin/com/github/jengelman/gradle/plugins/shadow/transformers/AppendingTransformer.kt)
  • Inconsistent naming for configuration methods. Similar to 'relocate', 'transform' is overloaded. Passing a Class or Transformer instance suggests 'adding' a transformer, while the no-arg action might imply configuring a default or global transformer. The verb 'transform' is ambiguous when used as a configuration method for adding components.
  • Inconsistent naming for configuration methods. While overloading is acceptable, the method name 'relocate' is used for both simple string-based relocation and complex relocator objects. In the context of the API, 'relocate' implies a specific action (mapping source to dest), whereas passing a 'Relocator' object is more about 'adding' or 'applying' a strategy. This creates a slight semantic ambiguity between configuring a simple rule vs injecting a complex component.
  • Off-boarding risk: anonymized user #1
  • TodoComment (src/testKit/kotlin/com/github/jengelman/gradle/plugins/shadow/testkit/GradleRunner.kt)
  • TodoComment (src/testKit/kotlin/com/github/jengelman/gradle/plugins/shadow/testkit/GradleRunner.kt)

New (86)

  • Change coupling: R8Minimizer.kt ↔ Zip.kt (src/main/kotlin/com/github/jengelman/gradle/plugins/shadow/internal/R8Minimizer.kt)
  • ClassTooLong: ShadowJar (src/main/kotlin/com/github/jengelman/gradle/plugins/shadow/tasks/ShadowJar.kt)
  • Duplicated block (5 lines × 2) (src/main/kotlin/com/github/jengelman/gradle/plugins/shadow/transformers/AppendingTransformer.kt)
  • Edited copy of a member (14 corresponding lines) (src/main/kotlin/com/github/jengelman/gradle/plugins/shadow/transformers/PropertiesFileTransformer.kt)
  • FileTooLong: tasks/ShadowJar.kt (src/main/kotlin/com/github/jengelman/gradle/plugins/shadow/tasks/ShadowJar.kt)
  • Off-boarding risk: anonymized user #1
  • Outdated (compile): biz.aQute.bnd:biz.aQute.bnd.annotation
  • Outdated (compile): com.fasterxml.jackson.core:jackson-annotations
  • Outdated (compile): com.fasterxml.jackson.core:jackson-core
  • Outdated (compile): com.fasterxml.jackson.core:jackson-databind
  • Outdated (compile): com.fasterxml.jackson.dataformat:jackson-dataformat-xml
  • Outdated (compile): com.fasterxml.jackson.module:jackson-module-kotlin
  • Outdated (compile): com.fasterxml.jackson:jackson-bom
  • Outdated (compile): com.fasterxml.woodstox:woodstox-core
  • Outdated (compile): com.google.code.gson:gson
  • Outdated (compile): com.google.errorprone:error_prone_annotations
  • Outdated (compile): com.google.guava:failureaccess
  • Outdated (compile): com.google.guava:guava
  • Outdated (compile): com.google.j2objc:j2objc-annotations
  • Outdated (compile): com.google.jimfs:jimfs
  • …and 66 more

Changes since last survey

  • 16 commits — 16 feature/other, 0 fixes

By area

  • src/main — 5 commits
  • (root) — 4 commits
  • gradle/libs.versions.toml — 4 commits
  • gradle/wrapper — 2 commits
  • docs/configuration — 1 commit

Notable commits

  • change: Add absentProviderCompat for providers.absent() (#2357)
  • change: Document that excluded dependencies are not added to shadow configuration (#2344)
  • change: Eliminate redundant apply for fileCollection helper (#2342)
  • change: Parallelize source remapping for shadowed sources JAR (#2345)
  • change: Remove runtime dependency on log4j-core (#2343)
  • change: Share parent directory entry writing between JARs (#2356)
  • change: Simplify Spotless configuration for Kotlin (#2355)
  • change: Support shadowed sources JAR (#2265)
  • change: Update Gradle to v9.9.0 (#2354)
  • change: Update Gradle to v9.9.1 (#2359)
  • change: Update dependency com.android.tools:r8 to v9.5.29 (#2351)
  • change: Update dependency com.android.tools:r8 to v9.5.32 (#2360)
  • change: Update dokka to v2.3.0 (#2352)
  • change: Update plugin android-lint to v9.5.0 (#2348)
  • change: Update plugin android-lint to v9.5.1 (#2353)
  • change: Update plugin spotless to v8.11.0 (#2349)

Architecture

  • Unchanged — 0 containers · 2 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

GradleUp/shadow was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit a2e42ba78e687ae347389d78f64b0e213322a987 — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.64+preprod-569132d3dfbe.