FlutterGen/flutter_gen

FlutterGen is a code generation tool for Flutter applications that produces type-safe Dart classes for accessing static assets, colors, and fonts. It supports a wide range of asset formats including images, SVGs, Lottie animations, and Rive files, while also handling complex scenarios like flavored assets and multi-package workspaces. The system provides a command-line interface and a build runner integration to automate the generation process based on project configuration.

19 changes.

The project was restructured into a monorepo using Melos, splitting the codebase into distinct command, core, and runner packages to support multi-package workspaces. This period focused on refactoring the core generator logic to enforce new configuration structures and introducing modular integrations for assets, SVGs, Lottie, and Rive animations. The work culminated in a unified CLI and build runner that coordinate asset generation across workspace members.

9 changes.

This period focused on establishing a comprehensive example application to demonstrate FlutterGen's capabilities, including support for Lottie, Rive, and SVG assets across multiple platforms. Concurrently, test coverage was expanded to include new Lottie integration assets and validation for the command-line tool's configuration and workspace handling.

8 changes.

This period focused on extending FlutterGen to support Dart workspaces, enabling asset generation across multiple packages with dedicated examples and test fixtures. The work also enhanced the core asset generation capabilities by adding support for Flare assets, SVG vector graphics, and type-safe color and font classes, alongside improved testing infrastructure.

The example application now includes a comprehensive set of static assets to support demonstration scenarios. This adds Lottie animation JSON files (including specific versions like v4.4.0 and v4.3.9, plus a 'wrong' directory for testing), SVG icons for Dart, Fuchsia, KMM, and Paint, color resource definitions in XML, sample JSON data structures, and placeholder image files.

examples/example/assets · high confidence

The example application now includes a complete macOS target, enabling users to build and run the app on macOS. This adds the native macOS project structure, including the Xcode workspace, Swift application entry points (AppDelegate and MainFlutterWindow), and configuration files. It also registers the Rive plugin via GeneratedPluginRegistrant, allowing the example to utilize Rive animations on the desktop platform.

examples/example/macos · high confidence

This change introduces a minimal example demonstrating how to use FlutterGen within a Dart workspace, alongside the corresponding test fixtures required to validate this functionality. The example in \examples/example\_workspace\ shows how to configure \build\_runner\ with the \--workspace\ flag to generate asset accessors across multiple packages (\gallery\_one\, \gallery\_two\), requiring Dart SDK \>=3.7.0 and \build\_runner\ \>=2.12.0. Additionally, test fixtures in \packages/runner/test\_fixtures/workspace/packages/app\ provide a sample package structure with assets, fonts, and colors to support testing of the workspace-aware generation logic.

_examples/example\_workspace, packages/runner/test\fixtures/workspace/packages/app · high confidence

The example app now includes generated Dart classes for type-safe asset access, color constants, and font families. The \assets.gen.dart\ file provides typed accessors for images, SVGs, Lottie animations, Rive animations, Flare assets, JSON, and movie files, while \colors.gen.dart\ exposes named color constants and Material color swatches, and \fonts.gen.dart\ defines static font family strings.

packages/core/example/lib/gen · high confidence

This change introduces a new sample application located in the \examples/example\ directory, demonstrating how to use FlutterGen. The entry includes the standard Flutter project scaffolding, such as \pubspec.yaml\ dependencies, platform-specific folders (Android, iOS, macOS, Web), and configuration files like \analysis\_options.yaml\ and \.gitignore\. It also adds a \.metadata\ file to track the Flutter SDK revision and migration state for the tooling, along with a \README.md\ providing instructions to bootstrap the project using Melos.

examples/example · high confidence

The \packages/runner\ directory has been initialized with standard project scaffolding, including symlinks to the root CHANGELOG, LICENSE, and README files. A \build.yaml\ configuration has been added to enable the \flutter\_gen\_runner\ builder, which generates a \.flutter\_gen.manifest.json\ file during the build process. Additionally, \analysis\_options.yaml\ is configured to inherit the project's linting rules while excluding the example directory from analysis.

packages/runner · high confidence

