vgo optimizes vector graphics through a format-agnostic approach by leveraging vgo-core's intermediate representation. It can convert between common vector formats, including SVG, Android Vector Drawables, and Jetpack Compose ImageVector and optimize them to boot.

brew install jzbrooks/repo/vgo

Download the distribution from the release page and ensure it has execute permission. On macOS & Linux run chmod u+x vgo.

vgo requires Java 17.

The plugin aims to be fast and small by leveraging (for the entire tool) the JVM your Gradle build is already using.

The shrinkVectorGraphic task is added to your project on plugin application.

The checkVectorGraphic task is also added, a verification counterpart that fails the build if any vector graphic is not fully shrunk (without modifying any files)

To incorporate the plugin in your build, configure maven central plugin resolution:

pluginManagement {
    repositories {
        mavenCentral()
        gradlePluginPortal()
    }
}

Then, in the relevant project, add the plugin.

import com.jzbrooks.vgo.plugin.OutputFormat

plugins {
    id 'com.jzbrooks.vgo'
}

// Default configuration shown
vgo {
    inputs.setFrom(fileTree('src') {
        include '**/res/drawable*/*.xml'
    })
    outputs.setFrom(inputs) // omit to optimize files in place
    showStatistics.set(true)
    format.set(OutputFormat.UNCHANGED)
    noOptimization.set(false)
    indent.set(0)
}

> vgo [options] [file/directory]

Options:
  -h --help          print this message
  -o --output        file or directory, if not provided the input will be overwritten
  -s --stats         print statistics on processed files to standard out
  -v --version       print the version number
  --indent [value]   write files with value columns of indentation
  --format [value]   output format (svg, vd, iv)
  --no-optimization  skip graphic optimization
  --stdin            read newline-delimited file paths from standard input
  --check            verify inputs are fully shrunk without writing; prints files that would change and exits non-zero
  --print-ir[=MODE]  print IR tree and exit without writing (auto [default], color, plain; use = to pass mode)  

java -jar vgo for Windows

Generated: 2026-08-08T01:08:39.241Z

Corpus: /Users/justin/projects/vgo/vgo/src/test/resources (10 files, 16733816 bytes)

Runs: 10; warmups: 3; batch size: 100

Timing includes CLI startup, parsing, optimization, and writes. Corpus setup and validation are excluded. Structural validation does not prove visual equivalence.

# Optimize files specified from standard in
> find ./**/ic_*.xml | vgo --stdin

# Optimize vector.xml and overwrite its contents
> vgo vector.xml

# Optimize vector.xml and write the result into new_vector.xml
> vgo vector.xml -o new_vector.xml

# Optimize multiple input sources write results to the
> vgo vector.xml -o new_vector.xml ./assets -o ./new_assets

# Fail (non-zero exit) if any vector is not fully shrunk — useful in CI
> vgo --check ./assets

import com.jzbrooks.vgo.plugin.OutputFormat

// Optimize and convert svgs to vector drawables at build time
vgo {
    format.set(OutputFormat.VECTOR_DRAWABLE)
    inputs.setFrom(
        fileTree("icons") {
            include("**/*.svg")
        }
    )

    val drawableDir = layout.projectDirectory.dir("src/main/res/drawable")
    outputs.setFrom(
        inputs.elements.map { svgs ->
            svgs.map { svg -> drawableDir.file("${svg.asFile.nameWithoutExtension}.xml") }
        }
    )
}

tasks.named("processDebugResources") {
    dependsOn("shrinkVectorGraphic")
}

This project uses the Gradle build system.

To build the binary: ./gradlew binary

To run the tests: ./gradlew check

To see all available tasks: ./gradlew tasks