Show HN: Ito – Build Terminal UIs in Lua

72 pointscat-whisperer1 day ago13 commentsView on HN

My friend and I are huge Neovim nerds. We like to rice our terminals and our editors. We just wanted a harness that we can do the same with, rice it till our hearts' desire. So, we started looking out for harnesses. Pi was great, Pi was good. But in the end, it was JavaScript. I don't have anything against JavaScript, but Lua is more fitting, and I can just as easily base it in Rust to make it even faster. So, we started cooking, and we ended up with a design that's minimal at its core and is built using Lua. Every built-in abstraction, the way you define providers, the way you rice it up, everything, literally everything, you can do in Lua.

But how? How does it all work? I proposed we just do it the Ratatui way, but my friend was like, nah! We shall make it possible to build TUIs in Lua. (Weirdo!) But it paid off, and we got ourselves a shiny new Lua library, ito!!!

He didn't get the gravity of the situation. We had an awesome terminal UI library in Lua! I wanted everyone to know how cool that is, so I got cooking, wrote myself a custom canvas implementation of this library instead of the usual terminal adaptor, exported it as wasm, and made this super cool website where you can experiment building awesome UIs in Lua. For vibe-coders, we got an llms.txt too. Have at it, and see if you can build something really cool with it. The library's at github.com/uji-labs/ito, and the awesome sauce harness is at github.com/uji-labs/uji.

I hope you like it!

satuke1 day ago

this is amazing, i'll try it out!

cat-whisperer1 day ago

feel free to raise issues if anything feels off. The plan is to make it the rice harness :)

*oh! I meant the right harness for you

hollowturtle1 day ago

Great job! The declarative API looks sick! I'll try it. Sometimes I love to think that if our universe is really infinite, then somewhere there's a universe where the browsers supports native luajit scripting instead of javascript(and in another universe all of this plus array indexes starting from 0 ;)

cat-whisperer1 day ago

I trust you would make that happen! And I would be right there to use it in my next project

Yannik_Sc23 hours ago

While I generally like Lua this code just looks .. not so Lua - like, it definitely is Lua, but it could look much better by utilizing language features like "Parenthesis-free calls":

  ui.Button "Button Text" {
   
      print("Hello world")
    end,
    disabled = true
  }

  ui.VStack {
    padding = 31, -- Named key => option
    wrap = true,
  
    ui.Button "..." {}, -- Indexed by number => children
  }

feels more Lua and slightly cleaner imo

otikik23 hours ago

I had a similar impression. It feels "not idiomatic". I disagree on the diagostic though - I think parenthesis-free calls are not what define what idiomatic lua is.

To me it is more about expressiveness and usage of basic language features. For example here's how a text field is set up currently.

           ito.TextField(draft)
                :label("Name")
                :focused()
                :on_submit(function(value)
                    if value:match("%S") then
                        phase.value = "review"
                    end
                end)
                :on_cancel(function()
                    phase.value = "choose"
                end),

The field is created on the first line, and then altered further with subsequent method calls that alter it. This reads like someone very used to Rust (and its Builder pattern) and then translating it verbatim to Lua. A more native Lua interface for me would look like this:

           ito.TextField(draft, {
                label = "Name",
                focused = true,
               
                    if value:match("%S") then
                        phase.value = "review"
                    end
                end,
               
                    phase.value = "choose"
                end),
           })

As in: just pass a table to the builder. And if they ned to modify it later, they can just do:

           some_textfield.on_cancel = <some other function>

No need to "guard" the internal table with those extra methods.

cat-whisperer23 hours ago

that’s fair; I was suggesting something even more drastic than this https://github.com/uji-labs/ito/issues/4

maybe it’s a bad idea :X

cat-whisperer23 hours ago

it does, but I am a fan of the composability that ratatui has, and I wanted to copy it over…