LUIS: Love UI System - SAMPLES

October 11, 2025 · View on GitHub

LUIS (Love User Interface System) is a flexible graphical user interface (GUI) framework built on top of the Löve2D game framework. LUIS provides developers with the tools to create dynamic, grid-centric, layered user interfaces for games and applications.

LUIS: Samples

Flexible Layout using FlexContainer with a couple of widgets.

You can see different layers, a custom widget within a Flex container, theming, and a variety of available widgets.

Virtual gamepad integration made with LUIS.

A LUIS UI-Editor made with LUIS.

1-bit full adder node graph - created with LUIS Node Widgets.

Getting Started

Install Löve2D (11.5): You can download Löve2D 11.5 from here.

Clone the LUIS Library:

git clone --recurse-submodules https://github.com/SiENcE/luis_samples.git

Start the samples:
```
love luis_samples/
```
Switch samples: Edit main.lua to switch look at different samples.

Features

Feature	Description
Flexible Layout	Uses a grid-based system and FlexContainers for easy UI layout
Layer Management	Support for multiple UI layers with show/hide functionality & Z-indexing for element layering
Theme Support	Global theme customization, Per-widget theme overrides
Customizable Theming	Easily change the look and feel of your UI elements
Widget API	Core system for loading and managing widgets (widgets themselves are optional and loaded dynamically)
Event Handling	Built-in support for mouse, touch, keyboard, and gamepad interactions & focus management
Responsive Design	Automatically scales UI elements and interaction based on screen dimensions
State Management	Tracks and persists element states to save and load configurations
Extensibility	Modular design allowing easy addition of new widgets or removing unneeded widgets (see Widget Types section)
Debug Mode	Toggle grid and element outlines for easy development

Note: These features are all part of the LUIS core library (core.lua), which has zero dependencies! You can use the core library on its own and implement your own widgets for a lightweight UI system for Löve2D without any additional dependencies.

Documentation

For more detailed information on the LUIS API, including layer management, input handling, theming, and state management, please refer to the LUIS core documentation.

Dependencies

Löve2D: The game framework used for rendering and managing game objects.
The core library has zero dependencies, so you write your own widgets to have a lightweight ui system (see basic_ui_sample ).

known Problems

DropBox: Selection with the gamepad-analogstick works not for all choices
FlexContainer - dropdown select is not possible via gamepad-analogstick
TextInput - when changing Theme, we have to adjust the fontsize in TextInput widgets
TextInputMultiLine doesn't support setConfig/getConfig