QSS Structure

QSS Structure

StyleKit themes are split by responsibility so they are easier to maintain.

Typical Structure

  • base.qss: global defaults, fonts, colors, and base widget behavior.
  • controls.qss: buttons, inputs, tables, menus, dialogs, and scroll bars.
  • layout.qss: panels, cards, sidebars, and page containers.
  • icons/: icon resources used by controls and pages.

Naming Guidance

Use stable semantic names instead of page-specific names. For example, primaryButton, warningText, and panelSurface age better than names tied to one screen.