assets_gen 1.5.0

Published Aug 12, 2025

The assets_gen package helps you to generate a .dart file that contains all assets according to `pubspec.yaml`.

assets_gen

The assets_gen package helps you to generate a .dart file that contains all assets according to pubspec.yaml.

Way to reference asset path	Sample Code
Use string path directly	`Image.asset('assets/images/foo.png');`	❌ Unsafe
Use `assets_gen`	`Image.asset(Assets.assets_images_foo_png);`	✅ Good

dev_dependencies:
  assets_gen: any # Replace 'any' with version number.
  build_runner: any # Optional.

	Call directly (Recommend)	Use `build_runner`
Run a single build and exit.	`flutter pub run assets_gen build`	`flutter pub run build_runner build`
Continuously run builds as you edit files.	`flutter pub run assets_gen watch`	`flutter pub run build_runner watch`

More info about pub-run and build_runner.

# Specify an assets_gen section in pubspec.yaml or assets_gen.yaml
flutter:
  assets:
    - path/to/asset
assets_gen:
  ...

option	type	default value
`enable`	bool	`true`	Enable or not.
`output`	String	`assets.dart`	Output position, always under `lib/`.
`class_name`	String	`Assets`	The generated class name.
`gen_package_path`	bool	`true`	Whether the builder should generate extra const variable with package info, e.g. `packages/${package}/path/to/foo.png`
`ignore_resolution`	bool	`true`	Whether the builder should ignore resolution variant. e.g. `path/to/3.0x/foo.png` will be ignored.
`omit_path_levels`	int	`0`	The path levels of generated key that the builder will omit. e.g. if levels is 2, the key of `path/to/foo.png` is `foo_png`.
`exclude`	List	none	Listed assets in exclude will be ignored in generated class. It supports glob syntax.
`plurals`	List	none	Plurals support. e.g. Specify a plural `- assets/vip/*.svg` will generate a function like `static String assets_vip_x_svg(Object p0) => 'assets/vip/${p0.toString()}.svg';`.
`code_style`	String	`none`	Identifiers come in three flavors in Dart: `UpperCamelCase`、`lowerCamelCase`、`lowercase_with_underscores`
`with_file_extension_name`	bool	`true`	Whether to include the suffix of the assets file
`format_dart_code`	bool	`false`	Whether to format the generated dart code