Changelog
v2.3.0 (Jun. 19, 2025)
Section titled “v2.3.0 (Jun. 19, 2025)”Fixed compatibility issues with Starlight v0.34.0.
Breaking Changes
Section titled “Breaking Changes”- Ion now requires Starlight v0.34.0 or higher.
v2.2.3 (Mar. 13, 2025)
Section titled “v2.2.3 (Mar. 13, 2025)”- Resolve peer dependency mismatch (
unmet peer @astrojs/starlight@^0.31.1: found 0.32.x
)
v2.2.2 (Feb. 22, 2025)
Section titled “v2.2.2 (Feb. 22, 2025)”- Removed old configuration options.
v2.2.1 (Feb. 22, 2025)
Section titled “v2.2.1 (Feb. 22, 2025)”New Features
Section titled “New Features”- Re-added light mode support for the Ion theme.
v2.2.0 (Feb. 22, 2025)
Section titled “v2.2.0 (Feb. 22, 2025)”Fixed compatibility issues with Starlight v0.32.0.
Breaking Changes
Section titled “Breaking Changes”- Ion now requires Starlight v0.32.0 or higher.
v2.1.2 (Jan. 25, 2025)
Section titled “v2.1.2 (Jan. 25, 2025)”Bug Fixes
Section titled “Bug Fixes”- The plugin configuration is now optional, allowing you to use Ion without any configuration.
v2.1.1 (Jan. 15, 2025)
Section titled “v2.1.1 (Jan. 15, 2025)”Non-Breaking Changes
Section titled “Non-Breaking Changes”Starting with this release, you no longer need to use the resolve
function exported by the plugin to resolve the path to your local icon directory:
import { ion, resolve } from "starlight-ion-theme";
export default defineConfig({ // ... integrations: [ starlight({ // ... plugins: [ ion({ icons: { iconDir: resolve("./src/icons", import.meta.url), iconDir: "./src/icons", }, }), ], }), ],});
It is recommended to stop using the function, as it has been marked as deprecated. For compatibility reasons, the function will still be exported from the package until the next minor release.
v2.1.0 (Jan. 12, 2025)
Section titled “v2.1.0 (Jan. 12, 2025)”New Features
Section titled “New Features”- Exposes full configuration options for
astro-icon
- Allows for icons from
@iconify-json/*
packages to be used with the square bracket syntax
Breaking Changes
Section titled “Breaking Changes”The iconDir
option has been removed in favor of the icons
object, which now exposes astro-icon
’s full configuration options.
To migrate, update your astro.config.mjs
file to the following:
import { ion, resolve } from "starlight-ion-theme";
export default defineConfig({ // ... integrations: [ starlight({ // ... plugins: [ ion({ iconDir: resolve("./src/icons", import.meta.url), icons: { iconDir: resolve("./src/icons", import.meta.url), }, }), ], }), ],});
v2.0.1 (Jan. 11, 2025)
Section titled “v2.0.1 (Jan. 11, 2025)”Bug Fixes
Section titled “Bug Fixes”- Add missing files to npm release.
v2.0.0 (Jan. 11, 2025)
Section titled “v2.0.0 (Jan. 11, 2025)”Breaking Changes
Section titled “Breaking Changes”- Refactored Ion into a Starlight plugin.