The iOS example project has been initialized with standard Flutter scaffolding, including the Xcode project and workspace configuration, the main application entry point (AppDelegate), and the necessary asset catalogs for app icons and launch screens. This change establishes the baseline iOS build environment for the example app.

examples/example/ios · high confidence

Adds the \flutter\_gen\_runner\ package, providing a \build\_runner\ integration that generates Flutter assets, colors, and fonts. The implementation uses a two-phase approach (a standard Builder and a PostProcessBuilder) to handle configuration-driven output paths, ensuring correct behavior in both single-package and multi-package workspace builds by resolving package roots via \BuildStep\ rather than the process working directory.

packages/runner/lib · high confidence

The \packages/core/lib/utils\ directory now includes several new helper files that provide core utility capabilities. \cast.dart\ adds a \safeCast\ function for type-safe casting. \color.dart\ introduces logic to generate Material Design color swatches and accents from a primary hex color, including helper methods for hex conversion and color mixing. \string.dart\ adds extensions and functions to convert strings to camelCase and snakeCase. Additionally, \identifer.dart\ provides utilities to validate and convert Dart identifiers, \formatter.dart\ configures the Dart formatter based on SDK constraints and page width, \log.dart\ sets up a dedicated logger, \map.dart\ offers a recursive map merging utility, \file.dart\ defines a file writer typedef, and \error.dart\ introduces an \InvalidSettingsException\.

packages/core/lib/utils · high confidence

The example application in examples/example/lib/main.dart has been introduced to showcase FlutterGen's auto-generated asset classes (images, fonts, colors) and integration with the Rive animation library. The app renders various assets including Lottie animations, SVGs, and Rive files, demonstrating how to use generated asset paths and keys, as well as implementing a custom Rive widget with proper lifecycle management for file loaders.

examples/example/lib · high confidence

Added two new example packages, gallery\_one and gallery\_two, to the example workspace. gallery\_one includes generated Dart code for image assets (flutter3.jpg) using FlutterGen, while gallery\_two includes generated code for an SVG asset (dart.svg). These changes introduce new library entry points and generated asset classes for these specific example packages.

_examples/example\_workspace/packages/gallery\_one, examples/example\_workspace/packages/gallery\two · high confidence

Added a new example project in the examples/example\_resources directory to demonstrate FlutterGen usage. The sample includes a README with setup instructions, a colors.xml resource file defining standard colors, a Dart SVG asset, and a Lottie animation JSON file.

_examples/example\resources · high confidence

A new Dart script, generate\_facts.dart, has been added to the core scripts package to automate the generation of asset, color, and font facts for testing purposes. The script iterates through YAML configuration files in the test\_resources directory, distinguishing between standard pubspec configurations and build-specific ones, and uses the FlutterGenerator to produce corresponding .gen.dart files in the actual\_data output directory, providing detailed error logging to stderr for any failures.

packages/core/scripts · high confidence

The repository has been reorganized into a monorepo managed by Melos, splitting the codebase into separate packages for the command-line tool, core logic, and the build runner, along with example projects. This change introduces workspace support for \build\_runner\ and the CLI, allowing generation across multiple packages. The development toolchain has been updated to Flutter 3.44.4 and Node.js 24.18.0, and standard configuration files for linting, formatting, and dependency management have been added.

(repo-wide) · high confidence

A change to existing behaviour in packages/core/test\_resources/assets/rive — 1 commit, 1 file.

_packages/core/test\resources/assets/rive · low confidence · unverified

A new pre-commit hook has been added to the project to automatically run lint-staged on staged files before each commit, ensuring code style consistency. This change introduces the \.husky/pre-commit\ script which delegates to \pnpm lint-staged --allow-empty\.

.husky · high confidence

The assets generator has been refactored to require configuration options like \style\ and \packageParameterEnabled\ to be placed under \assets.outputs\ in \pubspec.yaml\. If these options are found in their previous locations (e.g., directly under \assets\), the generator now throws an \InvalidSettingsException\ with clear migration instructions, rather than silently accepting or ignoring them. This ensures users are immediately notified of configuration changes required for the new structure.

packages/core/lib/generators · high confidence

