Releases

2.0.0 ✓ Stable, can be used in production

  • First stable release of the fully redesigned Kesko UI icon library

  • Everything from the 2.0.0-rc series is now final, with no changes since rc.5

  • Every icon in this major release has been hand-drawn on a 24×24 grid with consistent 1.5px strokes, stroke corners, stroke ends, and stylistic gaps, plus improved optical sizing throughout

  • Adds iconography guidelines explaining how the icons are designed and why, plus an icon naming section in the naming guidelines

  • Breaking changes: icons have been renamed, removed, and recategorised across the 2.0.0-rc series. The migration guide covers every rename and removal, the new category taxonomy, and the -sm size-variant convention

  • Release date 20.8.2026

2.0.0-rc.5 Pre-release, can be tested in development

  • Fixes the t-shirt sizing in icons to use a more consistent format, defined in the naming guidelines

  • Release date 18.8.2026

2.0.0-rc.4 Pre-release, can be tested in development

  • Fixes the React TypeScript declarations to return ReactElement imported from react, instead of the global JSX.Element namespace. The declarations now type-check cleanly against @types/react 17, 18 and 19

  • Fixes @kesko/iconography/react/{IconName}.js failing to resolve, because the ./react/* export pattern appended a second .js to the path. Both spellings now work, alongside the @kesko/iconography/dist/react/{IconName}.js form used throughout the docs

  • Adds a ./package.json entry to the exports field, so build tooling that reads the package manifest through the package name resolves it instead of erroring

  • Release date 17.8.2026

2.0.0-rc.3 Pre-release, can be tested in development

  • Rebuilds the icon categories to match the section structure of the Figma icon library. The 15 categories become 24, and every icon's category value changes as a result

  • Adds the migration guide promised in rc.2, covering every renamed and removed icon and the new category taxonomy

  • Adds also two new icons, roof and contentful

  • Improves the icons page: the category filter and the category listing are both generated from the package registry, and the details panel now shows a category's display name rather than its slug

  • Breaking changes: renames user-normaluser. Removes four icons that were duplicates of another icon in the set: attention-extra (use notice), household (use home-accessories), profile (use user), and web-store (use cart). Each replacement is visually identical to the icon it replaces, so changing the name is the whole migration

  • Breaking changes: every icon's category value changes. This only affects code that reads icon metadata, category is not part of the React API, and is not exported from the individual dist/assets/{name}.js modules. Note that hardware, shopping, sustainability, location, and people all survive as category names but no longer mean the same thing, so a filter built on those keeps working while quietly returning a different set of icons

  • Release date 11.8.2026

2.0.0-rc.2 Pre-release, can be tested in development

1.3.1 ✓ Stable, can be used in production

  • Removes the unused svgpath dev dependency

  • Removes the unused normalize-viewbox.cjs script that the build no longer uses

  • Readme slimmed down, full usage docs now live on the icons page

  • Release date 8.5.2026

1.3.0 ✓ Stable, can be used in production

1.2.0 ✓ Stable, can be used in production

  • Sets displayName on all icon React components for better React DevTools legibility, plus internal metadata used by @kesko/components. No consumer-facing changes

  • For up-to-date documentation and usage guidelines, see Icon library

  • Release date 21.4.2026

1.1.0 ✓ Stable, can be used in production

1.0.0 ✓ Stable, can be used in production

  • First stable production release of icons, v1.0.0, is out! 🎉

  • Ships 363 icons that can be used on the web, mobile, and native platforms

  • Each icon is a responsive SVG shipped as an SVG file, as an individual ES module, as part of a single index module, and as a React component with size, color and label props

  • All included icons also carry metadata (title, category, tags) to support search and filtering in tooling and documentation

  • Thoroughly tested in React 17, 18, 19, Next.js 16, and plain JavaScript, including combinations of various Node.js versions + Webpack, Vite, and Turbopack

  • Additionally this release improves the optical sizing of curtain sewing, adjust, bathroom, cafeteria, and fabrics curtains carpets icons

  • For up-to-date documentation and usage guidelines, see Icon library

  • Utilize the markdown version when migrating to the new library using AI: icons.md

  • Release date 1.4.2026

1.0.0-rc.8 Pre-release, can be tested in development

  • Fixes exports field in package.json for dist/ import paths to resolve correctly in strict bundlers like Vite or Turbopack. Previously, dist/ paths were documented but blocked by the exports field

  • Adds "type": "module" in package.json since the output is ESM, but the package didn’t declare itself as such. Now works correctly on Node 12+

  • Adds tests for all documented import patterns across React 17, 18, 19, and Next.js 16

  • Additionally, this release adds a new outlet icon

  • For up-to-date documentation and usage guidelines, see Icon library

1.0.0-rc.7 Pre-release, can be tested in development

  • Adds 17 additional icons: cables, car-truck, carbon-footprint, chemicals, electricity-grid, handshake, refrigeration, sleep, solar-energy, stop, sun, telecom, volume-down, volume-full, volume-mute, volume-up, water-sewage

  • Add ./*.svg export pattern to package.json so raw SVG files can be imported directly (e.g. @kesko/iconography/warning.svg)

  • Add raw SVG import example to the icons documentation fallback paths section

  • Adds documentation about sizing raw SVG imports

  • For full documentation, view icon library

1.0.0-rc.6 Pre-release, can be tested in development

  • Wrap all generated React icon components in React.memo for memoization and better DevTools names

  • Switch from react/jsx-runtime to createElement to avoid subpath import resolution issues in some Node.js configurations

  • Fix peerDependencies to correctly declare React 17+ (was 18+, but output now supports 17+)

  • Add JavaScript framework compatibility tests (React 17, 18, 19 + Next.js)

1.0.0-rc.5 Pre-release, can be tested in development

  • Switches from .jsx to .js output: React icon components now use react/jsx-runtime calls directly instead of JSX syntax, improving Node.js compatibility without requiring a transform

  • Flattens dist/react/ structure: Components moved from dist/react/assets/ to dist/react/ directly, removing the intermediate named re-export files that were just pass-throughs

  • Extends IconProps from SVGProps<SVGSVGElement>: All standard SVG/HTML attributes are now forwarded via rest props (...props) instead of only supporting size, label, color, and className

  • Color is no longer applied by default: color prop only sets style when explicitly provided, avoiding unintended style overrides

  • Additionally, this release includes:

    • Improves the visual style of the exit icon

    • Improves the visual style of the method-pickup-3 icon

    • Improves the sizing and optical alignment of the minus icon

    • Improves the sizing and optical alignment of the plus icon

    • Hardens SVGLint enforcement in the build pipeline

    • Adds 52 new tests to cover React specific use cases

  • For updated documentation, view icon library

1.0.0-rc.2 Pre-release, can be tested in development

  • Rename icons for clarity: show-hidehide, show-hide-2show, method-pickup-1method-pickup-2, method-pickup-2method-pickup-3

  • New icon added: method-pickup-4

  • React className prop: All React icon components now forward a className prop to the SVG element, with updated TypeScript types and documentation

  • For full documentation, view icon library

1.0.0-rc.1 Pre-release, can be tested in development

  • First release candidate of @kesko/iconography. The API is considered stable, breaking changes are not expected before 1.0.0 unless critical bugs are found

  • @kesko/iconography ships 346 SVG icons organized across 16 categories, each with a title, category, and searchable tags. Icons follow a strict 24 px grid with <path> only structure and are validated by SVGLint and JSON schema validator

  • Every icon is available as a tree-shakeable ES module and as a React component with TypeScript declarations

  • React components support size, label, and color props

  • Ships with Vitest test suites covering icon structure, React component output, and visual regression tests

  • For full documentation, view icon library