solar_iconkit 2.0.0

Solar icon kit for Flutter. 1,453 icons in 6 native styles — linear, outline, broken, bold, line-duotone, bold-duotone — behind a single SolarIcon widget.

Changelog

All notable changes to this package are documented here. The format loosely follows Keep a Changelog, and the package uses Semantic Versioning.

2.0.0 — 2026-09-29

Three API gaps closed, plus the largest upstream catalog change so far: 1,269 → 1,453 icons. The only breaking API change is one field's nullability; eight icons also change appearance because Solar redrew them.

Catalog

• 195 new icons across two upstream batches. The first is table and text-editing themed: table, table-cells-merge, table-cells-split, table-columns-split, table-rows-split, table-minimalistic, table-properties, sheet, quote, quote-circle, quote-square, parentheses, sidebar-open, sidebar-close, square-dashed, star-off, and 102 more.

  The second adds directional arrows (arrow-down-to-line, arrow-up-from-line and six siblings), a bookmark family (bookmark-check, -minus, -off, -plus, -x), chart-square-2, and 63 more.

• 7 renames, a consistent regrouping upstream. Each old name stays as a @Deprecated constant resolving to the new one, so existing code compiles and renders identically:

  Old	New
  chat-dots	chat-square-dots
  chat-line	chat-square-line
  chat-unread	chat-square-unread
  cloud-file	file-cloud
  code-file	file-code
  figma-file	file-figma
  zip-file	file-zip

  A second batch renamed the sidebar family to panels:

  Old	New
  sidebar	panel-text-right
  sidebar-close	panel-right-close
  sidebar-minimalistic	panel-right
  sidebar-open	panel-right-open

  Note sidebar-close and sidebar-open arrived in the first batch and were renamed in the second, a week later. legacyAliases now holds 68 entries.

• 8 icons changed appearance under the same name. The first batch redrew notebook-square, share, cash-out, bag-music-2 and tennis-2; the second redrew panel-top, panel-top-close and panel-top-open as part of the same sidebar-to-panel reorganisation. Unlike the 1.1.0 redraws, none of the old drawings moved to a new name, so pin 1.2.0 if you need the previous artwork.

  Both batches were checked by rendering every shipped icon against upstream and diffing pixels, with the comparator validated against known-identical and known-different pairs first. Outside those eight, the worst difference was under 5 % — anti-aliasing.

• Asset bundle is ~6.5 MB after the SVGO pass, up from ~5.8 MB for the 1,104 additional SVGs (8,718 total).

• Most SVGs differ byte-for-byte because the minifier moved from SVGO 4.0.2 to 4.1.0, which merges single-fill paths that 4.0.2 left separate. Verified this does not touch the duotone styles, where merging would destroy the 50 %-opacity accent: every one of 500 sampled duotone assets still carries its opacity, and bold_duotone/add.svg keeps both paths while only the single-fill bold/add.svg merges.

  Both duotone styles were also rendered against upstream and diffed. The largest differences — three thin-stroke arrows at about 13 % — were inspected side by side and are identical drawings; a thin stroke has few ink pixels, so a sub-pixel edge shift from coordinate rounding is a large percentage of a small number.

Breaking

• SolarIcon.style is now SolarIconStyle? instead of SolarIconStyle. It had to become nullable so the widget can tell "no style given" from "explicitly linear" — which is what lets [SolarIconTheme] supply one. Constructing icons is unaffected: SolarIcon(name) and SolarIcon(name, style: ...) both compile unchanged, and an icon with no style still renders linear.

  Only code that reads the field breaks:

  // before
  SolarIconStyle s = icon.style;
  // after
  SolarIconStyle s = icon.style ?? SolarIconStyle.linear;
  

Added

• SolarIconTheme — sets the default style for a subtree, the way [IconTheme] does for size and colour:

  SolarIconTheme(
    style: SolarIconStyle.boldDuotone,
    child: MyApp(),
  )
  

  Size, colour and opacity already inherited; style was the one property that could not be set once for a subtree, so an app with a house style had to repeat style: at every call site. The README used to document writing a wrapper widget purely to work around this. Nesting behaves like [IconTheme] — nearest ancestor wins — and an explicit style: always wins.

