Pixel Art Icons package for Flutter
This package provides a set of pixel art icons as font for Flutter, it can be used in the same way we use Icons class.
- See all available icons at https://pixelarticons.com/free/.
- Get the Figma file at https://www.figma.com/community/file/952542622393317653.
Icon set created by @halfmage, if you like this free icon set you will also like the premium ones.
Show preview

Install the package
You can check the latest version on pub.dev/pixelarticons.
dependencies:
# ...
pixelarticons: <latest-version>
# ...
or run:
flutter pub add pixelarticons
Import the package
Import wherever you want:
import 'package:pixelarticons/pixelarticons.dart';
Use as IconData
pixelarticons package uses the IconData class, so the usage is pretty much the same of the Icons class but renamed to Pixel.
Be aware:
- Lower-case for all icons and no separators, for example
arrow-downis written asPixel.arrowdown. - Names starting with numbers and Dart keywords get a
kprefix.
Icon full list https://pixelarticons.com/free/.
Icon(Pixel.android);
Icon(Pixel.clock);
Icon(Pixel.arrowdown);
Develop locally
Use Dart 3.8+ and Flutter 3.32+ for the package. Development of the example and locked release tool uses Flutter 3.47+ / Dart 3.13+. Android also requires JDK 17.
The font and generated Pixel class are committed, so a fresh checkout works
without downloading upstream icons or running the generator:
flutter pub get
flutter analyze
flutter test
cd example
flutter run -d chrome
The example also supports Android (flutter run with an Android device).
Sync and generate icons
Automation lives in tool/, a standalone Dart package. Run its commands from
that directory so Dart resolves the tool's own dependencies:
cd tool
dart pub get
dart run bin/pixelarticons_tool.dart --project-root .. --dry-run
dart run bin/pixelarticons_tool.dart --project-root ..
A sync fetches the current upstream commit, downloads that exact revision,
extracts the free SVGs, and generates both fonts/pixelarticons.otf and
lib/pixel.dart. It uses the Dart 3 compatible icon_font_generator instead of
the retired fontify. All icons retain their 24×24 grid and lowercase Dart
names, including keyword and numeric prefixes.
This breaking release uses only the current upstream icon set. Removed v1
icons and historical spelling aliases are no longer available. Update your
Pixel references to names in the current icon set.
Glyph codepoints may change on regeneration; always use Pixel constants
with the matching bundled font rather than storing numeric codepoints.
--no-cache rebuilds even when the upstream commit matches, without bumping the
version or adding a duplicate changelog entry. --force-release explicitly
bumps the version for a release without upstream changes. --dry-run does not
modify the project.
# From tool/
dart run bin/pixelarticons_tool.dart --project-root .. --no-cache
dart analyze
dart test
cd ..
dart format lib test tool/lib tool/bin tool/test example/lib
flutter analyze
flutter test
cd example
flutter build web
CI and publishing
To release manually, open GitHub → Actions → Update icons and publish release → Run workflow. Select the release branch and click Run workflow. By default, this checks upstream, downloads the current icons, regenerates the font and class, bumps the version, updates the changelog, runs validation, and pushes the commit and version tag together. The tag then starts Publish package to pub.dev automatically. Follow that second workflow to confirm publication.
Manual runs always create a new version, even when upstream icons are unchanged. Scheduled runs on the 1st and 15th only release when upstream changes are found.
One-time setup: add the repository secret TAG_PAT with permission to write
repository contents, and enable automated publishing on pub.dev for
libsrcdev/pixelarticons with tag pattern v{{version}}. The release token must
be authorized by any repository rules that restrict branch or tag pushes.
validate.ymlanalyzes and tests the tool and package, checks formatting, and builds the web example on pushes and pull requests.sync-upstream-icons.ymlchecks upstream on the 1st and 15th of each month or on manual dispatch, generates and validates artifacts, then commits and tags a release. Set the repository'sTAG_PATsecret to a token authorized to push commits and tags; this allows the tag push to trigger the release workflow.publish-pubdev.ymlvalidates and publishes tagged releases using pub.dev OIDC automated publishing. Configure the trusted GitHub repository and tag pattern in the pub.dev package's automated publishing settings.
Remote issues addressed
- #5: solid clock: the current path-based clock is bundled, with a raster test verifying its hollow interior and visible outline.
- #6: new icons: the generated package includes 1,036 current free upstream icons. Paid upstream icons are not distributed here.
Contribute
Use the issues tab to discuss new features and bug reports.
Libraries
- pixel
- pixelarticons
- Pixel art icons for Flutter.