An experimental TUI library based on LiveView without using 3rd party NIFs.
Breeze is built on top of Termite and BackBreeze
This library is highly experimental and incomplete. It provides an example of how a TUI based on LiveView could work.
I mainly built it for writing snake, which is in the examples directory.
- LiveView style API
- mount/2
- handle_event/3
- components
- attributes
- slots
- behaviours for all of the modules that expect callbacks
- Whitespace is a bit janky in the Heex
- A decent way to handle logging
- A decent way to handle errors/exceptions
- viewports/sizing calculations allowing for scrollable regions
- this requires modifications to how BackBreeze renders boxes
- A component library
- handle colour variants
Breeze sort of uses LiveView. LiveView is a required dependency for now as Heex is used to handle rendering. Currently the way LiveView is used is very inefficient as we have to do multiple passes to convert the Heex to BackBreeze boxes for rendering. If this experiment is successful, it is likely that the Heex sections of LiveView will be ported to this project and modified in a way that makes sense.
Breeze can be installed by adding breeze to your list of dependencies in mix.exs:
def deps do
[
{:breeze, "~> 0.2.0"}
]
endMix.install([{:breeze, "~> 0.2.0"}]
defmodule Demo do
use Breeze.View
def mount(_opts, term), do: {:ok, assign(term, counter: 0)}
def render(assigns) do
~H"""
<box style="text-5 bold">Counter: <%= @counter %></box>
"""
end
def handle_event(_, %{"key" => "ArrowUp"}, term), do:
{:noreply, assign(term, counter: term.assigns.counter + 1)}
def handle_event(_, %{"key" => "ArrowDown"}, term), do:
{:noreply, assign(term, counter: term.assigns.counter - 1)}
def handle_event(_, %{"key" => "q"}, term), do: {:stop, term}
def handle_event(_, _, term), do: {:noreply, term}
end
Breeze.Server.start_link(view: Demo)
receive do
end
More examples are available in the examples directory.