---
title: Changelog
description: Every release of nuxt-penumbra, newest first.
sidebar:
  order: 5
---

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](https://keepachangelog.com/en/1.1.0/), and the project follows [Semantic Versioning](https://semver.org/).

## [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.
