Skip to content

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:

lua
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 ​

Available Loader Names ​

LoaderMain capability
animationNumeric property tweening
responsiveBreakpoint-driven temporary styles
chartsGraph, PixelGraph, BarChart, and LineChart
bigfontLarge terminal text
imageBIMG and FLIMG loading and playback
themePresets, defaults, and subtree styling
xmlXML parsing and element construction
debugOn-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:

lua
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.

Last updated:

Released under the MIT License.