iris-plasma (improved-garbanzo)

An immediate-mode UI framework for Roblox with Iris visual style and a Plasma-compatible API.

Features

• Plasma-compatible API – same useInstance, useState, useEffect, useKey, scope, widget, window, etc.
• Iris dark theme – Dear ImGui inspired color palette (dark blues, accent blues, transparent frame backgrounds)
• No automatic sizing – all widgets have explicit, fixed pixel sizes (unlike Plasma)
• Modern Roblox UI – UICorner, UIStroke, UIListLayout, ScrollingFrame used throughout
• Interactive demo gallery – demoWindow() now has inline gallery tab plus dedicated side-window demos
• Table widgets – immediate-mode table, tableRow, and tableCell with nested widgets, borders, and striping

Installation

Install with Wally by adding to your wally.toml:

EgooE = "capedbojji/[email protected]"

Or sync with Rojo using default.project.json.

Demo Window

The quickest way to see all widgets in action — just call demoWindow() inside your start loop:

local EgooE = require(path.to.EgooE)
local node = EgooE.new(playerGui.ScreenGui)

RunService.Heartbeat:Connect(function()
    EgooE.start(node, function()
        EgooE.demoWindow()
    end)
end)

This opens a gallery window with 2 tabs:

• Gallery for broad inline widget examples
• Demos for dedicated playgrounds that open side windows for window, childWindow, table, popup, modal, and layout tests

Quick Start

local EgooE = require(path.to.EgooE)

local node = EgooE.new(playerGui.ScreenGui)

RunService.Heartbeat:Connect(function()
    EgooE.start(node, function()
        EgooE.window("Demo", function()
            EgooE.heading("Hello, Iris!")
            EgooE.separator()
            EgooE.label("This is a label.")

            if EgooE.button("Click me"):clicked() then
                print("Button clicked!")
            end

            local checked = EgooE.checkbox("Toggle me"):checked()
            local value   = EgooE.slider({ min = 0, max = 100, label = "Speed" })

            local handle = EgooE.input({ placeholder = "Type something..." })
            if handle:changed() then
                print("Input:", handle:value())
            end
        end)
    end)
end)

Widgets

Widget	Description
window	Draggable, resizable, scrollable window
button	Iris-styled click button
checkbox	Controlled/uncontrolled checkbox
slider	Horizontal range slider
input	Text input box
label	Single-line text display
heading	Bold section heading
separator	Horizontal divider line
row	Horizontal layout container
childWindow	Inline scrollable panel with clickable header
table	Immediate-mode table container
tableRow	Table row builder
tableCell	Table cell builder for nested widgets
space	Blank pixel spacer
portal	Mount children in an arbitrary Instance
demoWindow	Live showcase of every widget (zero setup)

Style

The Iris dark theme is applied by default. Override any values per-scope with setStyle:

EgooE.setStyle({
    buttonColor = Color3.fromRGB(200, 60, 60),
})
EgooE.button("Danger")

API

Identical to Plasma:

EgooE.new(rootInstance)
EgooE.start(node, fn)
EgooE.beginFrame(node, fn) / continueFrame(handle, fn) / finishFrame(node)
EgooE.scope(fn)
EgooE.widget(fn)
EgooE.useState(initial)
EgooE.useInstance(creator)
EgooE.useEffect(callback, ...deps)
EgooE.useKey(key)
EgooE.createContext(name) / provideContext(ctx, val) / useContext(ctx)
EgooE.useStyle() / setStyle(fragment)