svgx #

High-performance static & animated SVG rendering for Flutter.

• Static SVG parses through Rust (usvg) into a cached ui.Picture, then renders with Flutter's own GPU pipeline — no CPU rasterizer.
• Animated SVG (SMIL — <animate>, <animateTransform>, <animateMotion>, <set>) runs through an original Dart-side engine: parse once, sample and paint every frame in pure Dart, so no per-frame data crosses the Rust FFI boundary.
• One widget, Svgx, auto-detects which path a source needs.

Usage #

import 'package:svgx/svgx.dart';

Svgx.string(
  svgSource,
  width: 48,
  height: 48,
)

Svgx inspects the source for SMIL animation markers and dispatches to the static or animated renderer accordingly — most callers never need to think about which path they're on.

Recoloring #

Svgx.string(
  svgSource,
  width: 24,
  height: 24,
  colorFilter: ColorFilter.mode(Colors.blue, BlendMode.srcIn),
)

currentColor in the source is controlled separately via SvgTheme, honored by both the static and animated rendering paths:

Svgx.string(svgSource, theme: SvgTheme(currentColor: Colors.blue))

Animation quality #

For the animated path, SvgxAnimationQuality trades fidelity for throughput under high concurrency (e.g. a scrolling grid of many animated icons) — adaptive frame-skipping is the default; see its class doc for the full set of opt-in/opt-out trade-offs and exactly what each one costs.

Svgx.string(
  svgSource,
  quality: const SvgxAnimationQuality(),
)

Static-only / animated-only widgets #

SvgxStatic and SvgxAnimated are the two renderers Svgx dispatches to, exported for callers who already know which one they need (e.g. an icon set known ahead of time to be all-static).

Why not flutter_svg? #

svgx exists to replace flutter_svg + iconify_flutter with a single library that also does animation. Static parsing is delegated to usvg (the same crate resvg builds on), so static feature coverage tracks a mature, actively-maintained parser rather than a hand-rolled one. Rendering — static and animated alike — stays on Flutter's own GPU pipeline; nothing is rasterized on the CPU.

Status #

Actively developed. See doc/ in the repository for the full acceptance criteria, supported-feature matrix, and performance benchmark history.

Contributing #

Issues and PRs welcome at the repository.