Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

v2.0.0 (2026-09-01)

Breaking Changes:

• data-props is now encoded via the new LiveReact.Encoder protocol instead of Jason.Encoder. Struct props must now @derive LiveReact.Encoder (or implement it explicitly) — plain maps are unaffected. See Upgrading to 2.0 for migration examples.

Features:

• Props are now diffed and sent incrementally over data-props-diff instead of being fully re-sent on every update (config :live_react, enable_props_diff: true by default; opt out globally with false or per-component with diff={false}).

• Added support for Phoenix.LiveView.stream/4 assigns: a stream passed as a prop is now automatically diffed and delivered over data-streams-diff, arriving on the client as an array whose items carry their __dom_id.

• LiveReact.Encoder ships implementations for the structs most likely to be passed as props: Phoenix.HTML.Form (including Ecto changeset values and errors), Phoenix.LiveView.AsyncResult, Phoenix.LiveView.UploadConfig, Phoenix.LiveView.UploadEntry, and Date, Time, NaiveDateTime and DateTime.

Bug Fixes:

• Props diffing no longer requires the call site to pass socket. A render was previously treated as dead whenever socket was absent, which forced the full-props branch on every update: data-props was resent carrying only the changed keys, while data-props-diff was never marked as changed. A client in diff mode therefore read a diff attribute that never moved and silently stopped updating. dead is now only derived on the initial render, where it is both knowable and the only place it is used.

• Cleared the compiler warnings raised by Elixir 1.20.

Documentation:

• Added the Props Diffing and Streams and Upgrading to 2.0 guides, and documented the reserved assigns of LiveReact.react/1.

• The example application moved to its own repository, mrdotb/live_react_examples.

v1.1.0 (2025-06-22)

Features:

• Add React Link component for Phoenix LiveView navigation by Gaoge Zhang

v1.0.1 (2025-04-20)

Bug Fixes:

• add missing useLiveReact type

v1.0.0 (2025-03-10)

Breaking Changes:

• vitejs: switch from Mix Esbuild to Vite.js

Features:

• add tests based on the one from live_vue
• add SSR support
• support inner_block slot
• context provider for live_react
• add typescript support

v1.0.0-rc.4 (2025-01-22)

Features:

• add tests based on the one from live_vue

Bug Fixes:

• Ensure app.ts entrypoints can be used with @react-refresh

v1.0.0-rc.3 (2024-12-08)

Features:

• support inner_block slot

v1.0.0-rc.2 (2024-12-01)

Features:

• Added SSR duration logging to example app

Bug Fixes:

• rename react folder to react-components to prevent Vite error

v1.0.0-rc.1 (2024-10-12)

Bug Fixes:

• missing files in mix.exs to ship the js

v1.0.0-rc.0 (2024-10-05)

Breaking Changes:

• vitejs: switch from Mix Esbuild to Vite.js

v0.2.0-rc.0 (2024-09-17)

Features

• Add SSR support

Bug Fixes:

• ssr: remove compiler warning when using live_react without SSR

v0.1.0 (2024-06-29)

Initial release