Home

Welcome to the wiki for LibSettingsDesigner, a vendored settings-center library for World of Warcraft addons.

LibSettingsDesigner is not a shared LibStub package. It is loaded into the host addon's namespace as:

addon.LibSettingsDesigner.Config
addon.LibSettingsDesigner.UI

Use this wiki when integrating the library, adding settings pages, building wrapper bridges, documenting elements, or validating changes.

Start Here

Page	Use it for
Architecture	Mental model, data flow, runtime boundaries.
Vendoring	Folder layout, TOC/XML loading, assets, LibStub rules.
Quick Start	Smallest useful copy/paste setup.
Field Glossary	Field names, aliases, value/default/visibility rules.
Troubleshooting	Common failures and fixes.
Validation	Checks and handoff template.

Reference

Page	Use it for
Config API	App/category/page/group/control registration and value model.
UI API	Opening, toggling, frame state, refresh rules.
Elements	All rendered element types.
Examples	Copyable patterns and samples.

Element Pages

• Category
• Page
• Group
• Toggle
• Slider
• Dropdown
• MultiDropdown
• Input
• Button
• ColorPicker
• ColorOverrides
• SoundDropdown
• CheckboxDropdown
• ReorderList
• Notes
• Dashboard
• InfoPage

Examples

• Minimal Addon
• Complete Settings Center
• Wrapper Bridge Pattern
• Dependent Controls
• Dynamic Dropdowns
• Nested Database Values
• Search and New Badges
• Runtime Refresh

Principles

• Every addon owns its vendored copy.
• Feature strings belong to the host addon locale files.
• Stable ids are required for pages, groups, and controls.
• Use explicit getters/setters for anything that is not a simple profile DB key.
• Keep callbacks focused on persistence and runtime refresh.
• Use notes/info pages for long explanations instead of oversized row text.
• Do not rebuild the settings frame from dropdown or MultiDropdown selection callbacks.
• Keep documentation and examples in sync with code when source files are available.