Skip to content

liveview-native/live_view_native

Repository files navigation

LiveViewNative

Build Status Hex.pm Documentation

About

LiveView Native is a platform for building native applications using Elixir and Phoenix LiveView. It allows a single LiveView to serve both web and non-web clients by transforming platform-specific template code into native UIs:

# lib/my_app_web/live/hello_live.ex
defmodule MyAppWeb.HelloLive do
  use MyAppWeb, :live_view
  use MyAppNative, :live_view
end

# liv/my_app_web/live/hello_live_swiftui.ex
defmodule MyAppWeb.HelloLive.SwiftUI do
  use MyAppNative, [:render_component, format: :swiftui]

  def render(assigns, %{"target" => "watchos"}) do
    ~LVN"""
    <VStack>
      <Text>
        Hello WatchOS!
      </Text>
    </VStack>
    """
  end

  def render(assigns, _interface) do
    ~LVN"""
    <VStack>
      <Text>
        Hello SwiftUI!
      </Text>
    </VStack>
    """
  end
end

Getting started

In addition to live_view_native you may want to include some additional libraries:

{:live_view_native, "~> 0.3.0-rc.1"},
{:live_view_native_stylesheet, "~> 0.3.0-rc.1"},
{:live_view_native_swiftui, "~> 0.3.0-rc.1"},
{:live_view_native_live_form, "~> 0.3.0-rc.2"}

Then add the client plugin to config/config.exs

config :live_view_native, plugins: [
  LiveViewNative.SwiftUI
]

then run:

$ mix lvn.setup

This task will run several other tasks that will generate multiple files into your project. A list of changes to several files in your Phoenix app will be printed after the task completes. Please make sure to complete all of the Required changes otherwise LiveView Native will not run properly.