live_toast

# Changelog

All notable changes to this project will be documented in this file.

Note that the versions prior to `0.6.0` are very unstable.

## [v0.10.2] (2026-09-04)

### Fixed

- Phoenix flashes now update correctly across LiveView navigation when using a custom toast component.

## [v0.10.1] (2026-09-03)

### Fixed

- Custom Phoenix flash components now rerender when a flash is replaced by another flash of the same kind.

## [v0.10.0] (2026-08-28)

Note: this release includes breaking changes involving translation. The library no longer calls `gettext` functions on
dynamic strings passed to `put_toast` and `send_toast`.

### Changed

- [Translation behavior](https://github.com/srcrip/live_toast/pull/78): translation of LiveToast's built-in connection notices is now opt-in; configure `gettext_backend` to enable it. `send_toast/3`, `put_toast/4`, and custom connection-notification copy now render the supplied message and title unchanged, so translate application-owned copy before passing it to LiveToast.
- [TypeScript compatibility](https://github.com/srcrip/live_toast/pull/77): LiveToast no longer augments the global `HTMLElement` interface, and the package now ships and exposes its TypeScript declarations.
- [Custom Phoenix flash rendering](https://github.com/srcrip/live_toast/pull/80): `toast_component_fn` now renders Phoenix flashes in connected and non-LiveView hosts, `flash_group_id` can identify the flash-only container, and flashes added after mount update correctly.

## [v0.1.0] (2024-03-06)

🚀 Initial release.

## [v0.2.0] (2024-03-08)

Bug fixes:
- JS.Show on the flashes now correctly toggles them to display flex instead of block
- The component functions properly when used in non-liveviews

## [v0.3.0] (2024-03-12)

Bug fixes:
- Fixing quite a few little problems here and there
- Adding more configuration

## [v0.4.0] (2024-05-11)

Massive overhaul of look and feel.

## [v0.4.1] (2024-05-11)

Demo repo bug fixing.

## [v0.4.2] (2024-05-15)

Tightening up a few bugs found during the creation of the demo.

## [v0.4.3] (2024-05-15)

Fix implementation of `send_toast`.

## [v0.5.0] (2024-05-16)

New Public API.

## [v0.6.0] (2024-05-17)

Fixed Hex release. Some files were missing from the build.

## [v0.6.1] (2024-05-18)

Remove a `console.log` from the JS bundle.

## [v0.6.2] (2024-05-19)

Releasing new bundle (meant to compile it in `v0.6.1`).

## [v0.6.3] (2024-05-22)

- Documentation updates.

## [v0.6.4] (2024-07-10)

- More documentation updates.
- Fixes invalid usage of Phoenix LiveView streams by moving the flashes outside the stream container.
- Fixes a bit of a visual issue when loading on non LV pages by setting opacity to 0.
- New feature: arbitrary severity levels other than `:info` and `:error`.
- Various refactorings and cleanups.
- Fix required LV version to 0.20.
- Added proper TypeScript types.
- Added customization for the container class.

## [v0.7.0] (2024-12-26) 🎄

- Big fix to longstanding issue where toasts don't work properly across navigations: #28
- Added gettext internationalization from #16 (thanks @elephantoss)
- A couple other random cleanups and docs changes.

## [v0.8.0] (2024-02-14) ❤️

- Fixed typespecs from #26 (thanks @wkirschbaum)
- Added `:top_center` and `:bottom_center` positions in #29 (thanks @nallwhy)
- Feature: infinite duration toasts from #31 (thanks @vanderhoop)
- Readme fixes in #32
- Fix earlier weirdness with gettext usage in 0.7.0 in #34 (thanks @neilberkman)
- Fix docs source ref in #39 (thanks @Flo0807)

## [v0.9.0] (2026-07-24)

## Highlights

- Add a browser JavaScript API: `addToast/3` requests server-rendered toasts from frontend code.
- Add programmatic dismissal with `LiveToast.dismiss_toast/2` and the composable `LiveToast.dismiss/1` action for custom components.
- Pause timed toasts while hovered or focused, then resume with their remaining duration.
- Support persistent toasts with `duration: 0` or `:infinity`.
- Add `:top_center` and `:bottom_center` host positions.
- Allow a default custom toast component function on `toast_group`, with per-toast overrides.
- Pass application metadata through to custom toast components.
- Make connection-state notices customizable, replaceable through slots, or fully disableable.
- Add recipes and documentation for the new APIs and customization paths.