This project is currently unmaintained.

What if you didn't have to write electron apps anymore?

Terra offers a platform-independent, featureful toolkit that allows you to easily and quickly build your application, and then flexibly go as low-level as you need to optimize your application.
This toolkit was built based on my experience with AwesomeWM, Elm, and Elm-ui, and other projects. I hope you find it useful.

Whether weather app image

Terra aims to make developing cross platform applications an experience that is both fast and pleasant, without sacrificing on aesthetics or performance.

Mathgraph app image

Warning: Terra is experimental software and very early in development. We push to the main branch and live life day to day. :)
Also, I'm working on this whenever I have time and whenever I feel like it. I may be slow to solve issues. Terra currently only works with luajit on linux under Xorg. Support for Wayland, Windows and Mac is planned.
If you experience any issues with installing, bugs, etc., you can open an issue or contact me directly.

This code creates an application, creates a window, creates a UI tree with Oak, terra's built-in UI library, paints a green background, creates a red ball, draws "hello world" on it, and animates the ball to spin in a circle.

#!/usr/bin/env luajit
local t_app = require("terra.app")
local t_window = require("terra.window." .. t_app.get_platform())
local tt_color = require("terra.tools.color")
local to_size = require("terra.oak.size")
local to_align = require("terra.oak.align")
local toeb_root = require("terra.oak.elements.branches.root")
local toeb_el = require("terra.oak.elements.branches.el")
local toel_bg = require("terra.oak.elements.leaves.bg")
local toel_text = require("terra.oak.elements.leaves.text")
local function init_app(app)
 local model = {}
 app.model = model
 -- create the window
 model.main_window = t_window.create(app, 320, 420, 200, 160, {
 tree = toeb_root.new({ -- the root of the UI tree
 toeb_el.new({ -- the background of the window
 width = to_size.FILL,
 height = to_size.FILL,
 bg = toel_bg.new({
 source = tt_color.rgb(0.17, 0.42, 0.21), -- green
 }),
 toeb_el.new({ -- the red ball
 halign = to_align.CENTER,
 valign = to_align.CENTER,
 width = 60,
 height = 60,
 bg = toel_bg.new({
 source = tt_color.rgb(0.8, 0.1, 0), -- red
 border_radius = 30,
 }),
 -- declaratively subscribe to signals on elements
 subscribe_on_root = { 
 ["AnimationEvent"] = function(self, time)
 local spin_push = 20
 self:set_offset_x(math.sin(time) * spin_push)
 self:set_offset_y(-math.cos(time) * spin_push)
 end
 },
 toel_text.new({ -- "hello world" text
 family = "Roboto",
 size = 11,
 width = 40, -- constrain the width so the text wraps
 halign = to_align.CENTER,
 valign = to_align.CENTER,
 text = "hello world",
 fg = tt_color.rgb(1, 1, 1),
 })
 }),
 }),
 }),
 })
 t_window.request_raise(model.main_window)
end
t_app.desktop(init_app, t_app.make_default_event_handler(function(app, event_type, ...)
end))

The above code produces the following output (without the titlebar):

green background red ball image

1. Clone the repo
   git clone https://github.com/chris-montero/terra.git
2. Build the project and install the luarock
   sudo luarocks make
3. That's it. Now you should be able to successfully run the code in the Example section.

• Uli Schlachter, for promptly and elaborately answering my questions about Xorg on stack overflow.
• My mom, for sponsoring this project. Thanks mom.

You are welcome to contribute by opening issues, comitting code, or through donations.
Any support is sincerely appreciated.

https://ko-fi.com/chrismontero

US DOLLAR IBAN: RO75BTRLUSDCRT0323524101
EURO IBAN: RO71BTRLEURCRT0323524101