• SolarIcons.categories — Solar's own grouping, 37 categories over 1,451 icons, plus SolarIcons.categoryOf(name). The generator already read these to collect names and then discarded the grouping, leaving anyone building the icon picker the README promotes with a flat list of 1,453 names and no way to section it. categoryOf resolves retired names through legacyAliases first, so it works for both spellings.

• SolarIcon.assetBasePath / SolarIcon.assetPackage — where the SVGs load from, plus SolarIcon.useBundledAssets() to restore the defaults. Defaults are unchanged, so this is invisible unless you opt in.

• dart run solar_iconkit:subset — generates a trimmed asset set containing only the icons and styles an app uses, and prints the pubspec entry and the two lines of setup.

  The package bundles 8,718 SVGs (~6.5 MB) and Flutter's tree-shaker cannot drop any of them, because paths are resolved at runtime. The only previous remedy was to fork the package and delete folders by hand — giving up versioned dependency management to control size. Now:

  dart run solar_iconkit:subset --styles linear,bold
  

  It refuses to run when it finds SolarIcons.all, SolarIcons.categories or legacyAliases in the scanned sources, because an app that builds icon names at runtime needs the whole set and a scan cannot tell which icons that is — shipping a subset there would leave blank squares in a release. Use --all in that case, which still drops unused styles.

Notes

• tool/fetch_icons.py gains --skip-assets, which regenerates the Dart catalog without re-downloading unchanged SVGs.
• tool/fetch_icons.py now ignores names it did not request. The API answers an alias with its parent, keyed under the parent's name, so a response could contain icons outside the catalog — this sync wrote a stray chart-square-2 into four of the six style folders, with no constant pointing at it.
• tool/check_upstream.py no longer crashes on Windows. It printed the rename arrows to a cp1252 console; CI is Linux, so the weekly job was unaffected and the failure only appeared when running it by hand.

1.2.0 — 2026-08-26

Catalog resync with upstream Solar: 1,247 → 1,269 icons (7,614 SVG variants). Effectively additive: no constant was removed, and the only glyph that changes appearance is bold/logout, which 1.1.0 shipped malformed and Solar has since fixed. Upgrading is a drop-in.

Added

• 22 new icons.
  • Wi-Fi family: wi-fi, wi-fi-high, wi-fi-low, wi-fi-none, wi-fi-off, wi-fi-cog, wi-fi-cross
  • Bare UI primitives: add, close, minus, question-mark, exclamation-mark
  • Camera and video: webcam, webcam-off, videocamera-off
  • Scanning: barcode, barcode-scan, binoculars
  • Other: bot, brain, paint-brush, toolbox

Changed

• ticker-star was renamed to ticket-star upstream (a typo fix). The old name remains as a @Deprecated constant resolving to the new one, so existing code compiles and renders identically. legacyAliases now holds 57 entries.
• logout in the bold style is fixed. 1.1.0 shipped it malformed — the door rendered as a clipped crescent instead of a closed shape. Solar corrected it upstream and the fix is picked up here. This is the only glyph in the package whose appearance changes, and it changes from wrong to right, so there is nothing to migrate.
• Nothing else changed appearance. All 1,247 icons from 1.1.0 were rendered at both versions and pixel-diffed in the linear style, and every asset whose bytes differ after regeneration was diffed in its own style — 26 files across all six. Because SVGO output is deterministic, a changed glyph necessarily changes bytes, so that byte-level set is a superset of the visual changes and coverage is complete across styles. Apart from bold/logout at 39.7 %, the worst difference was 0.29 % — anti-aliasing.
• Asset bundle is ~5.8 MB after the SVGO pass, up from ~5.7 MB for the 132 additional SVGs.

Fixed