The core package has been split into a standalone module, introducing a dedicated build.yaml that configures json\_serializable options (such as enabling any\_map and checked mode) and adding analysis\_options.yaml to enforce consistent code analysis. This structural change is accompanied by the addition of test resources for handling unknown MIME types and standardizing test concurrency settings.

packages/core · medium confidence

The example application in packages/command/example/lib has been updated to showcase the capabilities of FlutterGen. The new main.dart file imports auto-generated asset classes (images, fonts, colors, Rive animations, and Lottie animations) and renders them in a demo UI, replacing previous implementations that may have relied on manual asset handling or other integrations like Flare.

packages/command/example/lib · high confidence

The example application in packages/runner/example/lib has been updated to showcase Rive and Lottie animations alongside standard images and SVGs. The main.dart file now includes widgets for displaying Rive animations (such as 'vehicles' and 'skills') and multiple Lottie animations (including 'hamburgerArrow', 'geometricalAnimation', 'alarmClockLottieV440', and 'runningCarOnRoad'), providing users with a concrete reference for integrating these animation formats into their Flutter apps.

packages/runner/example/lib · high confidence

The generated code in \packages/runner/example/lib/gen\ has been updated to include a new \$AssetsFlareGen\ class for Flare assets (e.g., \Penguin.flr\) and \$AssetsImagesIconsGen\ for SVG vector graphics (e.g., \[e-mail redacted]\, \fuchsia.svg\). Additionally, the generated image classes now support vector graphics via \SvgGenImage\, and the asset generation includes image dimensions and gapless playback by default. The generated color and font classes remain unchanged, providing static access to colors like \crimsonRed\ and font families like \Raleway\.

packages/runner/example/lib/gen · high confidence

The CLI entry point is now implemented in \packages/command/bin/flutter\_gen\_command.dart\, replacing previous inline logic. This update adds a \--workspace\ flag that iterates through all members defined in a pubspec workspace configuration, and a \--version\ flag that displays the current package version. It also supports configuring the pubspec and build file paths via \--config\ and \--build\ options, while enforcing that \--build\ cannot be used simultaneously with \--workspace\.

packages/command/bin · high confidence

The core library now exposes a \FlutterGenerator\ class that orchestrates the generation of assets, colors, and fonts based on the pubspec configuration, and a \version.gen.dart\ file that hardcodes the package version to 5.15.0.

packages/core/lib · high confidence

The asset generation logic has been restructured into distinct integration classes (Image, SVG, Lottie, and Rive) that share a common base, enabling better maintainability and specific feature support. Image assets now include generated size metadata and animation details (frames, duration) when enabled, and default to gapless playback with medium filter quality. SVG generation now supports the .vec format via vector\_graphics\_compiler, exposes theme and color mapping options, and correctly handles package paths. Lottie integration now supports ZIP archives and Telegram sticker (.tgs) files, while Rive integration automatically selects the correct code generation strategy based on the installed rive\_flutter version (splitting behavior for versions below and at/above 0.14.0).

packages/core/lib/generators/integrations · high confidence

The settings module has been restructured to improve configuration management and asset naming. The \Config\ class now explicitly loads and merges options from \pubspec.yaml\, \build.yaml\, and \analysis\_options.yaml\, while also resolving integration versions from \pubspec.lock\. A new \AssetType\ and \UniqueAssetType\ system ensures generated asset identifiers are unique and valid Dart identifiers by handling collisions through extension inclusion or suffix appending. Additionally, support for flavored assets is introduced via the \FlavoredAsset\ class, and the \Import\ abstraction allows for aliased package imports in generated code.

packages/core/lib/settings · high confidence

The generated code in the \lib/gen\ directory has been updated to use the \abstract final\ class modifier for generated classes (e.g., \MyColorName\, \MyFontFamily\) and now includes support for additional asset types. Specifically, \assets.gen.dart\ now generates \LottieGenImage\ and \RiveGenImage\ classes to handle Lottie animations (including \.zip\ and Telegram \.tgs\ files) and Rive animations, respectively. It also introduces \SvgGenImage\ for SVG assets and supports flavored assets (e.g., \chip4\ with \flavors: {'extern'}\). The \colors.gen.dart\ and \fonts.gen.dart\ files are regenerated with the new syntax, providing type-safe access to colors and font families.

