LiveReact

React inside Phoenix LiveView.

Features

• ⚡ End-To-End Reactivity with LiveView
• 🔋 Server-Side Rendered (SSR) React
• 🦄 Tailwind Support
• 💀 Dead View Support
• 🐌 Lazy-loading React Components

Resources

• Demo
• HexDocs
• HexPackage
• Phoenix LiveView
• Development
• SSR
• Deployment

Why LiveReact

Phoenix LiveView enables rich, real-time user experiences with server-rendered HTML. It works by communicating any state changes through a websocket and updating the DOM in realtime. You can get a really good user experience without ever needing to write any client side code.

LiveReact builds on top of Phoenix LiveView to allow for easy client side state management while still allowing for communication over the websocket.

Installation

1. Add live_react to your list of dependencies in mix.exs:

def deps do
  [
    {:live_react, "~> 0.2.0-rc.0"}
  ]
end

2. Adjust the setup in mix.exs:

• For Linux/MacOs

defp aliases do
    [
      setup: ["deps.get", "assets.setup", "npm install --prefix assets", "assets.build"],
    ]
end

• For Windows

defp aliases do
    [
      setup: ["deps.get", "assets.setup", "cmd --cd assets npm install", "assets.build"],
    ]
end

3. Run the following in your terminal

mix deps.get

4. Add import LiveReact in html_helpers/0 inside /lib/<app_name>_web.ex like so:

# /lib/<app_name>_web.ex

defp html_helpers do
  quote do

    # ...

    import LiveReact # <-- Add this line

    # ...

  end
end

5. Create a package.json file at assets/package.json

{
  "dependencies": {
    "@mrdotb/live-react": "^0.2.0-rc.0",
    "phoenix": "file:../deps/phoenix",
    "phoenix_html": "file:../deps/phoenix_html",
    "phoenix_live_view": "file:../deps/phoenix_live_view",
    "react": "^18.3.1",
    "react-dom": "^18.3.1"
  }
}

6. Create a react directory inside assets and add a index.js file

// import and export the react components you want to use in your LiveView
// ex: import { Simple } from "./simple";

// ex: export default { Simple };
export default {};

7. Add the following to your assets/js/app.js file

...
import components from "../react";
import { getHooks } from  "@mrdotb/live-react";

const hooks = {
  ...getHooks(components),
};

let csrfToken = document
  .querySelector("meta[name='csrf-token']")
  .getAttribute("content");
let liveSocket = new LiveSocket("/live", Socket, {
  hooks: hooks, // <-- pass the hooks
  longPollFallbackMs: 2500,
  params: { _csrf_token: csrfToken },
});
...

7. For tailwind support, make some addition to content in the assets/tailwind.config.js file

content: [
  ...
    "./react/**/*.jsx", // <- if you are using jsx
    "./react/**/*.tsx" // <- if you are using tsx
],

Examples

Check out the demo website on fly.io to see some examples of what you can do with LiveReact.

Credits

I was inspired by the following libraries:

• LiveVue
• LiveSvelte

I had a need for a similar library for React and so I created LiveReact 👍