Skip to content
nuxt-penumbra
Esc
↑↓navigate↵open⌘Jpreview
On this page

Changelog

Every release of nuxt-penumbra, newest first.

The current version is 1.0.0. This page is copied from packages/nuxt-penumbra/CHANGELOG.md at build time, the same file that ships in the npm package.

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

[Unreleased]

[1.0.0]

Added

  • Color-mode mode: animates changes to @nuxtjs/color-mode’s preference and never stores a theme itself. Chosen automatically when @nuxtjs/color-mode is installed.
  • Standalone mode: a small built-in theme store for apps without @nuxtjs/color-mode. It keeps the visitor’s choice in localStorage, follows prefers-color-scheme and other tabs, and sets a data-* attribute or a class on <html>. An inline head script applies the theme before first paint.
  • usePenumbra(): theme, preference, themes, setTheme and toggleTheme, with per-call transition, duration, easing, direction and origin options.
  • <PenumbraToggle>: a real button whose accessible name states the current and next theme, with a scoped slot, forced-colors styles and per-instance themes, transition, duration, easing and direction.
  • definePenumbraTransition() to register a custom effect.
  • 30 View Transitions effects from @penumbra/core, an instant fallback where document.startViewTransition is missing.
  • Nuxt UI support without wrappers: Nuxt UI’s color mode is animated as it is.
  • A navigation guard, so a theme change made while a page transition runs does not collide with it.
  • Reduced-motion handling: with prefers-reduced-motion: reduce the theme changes without an effect.
  • Module options: mode, themes, transition, duration, easing, and in standalone mode default, attribute and storageKey, validated at build time.

Was this page helpful?