examples/example/lib/gen · high confidence

The example application in packages/core/example/lib has been updated to demonstrate Lottie animation support. The main entry point now renders multiple Lottie assets (such as hamburgerArrow, geometricalAnimation, and alarmClockLottieV440) alongside existing Rive animations and static images, providing users with a concrete reference for integrating and displaying Lottie content within the framework.

packages/core/example/lib · high confidence

The generated asset classes in the example now include image dimensions on \AssetGenImage\, enable \gaplessPlayback\ by default for image assets, and apply \FilterQuality.medium\ for rendering. Support for vector graphics has been added via \SvgGenImage\ for SVG files, while Flare integration has been removed in favor of Rive (\RiveGenImage\).

packages/command/example/lib/gen · high confidence

A new \scripts/coverage.sh\ script was added to validate the Codecov configuration and run Dart coverage reports, ensuring CI coverage metrics are correctly generated. Additionally, a new \scripts/test\_xml\_versions.dart\ script was introduced to verify that the core package remains compatible with both \xml\ 6.x and 7.x versions, addressing a regression risk where transitive dependencies might force incompatible major versions.

scripts · high confidence

Added Lottie animation test assets; Added test coverage for core asset generation and integration logic; Added tests for SvgTheme integration behavior; Added tests for the FlutterGen command-line tool; Added tests for workspace build support; Updated FlutterGen test fixtures for generated asset code.

This release updates the FlutterGen code generator to version 5.15.0 across the command, core, and runner packages. It introduces support for Dart SDK ^3.4.0 and adds a new example workspace demonstrating multi-package resolution. The example projects now integrate flutter\_svg ^2.0.0, lottie ^3.0.0, and rive ^0.14.0, while the core package updates its dependencies to include dart\_style ^3.0.0 and archive \>=3.4.0 \<5.0.0. Development tooling is updated with husky 8.0.3, lint-staged ^17.0.0, and prettier ^3.0.3.

(dependencies) · high confidence

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

• First survey — no prior run to compare against. CAI 65.

• Code Health 98
• Architecture 90
• Maturity 54
• Readiness 67
• Security 70
• Domain Modelling 100

• 300 commits — 285 feature/other, 15 fixes

• (root) — 179 commits
• packages/core — 77 commits
• .github/workflows — 23 commits
• examples/example — 7 commits
• (repo) — 3 commits
• packages/runner — 3 commits
• .idea/runConfigurations — 2 commits
• examples/example_resources — 2 commits
• .github/CODEOWNERS — 1 commit
• .github/PULL_REQUEST_TEMPLATE.md — 1 commit
• .vscode/settings.json — 1 commit
• examples/example_workspace — 1 commit

• fix: Fix package root resolution after build_runner 2.14.0 AOT changes (#750)
• fix: Fixes flutter_svg latest version requiring a non null clipBehavior field. (#369)
• fix: Fixes the exclude option descriptions in the README (#536)
• fix: Update PULL_REQUEST_TEMPLATE.md to fix melos command (#434)
• fix: chore: fix concurrency execute with melos. (#563)
• fix: chore: revert release actions
• fix: fix: Make the builder name compatible with both flutter_gen and flutter_gen_runner (#592)
• fix: fix: add package parameter to generated asset provider method (#361)
• fix: fix: add xml 7.x support (#761) (#764)
• fix: fix: provide theme to SvgAssetLoader instead of SvgPicture (#532)
• fix: ✅ Fix tests (#581)
• fix: 💚 Fix artifacts release (#671)
• fix: 💚 Fix invalid codecov config (#622)
• fix: 🔧 [IntelliJ] Fix module configurations (#438)
• fix: 🚨 Fix lints
• change: Add missing parameters in Lottie integration from lottie 3.0.0 (#656)
• change: Add new option parse_animation to parse metadata for animated images (#676)
• change: Add support Telegram Sticker .tgs in Lottie Integration (#659)
• change: Add support for 'useArtboardSize' argument in rive integration (#487)
• change: Add support for deferred components (#576)
• …and 280 more

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

FlutterGen/flutter_gen 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.