How to Add Custom Icons to Your Flutter Application

Yawar Osman
2 min readDec 28, 2023

--

Adding custom icons to your Flutter application is a great way to enhance your UI and make your app stand out. Whether you’re adding unique icons for a specific feature or updating your app’s launcher icon, Flutter makes this process relatively straightforward. This article will guide you through the steps of adding custom icons to your Flutter application, including changing the application launcher icon and using custom icons within your app.

Generating Custom Icons in Flutter

FlutterIcon.com is an excellent resource for generating custom icons. You can either upload an SVG file or choose from a wide selection of icons.

Step 1: Selecting and Downloading Icons

Go to FlutterIcon.com, select the icons you need, and download the package. This will include:

  • A TTF file containing your icons
  • A config.json file
  • A Dart class file with your custom icons

Step 2: Adding Icons to Your Project

Move the TTF file into a new fonts directory in your project’s root. Place the Dart class file in your lib folder.

Step 3: Updating pubspec.yaml

Add your font to the pubspec.yaml:

fonts:
- family: CustomIcons
fonts:
- asset: fonts/CustomIcons.ttf

Step 4: Using Custom Icons

You can now use your custom icons in your Flutter app like this:

Icon(CustomIcons.your_icon)

Troubleshooting Custom Icons

If your icons aren’t displaying correctly (e.g., showing as squares with X’s), check the following:

  • Ensure pubspec.yaml is correctly formatted with no extra spaces or indentation errors.
  • Verify the font reference in pubspec.yaml.
  • Confirm the TTF file is in the correct directory.
  • Try uninstalling and reinstalling your app on the device or terminate the debug and rerun it.

Conclusion

Adding custom icons to your Flutter app is a straightforward process that can significantly enhance your app’s appearance and user experience. By following these steps, you can easily customize your app’s launcher icon and integrate unique icons within your app, giving it a more polished and distinctive look.

Remember, the key to success is in the details. Properly formatting your pubspec.yaml, correctly placing your files, and ensuring the right configurations will lead to a smooth and successful integration of custom icons in your Flutter application. Happy coding!

yawarosman.com

--

--

Yawar Osman
Yawar Osman

Written by Yawar Osman

Project Manager || Software Developer || Team Leader || Flutter Developer

No responses yet