I needed to reuse React components from my Chrome extension in my Phoenix/LiveView backend. I noticed that for Svelte/Vue, there are live_vue and live_svelte. So, I created the equivalent in React, live_react:
Great work! I do wonder if there is some kind of shared abstraction these libraries could build on - if there was something like live_vite or live_frontend, or something like that, then have adaptors for each FE framework.
live_react has been picking up interest, as seen in projects like PhoenixAnalytics. Inspired by the Server-Side Rendering (SSR) features in live_svelte and live_vue, I’ve implemented it for live_react.
I released a 0.2.0-beta and will release 0.2.0 when I’m confident the SSR feature is production ready.
Hello, I am new to the Elixir community, i think you have a great project. I went through the live example in the github project,i was hoping to find JSX related syntax in the example but i did not. i don’t know if its in there somewhere. which kept me wondering how does live_react workings like react itself. I will appreciate clarification. Also i want to suggest that it will be nice to have the configuration scaffold with a command to get everything setup instead on following the installation guide with a lot of configs. it makes its quiet easy to setup for use. thank you.
Hi! Welcome to the Elixir community, and thanks for your interest!
LiveReact isn’t a full React framework like inertia-phoenix —it lets you render React components inside LiveView / DeadView, not replace it. You can check out the demo to see it in action.
For internals, the source code is short and worth reading.
Regarding scaffolding
There’s already a Mix task to help with setup—see the [installation guide]
Almost everything in this release is a port of work that already existed in live_vue - props diffing, stream support and
the encoder protocol. Claude did the bulk of the porting.
Big thanks to @Valian
Breaking Changes:
data-props is now encoded through the new LiveReact.Encoder protocol instead of Jason.Encoder. Structs passed as props need @derive LiveReact.Encoder (or an
explicit implementation); plain maps are unaffected. See Upgrading to 2.0.
Features:
Props are diffed and sent incrementally over data-props-diff instead of the full
props being re-sent on every update. On by default
(config :live_react, enable_props_diff: true), opt out globally with false or per
component with diff={false}.
Phoenix.LiveView.stream/4 assigns are supported: a stream passed as a prop is 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 you are most likely to pass
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.
The demo app moved out of the library into its own repository and now lives at https://live-react.mrdotb.com. Every example has Preview / LiveView / React tabs,
so you can read the server side and the client side of the same page side by side.
The 2.0 features have examples of their own:
props-diffing — only the changed
prop path travels over the wire, unless a component opts out