Changelog

Every released version of go-swarm-icons and what changed in it. Entries follow Keep a Changelog, and version numbers follow Semantic Versioning.

The canonical copy lives in CHANGELOG.md at the repository root. Downloadable archives and release notes are on the GitHub releases page.

Versioning

The repository ships four independently tagged Go modules: the core library (vX.Y.Z), the Lucide submodule (lucide/vX.Y.Z), the Goldmark submodule (goldmark/vX.Y.Z), and the CLI (cmd/swarm-icons/vX.Y.Z). Releases tag all four paths at the same version, so matching version numbers are built and tested together.

All modules are pre-1.0. Under SemVer that means minor versions may contain breaking API changes; every breaking change is called out in the changelog with a Breaking label naming the affected module. Patch versions are safe to take without reading the notes.

Unreleased

• Card grid on the docs landing page, including a link to the hugo-swarm-icons live demo.
• Live demo link added to the Hugo integration guide.

v0.2.0

Released 2026-08-01.

• Fixed: submodules were uninstallable (lucide, goldmark, CLI): their go.mod files required core v0.0.0 with a replace directive, which consumer builds ignore, so go get of a submodule and go install of the CLI both failed. Submodules now require a released core version.
• Breaking (core): SVG parsing and sanitization moved to an internal package. ParseSVG, ParseSVGFile, and SanitizeContent are no longer exported; sanitization still runs automatically inside FromFile, FromString, and every provider path. See SVG Sanitization.
• Breaking (core): the IconifyData type and FromIconifyData constructor are unexported. Icons from Iconify JSON entries are constructed internally by the JSON Collection and Iconify providers.
• Documentation website with a live Markdown icon showcase, brand assets, and a README feature showcase.
• New guides: Web Integration, license and attribution, and this changelog.
• Expanded Hugo integration guide covering every hugo-swarm-icons module parameter.

v0.1.0

Released 2026-06-25. Initial release.

• Core: the Icon type with a fluent, immutable transform API, IconManager with prefix-based resolution, aliases, and fallbacks, the Config builder, and the five-layer attribute merge with automatic ARIA injection. See Core Concepts.
• Core: four providers: directory, JSON collection, Iconify HTTP API, and a first-found chain. See Providers.
• Core: nine-stage SVG sanitization, a thread-safe icon cache, and SpriteCollector for sprite sheets. See Sprite Sheets.
• Lucide: embedded Lucide icon set (~1,500 icons) via go:embed. See Embedded Lucide.
• Goldmark: extension adding :icon[prefix:name] inline syntax to Markdown. See Goldmark Integration.
• CLI: the swarm-icons tool for browsing, downloading, and updating Iconify sets from npm without Node.js. See CLI Reference.