Skip to main content
The application object returned by Library.new() is the entry point for the entire library.

Library.new(config)

Creates the root ScreenGui, loads configuration, initializes Quick Commands, applies the initial theme, and creates the built-in Settings tab.
table
Application configuration. Omit the table to use the built-in defaults.
string
default:"\"Unnamed\""
Library name used in internal state and console messages.
string
default:"\"\""
Folder used for the JSON configuration file. When empty, the config is stored as <SaveId>.json.
string
default:"\"config\""
Base name for the JSON configuration file. The .json extension is added automatically.
table
Initial theme. Use a table of supported theme channels or one of the built-in presets such as Library.Themes.Midnight. Theme values must be Roblox Color3 values.
Color3
Backward-compatible top-level accent override. Accent is accepted as an alias.
Color3
Backward-compatible top-level tab heading color override. TabHeading, HeaderText, and the corresponding theme aliases are accepted.
Color3
Backward-compatible top-level background override. Background is accepted as an alias.
Color3
Backward-compatible top-level text override. Text is accepted as an alias.
Color3
Backward-compatible top-level input background override. InputBackground is accepted as an alias.
Color3
Backward-compatible top-level muted color override. Muted is accepted as an alias.
Theme is the preferred configuration surface for new code. Theme settings are applied at startup but are not written to the JSON persistence file.
Library.new() also creates a tab named Settings. Calling CreateTab("Settings") later returns that existing tab.

Library.Themes

Library.Themes contains the built-in theme presets: Presets are ordinary Lua tables, so you can pass them directly to Theme or SetTheme, or copy one and modify individual channels.

Theme channels

The theme system supports eight color channels. Keys are case-insensitive.
For custom themes, the canonical keys shown in the first column are recommended. A theme may be partial, so you only need to provide the channels you want to change.

Methods

app:CreateTab(name, defaultPosition)

Creates a draggable floating tab. Reusing an existing tab name returns the existing tab object.
string
required
Tab title and the key used for saved tab position/state.
UDim2
Initial pixel position used only when the tab has no saved position.
New tabs start minimized. Without a saved position or explicit position, the library stacks them vertically. Dragging is viewport-clamped and can use grid snapping.

app:GetTab(name)

Returns an existing tab object or nil if the name is not registered.

app:ToggleGui(forcedState)

Shows or hides every floating tab. The Quick Commands overlay remains available.
boolean
When supplied, visibility is set directly instead of toggled.
The same action is bound to Right Shift by default. The key can be changed from the built-in Settings tab.

app:SetTheme(themeTable)

Applies every recognized Color3 channel in a theme table to the running UI. Existing components that listen to the affected channel update immediately.
The same alias rules used by config.Theme are accepted. Unknown keys and non-Color3 values are ignored.

Individual theme setters

Each setter changes one theme channel at runtime:

app:ExportQuickCommandsList()

Prints every registered Quick Command, returns the same entries as a Lua array, and writes a text file when the environment exposes writefile.
The file path is:
When SaveFolder is empty, that becomes:
Each line contains the command title, command ID, aliases, and usage when applicable.

Complete application surface

The user-facing application API is:
ConfigManager, KeybindManager, State, and component .create() functions are bundled implementation modules, not part of the stable application contract.