• The generator would have deleted every deprecated constant from the previous release. previously_shipped() read only the all list, but retired names live in legacyAliases precisely because all excludes them. A regeneration therefore saw 1.1.0's 56 renamed constants as nonexistent and dropped them — SolarIcons.magnifer and 55 others would have vanished, breaking 1.1.0 consumers on upgrade. The script now reads both, carries every previously retired name forward, re-resolves any whose replacement has itself since been renamed, and treats the union of current and retired names as the set it may never drop.

1.1.0 — 2026-08-14

Resync with upstream Solar. The catalog grows from 1,231 to 1,247 icons (7,482 SVG variants). No constant was removed, and no consumer code needs to change to keep compiling — but eleven icons now render a different drawing, so read the visual-changes section before upgrading.

Added

• 11 brand-new icons: cart-4, document-2, forward-right, list-vertical, logout, logout-2, mirror-2, notebook-2, record-audio-circle, star-2, vanity.
• SolarIcons.legacyAliases — a 56-entry map from every retired icon name to its current replacement.
• SolarIcon.resolveName — resolves a possibly-retired name to the name actually shipped as an asset. SolarIcon.assetPath now applies it, so raw strings such as SolarIcon('magnifer') keep working after the rename.

Changed

• 11 icons changed appearance under the same name. Solar redrew them upstream. Six had their original drawing moved to a new name:

  Constant	1.0.x drawing now lives at
  home	house
  reorder	reorder2
  stars	stars2
  cup	mug
  bill	bill2
  scale	scaling

  Five more were redrawn with no replacement name: phone, smartphone-2, volume-knob, keyboard, cloud-snowfall-minimalistic. Pin 1.0.3 to keep the old artwork for those. The other 1,236 icons are visually unchanged — verified by rendering every icon at both versions and diffing the pixels.

• 56 misspelled names corrected upstream, including magnifer → magnifier, spedometer-* → speedometer-*, condicioner → conditioner, siderbar → sidebar, recive-* → receive-*, *-favourite → *-favorite, plain → plane, 4k → four-k, and winrar → win-rar.

• Asset bundle shrank to ~5.7 MB (from ~6.1 MB) despite carrying 16 more icons, thanks to a fresh SVGO 4 pass. Rendering is unaffected: a sampled pre/post raster comparison showed a maximum difference of 2.2 %, entirely anti-aliasing.

• Golden reference images regenerated. The home-2 goldens drifted by 23 pixels out of 480,000 (max channel delta 5/255) after the SVGO pass.

Deprecated

• The 56 retired names remain available as @Deprecated constants whose value is the replacement name, so existing code keeps rendering the same glyph while the analyzer points at the new spelling. They are excluded from SolarIcons.all.

Notes

• tool/fetch_icons.py no longer regenerates the catalog purely from Iconify's browsable listing. That listing omits renamed and hidden entries, so a naive refresh would have silently deleted 56 shipped constants. The script now diffs against the committed catalog, maps each retired name to its replacement, and aborts rather than dropping any name a release has shipped.

1.0.3 — 2026-08-02

Fixed

• Corrected GitHub organization references. Several links across the package incorrectly pointed to sovankentech instead of the correct sovanken GitHub account/organization — including the CI badge, codecov badge, issue tracker links, the git dependency example, and the repository/issue_tracker fields in pubspec.yaml. All references now correctly resolve to github.com/sovanken/solar_iconkit.

Notes

• No API changes, no behavioural changes. Purely a metadata/documentation correction — safe to upgrade with zero migration effort.

1.0.2 — 2026-07-29

Added

• Debug-mode validation for icon names. SolarIcon('typo-name') now throws a detailed [FlutterError] in debug builds instead of silently rendering an empty box. The assertion is stripped from release builds (zero production cost). Typos surface immediately during development with a stack trace pointing to the offending call site and a hint to use the SolarIcons.<name> constants.

Changed

• SVG assets minified further via SVGO. All 7,386 SVGs were run through SVGO with a conservative config (preserves currentColor, viewBox, duotone opacities, and gradient ids). Savings were modest (~0.7%) — Solar's upstream SVGs were already well-optimised — but it's a free win with no visible change to rendering. Golden tests still match.
• README bundle-size figures corrected. Earlier releases quoted "23 MB uncompressed" — that number came from du -sh reporting filesystem block-allocation slack (each ~500-byte SVG rounds up to a 4 KB block). The actual on-wire SVG content is 6.1 MB. The README now reports the accurate number and explains the discrepancy.

