promotional bannermobile promotional banner

Lib: NoobTaco-Config

A modular, schema-driven configuration framework for WoW addons. Build modern, 'pixel-perfect' options menus with built-in theming, transactional state, and complex layouts. (Developer Library)

NoobTaco-Config

CI Status Release Status Discord Buy Me A Coffee

NoobTaco-Config is a modular, schema-driven configuration framework for World of Warcraft addons. Designed with a focus on "pixel-perfect" aesthetics and ease of use, it allows developers to build complex, themed options menus using simple Lua tables.

๐Ÿ“ธ Screenshots

Overview Theme Support
Welcome Themes

[!TIP] Use the Library Showcase in-game to see the dynamic theming and all widgets in action.

โœจ Features

  • ๐Ÿ› ๏ธ Declarative Schemas: Define your entire UI layout in nested Lua tables.
  • ๐ŸŽจ Dynamic Theming: Built-in support for NoobTaco, Nord, and Catppuccin themes.
  • ๐Ÿ”ก Accessible Typography: Integrated with the Poppins font family using optimized weights (Medium, Bold) for maximum readability.
  • โšก Transactional State: Built-in commit/revert logic for user settings.
  • ๐ŸŒˆ Inline Color Tokens: Use |ctoken| (e.g., |chighlight|) to dynamically style text based on the active theme.
  • ๐Ÿ“ Nested Data: Native support for dot-notation in IDs to map directly to complex SavedVariables.
  • ๐Ÿ”Š Media Previewing: Specialized media widgets with built-in playback for sounds.

๐Ÿš€ Quick Start

1. Initialization

Retrieve the library via LibStub.

local Lib = LibStub("NoobTaco-Config-1.0")
if not Lib then return end

2. Create a Schema

Define the layout of your settings panel.

local schema = {
    type = "group",
    label = "General Settings",
    children = {
        {
            type = "about",
            icon = [[Interface\AddOns\MyAddon\Media\Logo]],
            title = "My Addon",
            version = "1.0.0",
            description = "A powerful configuration suite.",
            links = {
                { 
                    label = "GitHub", 
                    url = "https://github.com/...",
                    onClick = function() print("Custom Click!") end
                }
            }
        },
        {
            type = "card",
            label = "Feature Settings",
            children = {
                 { id = "enableFeature", type = "checkbox", label = "Enable Magic", default = true },
                 { id = "powerLevel", type = "slider", label = "Power Level", min = 0, max = 100, default = 9000 }
            }
        }
    }
}

3. Rendering

-- Render directly to a Blizzard category frame
Lib.Renderer:Render(schema, myPanel)

๐Ÿ–ผ๏ธ UI Showcase

Inputs & Widgets Buttons Feedback & Alerts
Inputs Buttons Feedback

๐Ÿงช Theme Engine

The library supports instant theme switching. All colors, including inline tokens, update in real-time.

NoobTaco (Standard) Nord (Frost) Catppuccin (Mocha)
NoobTaco Nord Catppuccin

๐Ÿ“š Documentation

โค๏ธ Support

If you're looking for help, have questions, or want to join the community, join us on Discord!

Discord Buy Me A Coffee

๐Ÿ“„ AI Usage

See AI_USAGE.md for more information.

๐Ÿ“„ License

This project is licensed under the GPL-3.0-or-later License - see the LICENSE file for details.

The Lib: NoobTaco-Config Team

profile avatar
  • 4
    Followers
  • 10
    Projects
  • 96.5K
    Downloads
Donate

More from NoobTacoView all

  • NoobTacoUI project image

    NoobTacoUI

    • 9.2K
    • Addons

    The complete UI configuration, profile, and media framework, ready for Midnight.

    • 9.2K
    • February 26, 2026
    • Addons
    • +3
  • NoobTacoUI (Elvui Profile) project image

    NoobTacoUI (Elvui Profile)

    • 35.5K
    • Addons

    NoobTacoUI is an ElvUI Profile that uses the Nord Theme Color scheme of web development

    • 35.5K
    • February 15, 2026
    • Addons
    • +3
  • NoobTacoToolTip project image

    NoobTacoToolTip

    • 1.2K
    • Addons

    NoobTacoToolTip - A simple tooltip replacement

    • 1.2K
    • February 11, 2026
    • Addons
  • NoobTaco GotOne project image

    NoobTaco GotOne

    • 421
    • Addons

    Don't see the win. Hear it. NoobTaco GotOne

    • 421
    • January 12, 2026
    • Addons
    • +3
  • NoobTacoUI project image

    NoobTacoUI

    • 9.2K
    • Addons

    The complete UI configuration, profile, and media framework, ready for Midnight.

    • 9.2K
    • February 26, 2026
    • Addons
    • +3
  • NoobTacoUI (Elvui Profile) project image

    NoobTacoUI (Elvui Profile)

    • 35.5K
    • Addons

    NoobTacoUI is an ElvUI Profile that uses the Nord Theme Color scheme of web development

    • 35.5K
    • February 15, 2026
    • Addons
    • +3
  • NoobTacoToolTip project image

    NoobTacoToolTip

    • 1.2K
    • Addons

    NoobTacoToolTip - A simple tooltip replacement

    • 1.2K
    • February 11, 2026
    • Addons
  • NoobTaco GotOne project image

    NoobTaco GotOne

    • 421
    • Addons

    Don't see the win. Hear it. NoobTaco GotOne

    • 421
    • January 12, 2026
    • Addons
    • +3