🇨🇳 中文文档

A comprehensive SVG optimization library for the Dart/Flutter ecosystem, providing powerful tools to reduce file sizes while preserving visual quality. Inspired by proven optimization techniques used in popular SVG tools.

Package	Description	pub.dev
svgo	Core SVGO library
svgo_cli	Command-line interface
svgo_hooks_example	Build hooks example

• ✅ Parse SVG files into an Abstract Syntax Tree (XAST)
• ✅ Apply various optimization plugins
• ✅ Serialize optimized AST back to SVG string
• ✅ Fully configurable with plugin system
• ✅ Multipass optimization support
• ✅ 54 builtin optimization plugins (full parity with Node.js SVGO)
• ✅ CSS style parsing and computation
• ✅ Path data manipulation utilities
• ✅ Command-line interface

Add svgo to your pubspec.yaml:

dependencies: svgo: any

Then use it in your Dart code:

import'package:svgo/svgo.dart'; voidmain(){final input =''' <svg xmlns="http://www.w3.org/2000/svg" width="100" height="100"> <!-- A red rectangle --> <rect x="0" y="0" width="100" height="100" fill="red"/> </svg> '''; final result =optimize(input); print(result.data); // Output: <svg xmlns="http://www.w3.org/2000/svg" width="100" height="100"><rect width="100" height="100" fill="red"/></svg> }

Install globally:

dart pub global activate svgo_cli

Then use it:

# Optimize a single file (overwrites input) svgo input.svg # Optimize to output directory svgo -o dist input.svg # Optimize all SVGs in a directory svgo "src/**/*.svg"# Multipass optimization with custom precision svgo -m -p 2 icon.svg

final result =optimize(input, SvgoConfig( plugins: [presetDefault], ));

final result =optimize(input, SvgoConfig( plugins: [ removeComments, removeMetadata, cleanupNumericValues.withParams( CleanupNumericValuesParams(floatPrecision:2), ), ], ));

final result =optimize(input, SvgoConfig( multipass:true, ));

• cleanupAttrs - Cleanup attributes from newlines, trailing spaces
• cleanupNumericValues - Round numeric values, remove default units

• removeComments - Remove comments
• removeDesc - Remove <desc> elements
• removeDoctype - Remove DOCTYPE declaration
• removeEditorsNSData - Remove editor-specific namespaces
• removeEmptyAttrs - Remove empty attributes
• removeEmptyContainers - Remove empty container elements
• removeEmptyText - Remove empty text elements
• removeMetadata - Remove <metadata> elements
• removeTitle - Remove <title> elements
• removeUnusedNS - Remove unused namespace declarations
• removeUselessDefs - Remove elements in <defs> without id
• removeXMLProcInst - Remove XML processing instructions

• convertColors - Convert color values to shorter formats
• convertEllipseToCircle - Convert ellipses to circles when rx=ry
• convertShapeToPath - Convert shapes to path elements

• collapseGroups - Collapse useless groups
• moveElemsAttrsToGroup - Move common attributes to parent group
• moveGroupAttrsToElems - Move group transforms to children
• sortAttrs - Sort element attributes
• sortDefsChildren - Sort <defs> children for better compression

• mergeStyles - Merge multiple style elements

Version note: Support for build hooks was introduced in Dart 3.10.

The svgo_hooks_example package demonstrates how to use Dart Hooks to automatically optimize SVG files during build time. See the svgo_hooks_example package for a complete implementation.

This project uses Melos for monorepo management.

# Install melos dart pub global activate melos # Bootstrap (install dependencies for all packages) melos bootstrap # Run analysis melos analyze # Run tests melos test# Format code melos format

MIT License - Copyright (c) 2025 iota9star

See LICENSE for details.

Thanks to SVGO for inspiration and reference.