Tests

• New test verifying the unknown-icon assertion throws a FlutterError whose message includes the offending name. Total tests: 34 (up from 33) + 6 goldens.

1.0.1 — 2026-07-29

Quality release — no API changes, no behavioural changes. Consumers of 1.0.0 can upgrade with zero migration effort.

Added

• Codecov integration. Every CI run uploads lcov.info to Codecov; the coverage badge is live on the README. Coverage on lib/ is now 100% (generated .g.dart files excluded, per codecov.yml).
• Coverage gates. New codecov.yml sets a 90% project baseline and an 80% patch baseline. PRs that drop coverage below these thresholds are flagged automatically.
• debugFillProperties test. One new widget test constructs a SolarIcon with every parameter non-default and asserts each is reported in the Flutter DevTools diagnostics dump. Brings total test count to 33 + 6 goldens.

Changed

• CI workflow passes CODECOV_TOKEN explicitly to codecov-action@v5 for faster and more reliable coverage ingestion.

1.0.0 — 2026-07-29

🎉 First stable release.

solar_iconkit is now API-stable and production-endorsed. The 1.0 line commits to backwards compatibility — future 1.x releases will only add optional parameters or fix bugs. Breaking changes will bump to 2.0.

Highlights from the 0.x → 1.0 journey

• 1,231 Solar icons across 6 native styles (7,386 SVG variants) — behind a single, type-safe SolarIcon widget.
• 160/160 pub.dev score across all five evaluation categories.
• 32 tests + 6 golden files covering widget behaviour, IconTheme integration, RTL mirroring, opacity composition, blendMode, shadows, and visual regression on all six styles.
• Cross-platform CI on Ubuntu, macOS, and Windows, plus a dedicated Ubuntu job on the declared minimum Flutter 3.27.0.
• Zero deprecated API use — modern Color.withValues(alpha:) for opacity composition, Directionality.of for RTL, IconTheme.of for ambient theme integration.
• Strict analyzer — strict-casts, strict-inference, and strict-raw-types all enabled, plus 11 additional lint rules.
• Full community-standards compliance: CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, issue templates, PR template, Dependabot, FUNDING.
• Branch protection on main — all four CI matrix jobs must pass before merge.

Since 0.4.0

• Analyzer strictness bumped — 11 additional lint rules and full strict-type-checking. Codebase already compliant; no user-visible changes.
• Coverage tracked via Codecov — every push and PR uploads lcov.info from the min-Flutter CI job. Coverage badge in the README.
• Branch protection on main — the four CI matrix jobs are required status checks. Force-push and deletion blocked.
• Version references bumped throughout the docs to ^1.0.0.

Roadmap toward 2.0

• Per-style sub-packages (solar_iconkit_linear, solar_iconkit_bold_duotone, etc.) for consumers who only need a subset of styles. Would cut typical bundle size from 23 MB to ~4 MB.
• Icon-font distribution as an alternative to SVG for consumers who prioritise bundle size over duotone rendering.

0.4.0 — 2026-07-29

Added

• SolarIcon.blendMode parameter (defaults to BlendMode.srcIn). Lets advanced consumers customise how the icon's color composites onto the background — for example BlendMode.multiply for icon-over-texture effects, or BlendMode.dst to render the SVG in its native colors.

• SolarIcon.shadows parameter — a List<Shadow>?. Mirrors the shadows parameter on Flutter's built-in Icon widget. When non-empty, blurred and offset copies of the icon are painted behind the main render.

  SolarIcon(
    SolarIcons.heart,
    style: SolarIconStyle.bold,
    color: Colors.red,
    shadows: const [
      Shadow(color: Colors.black26, blurRadius: 6, offset: Offset(0, 2)),
    ],
  )
  

• Golden tests covering all six styles. test/golden_test.dart renders SolarIcons.home2 per style and compares against reference PNGs in test/goldens/. Catches visual regressions caused by flutter_svg upgrades or widget-layout changes.

