Theme changes

What changed for theme authors in each release, newest first. Each release starts with what you may need to do; the rest needs nothing from you.

3.2.0: check your theme

Installed themes keep loading. If a row matches your theme, do what the right column says.

If your theme…Do this
ships its own layout/shell.json, or places the nav items in a view, without nav.lanAdd nav.lan beside the other nav items. It is required in every view, so until it is placed the server browser and Mods screens fall back to Neutral's and Dev Mode names it. A theme that places surface.navRail already has it.
places a new element from the list belowSet minimumLauncherVersion to 3.2.0. Older launchers don't know these elements, so a file that places one falls back to Neutral's there (ELE-01).
places or styles the notice.* barsNothing breaks, but those placements render nothing now: every launcher message is a toast in the top-right corner, which the launcher owns. The elements stay registered, so you can leave the placements in or remove them, and drop their CSS.
styles server.region or sizes the column that holds itIt shows the country now, not the region: a flag image, then the country name or its two-letter code. Check the column width, and style or hide [data-part="flag"].
styles settings.discordPresenceIt is a wrapper now, holding the Rich Presence row and a second row, showServer. Your class lands on the wrapper, and a selector such as [data-el="settings.discordPresence"] [data-part="box"] matches both boxes. Reach the first row with [data-el="settings.discordPresence"] > label and the second with [data-part="showServer"].
places server.pingA server behind DDoS protection now shows a shield and carries a tip paragraph. The tip stays hidden and out of the layout unless your CSS shows it, for example on :hover; the shield's title carries the same text.
works around popups pausing transforms or filters, or targets [data-popup-ancestor]Drop the workaround. Anchored popups now show in the browser's top layer (they carry popover), so the elements around them keep their transforms and filters, and the attribute is gone. They paint above toasts.

3.2.0: new and fixed

Nothing here needs a change, but you may want to use it.

Server browser

Servers and mods

Settings

Popups and lists

3.1.0: check your theme

Installed themes keep loading. If a row matches your theme, do what the right column says.

If your theme…Do this
overrides a launcher rule that keeps required elements visible or usableNothing to change, but those rules win now. styles.css loads inside the theme cascade layer, above Neutral and below the launcher's guarantees, as the CSS API always described.
styles popup.mapOptionsThe element is now a wrapper holding a search part and the role="listbox" list. Style the options inside the list, and give the search box a look if your popups need one.
hid update.changelog's "No changelog notes" line in CSSDrop the rule: the element renders nothing while there is no update.
styles update.title with a tag selector such as span[data-el=…]It is an h2 now. Attribute selectors keep working.
gives serverMod.state's label a class and relied on its built-in mono fontAdd the font to your class: built-in classes on that label are now defaults your class replaces.

3.1.0: new and fixed

Nothing here needs a change, but you may want to use it.

3.0.0: check your theme

Installed themes keep loading. A layout file that breaks a stricter rule falls back to Neutral's on its own, and Dev Mode's check names it; a package that breaks an import rule below is refused at import and export until it is fixed. If a row matches your theme, do what the right column says.

If your theme…Do this
has preview images outside previews/Move them into previews/ and update theme.json. Import and export refuse any other path.
has a settings field or option with an empty label, or a number default outside min..maxGive every label 1 to 40 characters and keep defaults in range. Otherwise that field is left out of the settings form.
ships layout/popups/modActions.json or layout/popups/settingsNav.jsonDelete them. Nothing ever loaded them, and import now refuses them.
uses a text node role outside the list of tenUse display, heading, subheading, body, label, caption, micro, button, chip or data (LAY-03).
has an SVG that links outside itselfKeep href to #id or embedded PNG, JPEG, WebP or GIF data. No <foreignObject>, stylesheet links, @import, outside url(…) or CSS escapes.
has a CSS selector with a pseudo-class right after a space, such as [data-el="x"] :hoverAnchor it: [data-el="x"] [data-part="y"]:hover or > :hover. :nth-child() takes An+B, odd or even only. See CSS API.
declares a --z-* custom propertyRemove it. The stacking order belongs to the launcher (CSS-04).
cancels launcher spacing with > :not([hidden]) ~ :not([hidden])Use > :not(:last-child). Launcher spacing now sits below or right of each child but the last.
sets a colour, background or opacity on an element and relied on the built-in hover or disabled lookAdd your own :hover or [data-state~="disabled"] rule. Your rule now wins in every state.
styles the box part in a filter popup as a checkboxStyle it as an icon column: it holds a check icon (the tag popup's ✓/✗ instead). Select picked rows with [data-part="option"][data-state~="selected"]; excluded tags carry excluded instead.
styles the tag popup's ✓/✗ with [data-part="option"] > [data-part="indicator"]Use a descendant selector: the indicator now sits inside the box part.
styles update.install, update.viewRelease or the workshopMod score, subscribers, include or exclude elements as plain textThey now start with an icon part. Give them display: inline-flex; align-items: center; gap: …, or hide [data-part="icon"].
places server.downloadSizeCheck its new wording ("{n} mods", then "Download size: {size}") and drop any [data-state~="checking"] rule.
places server stats inside a "context": "selection" containerThey draw as in the server info window now, without the built-in "PLAYERS", "PING", "TIME" and "MODS" labels. Add your own text beside each element, and move [data-part="label"] styling to it.
places settings.sectionTitle, sectionDescription or sectionIcon in a plain boxThey are inline now. Add display: block or put them in a column stack if you want separate lines.
sizes the mod.thumbnail placeholder as an iconCheck it: the placeholder is text now.
ships layout/popups/serverActions.json or serverLoad.jsonCheck them: the server menu now opens them instead of the launcher's own list.
styles notice.launchAdd a [data-state~="success"] rule. The bar now also shows short "Done" messages, such as "Address copied", for two seconds.
started from a starter templateNothing breaks. New themes now start as a copy of Neutral or Tactical; the starters are gone.

Newly required elements are not placed for you. A screen that lacks a required element falls back to Neutral's, and Dev Mode names the missing element. When a release lists one, add it to your layout files.

3.0.0: new and fixed

Nothing here needs a change, but you may want to use it.

Layout and settings

Colours and popups

Elements

Themes page