Optional Modules

Basalt keeps animation, responsive behavior, charts, images, large text, themes, XML, and debugging outside the core runtime. Load only the features an application needs:

local basalt = require("basalt")
local animation = basalt.use("animation")

Repeated calls return the loaded module. Load a module before creating any element classes it registers.

Choose a Module Guide

• Animation and Responsive Layouts — animate numeric properties and switch layout styles at breakpoints.
• Charts, Images, and BigFont — visualize data, load image assets, and display large terminal text.
• Styling, States, and Themes — apply presets and reusable styles.
• XML Interfaces — construct element trees from XML.
• Debugging — add the live debug overlay.

Available Loader Names

Loader	Main capability
animation	Numeric property tweening
responsive	Breakpoint-driven temporary styles
charts	Graph, PixelGraph, BarChart, and LineChart
bigfont	Large terminal text
image	BIMG and FLIMG loading and playback
theme	Presets, defaults, and subtree styling
xml	XML parsing and element construction
debug	On-screen log overlay

Side Effects

Some modules register new element classes or add fluent Element methods. Load them during startup, before constructing the affected UI:

basalt.use("charts")
local graph = frame:addPixelGraph({...})

Module names are lowercase loader names, not element class names.

Next Steps

Start with Animation and Responsive Layouts or Charts, Images, and BigFont, depending on the feature your interface needs.