Changelog
Latest Release
v2.5.3
August 3, 2026
View on GitHubChanged
Internal Refactor — Extracted resolveIconName and validateIconNamePattern out of CLI/Sync scripts into a shared naming.js module. No changes to public API or behavior.
Previous Releases
v2.5.2
August 3, 2026Fixed
Circular Dependency — Fixed an innocuous Node.js warning about an unsettled top-level await by embedding the sync naming logic directly into the sync script instead of dynamically importing it from the CLI runner.
v2.5.1
August 3, 2026Fixed
Sync Case Formatting — Fixed a bug where `iconcodegen sync` could generate camelCase component names instead of strict PascalCase components when the user configured a lowercase prefix in `iconNamePattern`. Lowercase component names caused React to treat them as native HTML tags, breaking Intellisense.
v2.5.0
August 3, 2026Added
iconcodegen sync Command — A powerful new CLI command to automatically mass-rename all generated icons to conform to your iconNamePattern. It uses AST-informed surgical barrel updates and features a strict zero-breakage pre-flight check.
v2.4.2
August 3, 2026Added
Metadata Injection — The generator now unconditionally injects an `@iconcodegen-source` tracking comment into all generated icons. This preserves the original provider and icon identity for future automation workflows.
Fixed
CSRF Middleware — Patched the local API server's strict requireLocalOrigin middleware to explicitly allow localhost and [::1] origins alongside 127.0.0.1, fixing 403 Forbidden errors for users on different local loopbacks.
v2.4.1
August 3, 2026Added
Config Hot-Reloading — Added an active file watcher that instantly hot-reloads iconcodegen.json when you save it in your editor. The terminal will automatically log the update without requiring a CLI restart.
Fixed
Batch Generation Stale Config — Fixed an inconsistency where batch generating icons would still use the stale startup config instead of the hot-reloaded pattern.
v2.4.0
August 3, 2026Added
Audit Command (AST Dead-Code Detection) — Introduced `npx iconcodegen audit` to scan your codebase for orphaned icons. Uses safe `@babel/parser` AST analysis instead of regex, and implements hard bail-outs if wildcard or dynamic imports are detected. Strictly read-only.
v2.3.0
July 31, 2026Added
Prune Command — Introduced `npx iconcodegen prune` to automatically clean up dangling exports in your index.ts barrel file when you manually delete or rename generated icon components. Supports a `--dry-run` flag to safely preview destructive changes.
v2.2.0
July 31, 2026Added
Custom Naming Templates — Added the iconNamePattern field to iconcodegen.json. You can now enforce strict team naming conventions (e.g. {name}Icon, App{name}) across both single and batch exports. All generated names are automatically validated and sanitized into compliant JavaScript identifiers.
v2.1.2
July 31, 2026Fixed
Architecture — Decoupled the CLI server execution block to strictly lock out tests, allowing proper unit testing of Express middleware.
Fixed
Symlink Resolution — Fixed a critical execution bug where running the tool via npm global symlink (iconcodegen) would silently fail because Node.js ES Modules enforce strict import.meta.url realpath comparisons.
v2.1.1
July 31, 2026Fixed
Security — Hardened the local API server's CSRF protection by shifting from a fail-open to a fail-closed architecture. The /api/download and /api/batch-generate endpoints now explicitly reject requests that omit Origin or Referer headers.
v2.1.0
July 31, 2026Added
Batch Export Drawer — Introduced a beautifully animated, slide-out drawer for batch exporting icons. Features a new flexbox grid layout, smooth glassmorphism hover effects, and persistent export settings.
Added
Production React Generators — Generated React components now automatically include global overrides (/* eslint-disable */, // @ts-nocheck) and DO NOT EDIT warnings to seamlessly bypass strict enterprise linting rules.
Added
Barrel File Automation — The CLI now automatically generates and updates index.ts / index.js barrel files across both Single and Batch export workflows.
Fixed
UI & UX Polish — Fixed multiple layout edge cases including double-scrollbars on small screens, CSS transition flickering between modals, and toast notifications blocking clicks.
v2.0.0
July 21, 2026Added
Package Rename — icon-vista has been officially renamed to iconcodegen for better SEO and discoverability. This marks the first release under the new npm namespace.
v1.2.1
July 21, 2026Added
CI Status — Added GitHub Actions CI badge to the README.
Added
Security — Added origin verification middleware to prevent CSRF on write endpoints (/api/download and /api/generate-snippet).
Changed
API Errors — Standardized API error responses to return proper JSON objects and appropriate HTTP status codes (400, 404, 500) across all endpoints.
Fixed
Security — Fixed a security vulnerability by binding the local Express server explicitly to 127.0.0.1 instead of all network interfaces (0.0.0.0).
Fixed
Error Handling — Fixed missing icon_id validation in the /api/svg endpoint, preventing bare string 500 errors.
v1.2.0
June 26, 2026Added
AST-based SVG Parsing — Replaced the fragile regex generator with @svgr/core, ensuring 100% syntactically correct React JSX output directly from SVG abstract syntax trees.
Added
CLI Arguments — Introduced --headless mode for CI/CD and --port <number> flag for custom port binding to avoid EADDRINUSE collisions.
Added
Persisted Preferences — The dashboard now remembers your preferred Language (TypeScript/JavaScript) and Component Style (Arrow/Function) across sessions.
Changed
Modularized Architecture — Split the monolithic 2,300-line index.html into a clean app.js and styles.css structure for improved maintainability.
v1.1.5
June 26, 2026Fixed
NPM Markdown Compatibility — Replaced the <video> tag in the README with a clean text link pointing to the Next.js site, as the NPM registry strictly strips out HTML video elements, leaving a broken layout. Removed leftover placeholder text.
Fixed
Cropped Video — Updated the demo video to a tightly cropped, high-resolution version.
v1.1.4
June 26, 2026Added
Interactive Demo — Added a looping video demonstration of the CLI to the README and website.
Added
Documentation Links — Added direct links to the new Next.js documentation website within the CLI terminal output and the local UI.
v1.1.3
June 26, 2026Added
Unit Testing Suite — Implemented a comprehensive Vitest testing suite covering the React component generator to ensure strictly typed, 100% valid React output.
Added
Automated CI/CD Tests — The GitHub Actions release pipeline now strictly enforces npm test before any tag or npm publish occurs.
Added
Website Link — Added a direct link to the full documentation website in the README.md.
Fixed
Regex Edge Case — Fixed a critical generator bug where width and height attributes were being globally stripped from all inner SVG tags (e.g. <rect width="24">), which was distorting certain icons. The generator now strictly targets only the outer <svg> wrapper.
v1.1.2
June 26, 2026Added
Infinite Scrolling — Implemented a highly optimised IntersectionObserver to seamlessly lazy-load icons as you scroll, completely replacing the static 100-icon limit. The backend API now supports start and limit pagination.
Added
Sidebar Filtering Engine — Built a dynamic sidebar filter panel. The app fetches available packs and styles from /api/filters on load, letting you narrow down searches across 200,000+ icons instantly.
Added
Premium Skeleton Loaders — Introduced shimmering skeleton states for both the icon grid and the sidebar filters, hardcoded directly into the initial DOM to prevent layout shifts during API fetches.
Added
Retina-Ready Favicon — Extracted the star logo into a standalone SVG favicon with matching violet-to-cyan gradients — scales perfectly on all displays.
Changed
UI Architecture Refactoring — Replaced the landing-page hero section with a native app-like layout. The search bar is now prominently centred in the header, bringing the icon grid and filters into immediate view on load.
Changed
Typography & Aesthetics — Migrated to the Outfit Google Font using a strict fonts-loaded pattern to completely eliminate Flash of Invisible Text (FOIT) without adding local .woff2 files to the package.
Changed
Layout Shift Fixes — Added a global custom scrollbar with overflow-y: scroll to lock layout width. Implemented scrollRestoration = manual and instant top-scrolling on filter changes to prevent browser scroll snaps.
v1.1.0
June 25, 2026Added
Modern Color Picker — Integrated the Pickr library for a smoother, cross-browser consistent color selection experience.
Added
Recent Colors — Saved and displayed the 5 most recently used colors — persisted across sessions using localStorage.
Added
Hex Input Enhancements — The hex input now auto-formats and expands 3-digit hex codes (e.g. #abc expands to #aabbcc).
Changed
Inherit Mode — Replaced the previous currentColor button with a new Inherit switch for improved UI clarity.
Changed
Startup Behaviour — The application now loads a random icon theme on initialisation instead of a static search.
Changed
Dynamic Swatches — Refactored the color swatches section to dynamically render recent colors alongside standard presets.
Changed
Slider UI — Improved the size slider with dynamic fill tracking as the value changes.
v1.0.1
June 24, 2026Fixed
Duplicate color attribute (TS17001) — Fixed a strict TypeScript compilation error where generated SVG components rendered duplicate color attributes when parsing premium SVGs that natively hardcoded color=currentColor.
Fixed
Modal DOM null exception — Resolved a critical JavaScript DOM selector exception (Cannot set properties of null) that was completely preventing the customization modal from opening.
Fixed
Windows bin resolution — Corrected the package.json executable path to prevent bin resolution issues on Windows operating systems.
v1.0.0
June 24, 2026Added
Initial Release — First public release of iconcodegen.
Added
Visual Search Engine — Launched the beautiful localhost UI to search over 200,000+ open-source icons from Iconify.
Added
Provider Architecture — Implemented a highly scalable, decoupled backend engine supporting multiple icon providers.
Added
Untitled UI Pro Integration — Engineered the Reverse-Rendering backend to securely parse, compile, and serve premium private icon repositories locally without exposing authentication tokens.
Added
Code Generator — Added one-click SVG React component code generation supporting both JavaScript and strict TypeScript outputs.