• Cross-platform CI. The workflow now runs a matrix on Ubuntu, Windows, and macOS against the current Flutter stable channel, plus a dedicated Ubuntu job on the declared minimum Flutter 3.27.0. Golden tests are gated to Ubuntu only via the golden test tag (dart_test.yaml) — pixel-level rasterization can differ across platforms.

• Format enforcement in CI. dart format --set-exit-if-changed runs as part of the min-flutter job. Codebase is now fully dart-formatted.

Changed

• Test count 24 → 32. Two new widget tests (blendMode, shadows) plus six golden tests.
• debugFillProperties now reports blendMode and shadows so they show up in Flutter DevTools.

Notes

• No breaking changes. Both new parameters are optional and default to the pre-existing behaviour (srcIn blend, no shadows).

0.3.3 — 2026-07-29

Added

• pub.dev screenshots. Three screenshots are now shipped in the package and rendered on the pub.dev landing page:
  • browser-grid.png — the interactive icon browser with sidebar, style chips, and icon grid.
  • style-comparison.png — the detail dialog showing an icon in all six native styles, hero preview, "Preview in context", and Copy tab.
  • widget-in-app.png — the "Preview in context" strip demonstrating SolarIcon in menu, sidebar, button, and toolbar UI patterns.
• Capture script. screenshots/capture.mjs uses Playwright to regenerate all three PNGs from the live icon browser (https://solar-icons-web.vercel.app) — makes future re-captures a one-command operation.

0.3.2 — 2026-07-29

Added

• Community health files. Added CONTRIBUTING.md, CODE_OF_CONDUCT.md (Contributor Covenant 2.1), SECURITY.md (with GitHub private vulnerability reporting), issue templates (bug report + feature request), pull request template, and .github/FUNDING.yml. GitHub's community-standards score moves from 0/7 to 7/7.
• Dependabot. .github/dependabot.yml opens weekly PRs for pub dependencies and GitHub Actions versions.
• RTL and opacity tests. Three new widget tests covering matchTextDirection under Directionality.rtl, explicit textDirection override, and composition of widget-level opacity with IconTheme.opacity. Total test count is now 24 (up from 21).
• Screenshots scaffold. screenshots/README.md documents which visuals to capture for pub.dev; a commented screenshots: block in pubspec.yaml is ready to activate once the PNGs are in place.

Changed

• flutter_lints bumped ^5.0.0 → ^6.0.0. Picks up the latest Dart lint rules. No new warnings surfaced by the upgrade.
• Example app cleanup. Replaced 8 remaining Color.withOpacity(...) calls with Color.withValues(alpha: ...) (Flutter 3.27+ API). Applied const where the analyzer suggested. flutter analyze now reports zero issues across lib/, test/, and example/.

0.3.1 — 2026-07-29

Changed

• LICENSE cleanup. The bundled Solar attribution has been moved to a new top-level NOTICE file so LICENSE is now a clean, unaltered MIT template. licensee/pub.dev can now confidently detect the license — the pub.dev license status will resolve from "pending" to "MIT".

Added

• Continuous integration. A GitHub Actions workflow at .github/workflows/ci.yml runs flutter analyze and flutter test on every push and pull request, against Flutter 3.27.0 (the minimum declared in pubspec.yaml) and the current stable channel. Status badge added to the README.
• Bundle-size roadmap. The "Reducing bundle size" section in the README now explicitly documents the 23 MB / 4–5 MB gzipped footprint, the per-style trimming workflow (fork + edit pubspec.yaml), and flags per-icon tree-shaking via build_runner as the direction for v1.0.

0.3.0 — 2026-07-29

Added

• Icon browser website — https://solar-icons-web.vercel.app is now the primary place to preview icons, pick a style, and copy Flutter widget code for any icon in the set. Referenced throughout the README and set as the package homepage.
• Sponsorship link — Ko-fi funding URL declared in pubspec.yaml under the funding field (pub.dev renders a "Sponsor" button pointing to https://ko-fi.com/sovanken). README now includes a short "Support" section.

Changed

• README trimmed to five essential badges (pub version, pub points, Flutter, license, Ko-fi) — the badge cluster is easier to read and each badge now communicates something distinct.
• External links to the Solar collection page were replaced with links to the new browser website so readers land on an interactive preview instead of an outdated third-party listing.
• Package homepage now points at the icon browser (https://solar-icons-web.vercel.app) rather than pub.dev — pub.dev already links to itself.

Removed

• README sections that documented the internal regeneration script have been removed. The script is still shipped for maintainers under tool/, but it is not part of the public API and no longer surfaces in the readme, troubleshooting, or requirements sections.

0.2.0 — 2026-07-28

Added

• Dartdoc comment on every SolarIcons.<name> constant (1,231 total). Raises pub.dev "Provide documentation" from 10 % to ~98 % coverage.
• Dartdoc comments on every SolarIconStyle enum value, describing the visual character of each of the six styles.

Changed

• Breaking: minimum Flutter bumped from 3.24.0 to 3.27.0 (Dart 3.6+). This lets the widget use the modern non-deprecated color API.
• Opacity composition now uses Color.withValues(alpha: ...) (Flutter 3.27+) instead of the deprecated .alpha, .red, .green, .blue component getters. Fixes the pub.dev static-analysis warnings about deprecated members in lib/src/solar_icon.dart.
• Fetcher generator (tool/fetch_icons.py) now emits /// Solar icon \X`.` before each constant, so future regenerations preserve the documentation.

Fixed

• pub.dev score raised from 140/160 to an expected 160/160 (documentation and static analysis categories both at max).

0.1.0 — 2026-07-28

Initial public release.

Widget

• SolarIcon widget with a const constructor and 11 parameters: name, style, size, color, opacity, semanticLabel, textDirection, matchTextDirection, fit, alignment, and key.
• Full IconTheme.of(context) integration — size, color, and opacity resolve from the ambient theme when unset on the widget, matching the behaviour of Flutter's built-in Icon.
• Decorative icons (no semanticLabel) are wrapped in ExcludeSemantics so screen readers skip them cleanly.
• Strict layout box via SizedBox.square — icons never overflow their parent.
• debugFillProperties for Flutter DevTools inspection.
• Static helpers: SolarIcon.assetPath(name, style) and SolarIcon.packageName.
• Cross-version alpha computation via Color.fromARGB — no dependency on withOpacity (deprecated) or withValues (unavailable pre-3.27).

Styles

• SolarIconStyle enum with six native Solar styles: linear, outline, broken, bold, lineDuotone, boldDuotone.

Catalog

• SolarIcons class with 1,231 generated string constants — one per Solar base icon — and an alphabetically sorted all list.
• Identifier naming rules: kebab-case to camelCase, leading digits prefixed with i, Dart reserved words suffixed with Icon, collisions resolved with numeric suffixes.

Assets

• 7,386 SVG assets bundled across 6 style folders under assets/icons/.
• Assets declared in pubspec.yaml under the flutter.assets key; consumers do not need to declare anything.

Tooling

• Python 3 regeneration script at tools/fetch_icons.py that pulls the latest Solar icons from the Iconify API, writes SVGs into assets/icons/{style}/, and regenerates lib/src/solar_iconkit_data.g.dart.

Testing

• Widget and unit tests covering: default rendering, explicit props, IconTheme inheritance, ExcludeSemantics wrapping, opacity assertions, assetPath resolution, catalog invariants (sortedness, uniqueness, identifier grammar), and reserved-word renames.

Documentation

• Comprehensive README.md covering installation (pub.dev + path + git + overrides), API reference, style guide, recipes for common Flutter widgets, advanced patterns, performance guarantees, and troubleshooting.
• Dartdoc comments on every public class, member, and enum value.
• PUBLISHING.md maintainer guide with release workflow.
• example/ Flutter app browses every icon in every style with search and size controls.

Platform support

Android, iOS, macOS, Windows, Linux, Web — every platform supported by flutter_svg.