November 2026 — newtui 2.9.0, @newtui/nuxt 2.0.0
app-launcher gains a bottom sheet, an operable handle, real dialog behaviour and the parts a full launcher needs.
newtui 2.9.0
-
app-launchergains a bottom sheet, an operable handle, real dialog behaviour and the parts a full launcher needs. Add the item again to get the changes.AppLaunchertakesvariant:popout(the default) orsheet. The sheet fills the width and reads its height from--newt-app-launcher-sheet-height, which defaults to90dvh. The HTML flavour addsnewt-app-launcher--sheet.AppLauncherHandletakeslabelandexpanded. With alabel, it renders abuttonwith that name and reportsexpandedasaria-expanded. Without one, it stays a decorative grip. The HTML flavour addsnewt-app-launcher__handle-button.AppLaunchertakeslabel,modalandinline, and callsonClose(@closein Vue).labelis optional, as it is onChannelInfo, so code that names the launcher witharia-labelkeeps working. Passlabeloraria-label: a dialog without a name fails an accessibility audit.- The Vue
AppLauncherSearchInputtakesv-model. The React one takesonValueChangebesidevalueandonChange. AppLauncherItemtakestrailing(#trailingin Vue) for content after the text, andvariant="tile"for an icon above the name.AppLauncherListtakesvariant="grid"to lay out tiles.AppLauncherItemIconandAppLauncherRecenttakefit:cover(the default) orcontain, for a logo that must not be cropped.- New parts:
AppLauncherPromoCard, withartandfooter(#artand#footerin Vue), andAppLauncherHeaderTitle, the centred title of a drill-in view. The HTML flavour addsnewt-app-launcher__promo,__header-title,__item-trailing,__item--tile,__list--gridand the--containmodifiers.
Five things change for existing code.
AppLauncheris now a dialog built on Radix Dialog (React) and Reka UI Dialog (Vue), so the item installsradix-uiorreka-ui, andclass-variance-authority. The React file is now a client component. It still renders in place, with no portal and no overlay. When it mounts, focus moves into it, and Tab then cycles through its controls. Escape callsonClose, and focus returns when you unmount the launcher. Addmodalwhen the launcher covers the page. If you render the launcher in the page, for example in a showcase, addinline: it then has no dialog role and does not move focus.AppLauncherRecentsrenders aulwithrole="list", and eachAppLauncherRecentwraps its button in anli. A screen reader now announces the number of recent apps. Put onlyAppLauncherRecentparts insideAppLauncherRecents. A React ref onAppLauncherRecentsis now anHTMLUListElement. In the HTML flavour, use auland wrap each recent in anli.- The React
AppLauncherHandleforwards its ref as anHTMLElement, because it renders adivor abutton. AppLauncherItemrenders a rowdivthat holds itsbuttonand, beside it, thetrailingcontent. A control intrailingis no longer nested in the button.className(classin Vue) now styles the row. The ref and the other props still go to the button. In the HTML flavour,newt-app-launcher__itemis the row, andnewt-app-launcher__item-actionis its button.- In the HTML flavour, the dialog behaviour needs the new
app-launcher.jsand adata-newt-app-launcherattribute. Leave the attribute and the dialog role out for a launcher that stays in the page.
-
channel-header,channel-infoandchannel-welcomegain a decorative form for their actions, a narrow header layout and real dialog behaviour. Add the items again to get the changes.ChannelHeaderAction,ChannelHeaderSearch,ChannelInfoActionandChannelWelcomeActiontakeasandhref, asButtondoes.as="span"renders the decorative form for a read-only view. It isaria-hidden, has no pointer and no hover, and is out of the tab order. Its event handlers do not run. In the HTML flavour, put the action class on aspanwitharia-hidden="true".- The same parts,
ChannelHeaderBackandChannelHeaderTitletakedisabled. A disabled link loses its URL, leaves the tab order and carriesaria-disabled, asButtondoes. A disabled control fades to half opacity and shows the not-allowed cursor. ChannelHeaderActionreportsactiveasaria-pressed. Leaveactiveunset for an action that is not a toggle.ChannelHeaderNamenow truncates. The topic shrinks first, and the name shrinks when the topic has no width left.- The narrow header has its own parts.
ChannelHeaderBackleaves the channel and shows an unread count inbadge.ChannelHeaderTitlemakes the channel name a button.ChannelHeaderSearchtakescompactfor an icon-only control. The HTML flavour addsnewt-channel-header__back,__back-badge,__title,__title-chevronand__search--compact. ChannelInfotakeslabel,modalandinline, and callsonClose(@closein Vue).
Five things change for existing code.
ChannelHeaderrenders adiv. It rendered aheader, which is a second banner landmark outsidemain,article,aside,navorsection. Passas="header"to keep the element.ChannelHeaderhas a minimum height of 48px in place of a fixed height, so a title with two lines fits.ChannelHeaderSearchhas noaria-label. Its text is its accessible name, so the name matches what a user sees.ChannelHeaderActionwithactiveset now carriesaria-pressed. Remove anaria-pressedof your own, and keep the label the same in both states.ChannelInfois now a dialog built on Radix Dialog (React) and Reka UI Dialog (Vue), so the item installsradix-uiorreka-ui. It still renders in place, with no portal and no overlay. When it mounts, focus moves into it, and Tab then cycles through its controls. Escape callsonClose, and focus returns when you unmount the panel. Addmodalwhen the panel covers the channel: the rest of the page is then hidden from assistive technology, focus cannot move to it, and a press on it callsonClose. If you renderChannelInfoas a side panel that is always on screen, addinline: it then has no dialog role and does not move focus. In the HTML flavour, the dialog behaviour needs the newchannel-info.jsand adata-newt-channel-infoattribute.
-
member-list,status-indicator,avatar,tabsandreply-previewgain new sizes, an interactive row and a defined list structure. Add the items again to get the changes.StatusDottakeslabel, the state in words, such as “Online”. A screen reader reads it, and it is not shown. In the HTML flavour, put anewt-status__labelspan inside the dot.- The ring of a status dot reads
--newt-status-ring, then--newt-bg-base. If the avatar sits on another surface, set--newt-status-ringto that surface. - A new
--newt-streamingtoken colours the streaming dot, withbg-newt-streamingon Tailwind v3 and v4. Runinitagain, or add the token to your stylesheet. Avatartakessize="xs"(16px) andsize="md"(32px). The HTML flavour addsnewt-avatar--xsandnewt-avatar--md.ReplyPreviewAvatarno longer needssrc. AsrcSet(srcsetin Vue) alone also draws the image. Without either, the avatar is a 16px circle that holds its children (the default slot in Vue), such as an icon. The HTML flavour addsnewt-reply__avatar--fallback.MemberListItemtakesinteractivefor a row that opens a profile. The row then renders a button inside the list item, with a pointer, a hover and a focus ring. Listeners, attributes and the ref land on the button. In React, an interactive row takes the attributes of a button, such asdisabled,nameandvalue.MemberListItemtakesdecoration(the#decorationslot in Vue), an underlay drawn behind the row. The hover is drawn over it.MemberListHeadingtakesas, fromh2toh6. The default staysh3.TabsListis never wider than its container. If the triggers do not fit, it scrolls sideways, and the triggers keep their width.
Four things change for existing code.
StatusIndicatorno longer hasrole="status". A member list made every row a live region with nothing to announce. Move anaria-labelfromStatusIndicatortolabelonStatusDot.MemberListItemhas no pointer and no hover by default, because a plain row does nothing. Addinteractiveto a row that opens something.- A heading is no longer a child of the list. Put a
MemberListinside eachMemberListSection, after itsMemberListHeading. The section links the two, so each list is named by its heading. Give aMemberListwith no section anaria-label. In the HTML flavour,.newt-member-listis now the list inside a section, witharia-labelledbypointing at the heading. MemberListSectionwithofflinenow dims eachrole="listitem"element, so it dims interactive rows too.
-
message-composertakes a field of your own, more slots and a narrow phone layout. Add the item again to get the changes.renderInput(React) and the#inputslot (Vue) replace the built-in input. They receivevalue,setValue,submit,disabledandinputProps. SpreadinputPropson your field to keep the label, the combobox attributes and the keyboard handling. Enter still submits, and the send button still follows the value.leading(#leadingin Vue) renders controls after the add button, before the field.showAddremoves the add button when it isfalse. It defaults totrue.trailing(#trailingin Vue) takes the place of the send button while the value is empty.disabledturns off the input, the add button and the send button.layout="narrow"is the phone layout: no frame, a pill field and round buttons. The HTML flavour addsnewt-composer--narrowandnewt-composer__button--narrow.messageComposerButtonVariantsis exported. Give it to a button you add, so it matches the built-in icon buttons. The item now installsclass-variance-authority.
One thing changes for existing code. The
actionsslot now renders inside the field, at its end. The bar looks the same. If your styles select the field by its position, remove them and userenderInputor#inputinstead. -
message-group,reply-previewandmessage-listnow draw a reply close to the message it answers. Add the three items again to get the changes.- With
withReply, the reply line sits 2px above the body of the message. It sat 20px above before. AReplyPreviewinsideMessageGroupReplyhas no margin and no start padding. - The spine of the preview starts above the centre of the avatar and stops 4px before the preview.
MessageGrouppublishes--newt-message-group-avatar-size(40px) and--newt-message-group-gap(16px), and the preview reads both. Set them on the row when the avatar has another size. Outside a group, the preview keeps its own elbow. ReplyPreviewCommandtakes an icon: theiconprop in React, the#iconslot in Vue, and the classnewt-reply__command-iconin the HTML flavour. The icon sits before the truncating label, so the gap of the chip applies. The chip sizes ansvgto 12px.- The new token
--newt-text-message(#dbdee1dark,#313338light) is the colour of message text.MessageGroupsets it on the row, andMessageGroupContenthas no colour of its own. A colour class on the row now changes the text colour of the message. MessageListpads every row inside it. A row inside a wrapper keeps its padding, also when the wrapper isdisplay: contents.
Four things change for existing code. Message text is brighter on dark surfaces and darker on light surfaces. Text in a row that sets no colour takes the colour of the row. A margin or start padding class on a
ReplyPreviewinside a group no longer applies, so change the distance with agap-y-*class on the row. If you drew your own spine, remove it. If you set agap-*class on the row, set--newt-message-group-gapin its place so the spine follows.newtui initleaves a stylesheet that already holds the tokens untouched. If you keep your token file by hand, add--newt-text-messageto both themes. Without the token, the row falls back to--newt-text-secondary, so message text keeps the colour it had. Thetext-newt-text-messageutility needs the token in your Tailwind theme:--color-newt-text-message: var(--newt-text-message)in@themeon Tailwind v4, or"text-message": "var(--newt-text-message)"in thenewtcolours on v3. The components do not use that utility, so they work without it. - With
-
initkeeps theindex.tsbarrels out of Nuxt’s component scan. Nuxt read each barrel as a second component and warned once per component folder (NUXT_B3011: Two component files resolving to the same name). In a Nuxt project,initnow adds acomponentsoption tonuxt.configthat ignores the barrels and keeps Nuxt’s default directories. The pattern follows theuialias incomponents.json.initedits only a config with one multi-linedefineNuxtConfig({call, nocomponentsoption and no top-level spread such as...sharedConfig. In every other case it prints the lines to add. If the project has nonuxt.configyet, it prints the file to create. If your project already raninit, add the option yourself: see the Nuxt installation guide. -
scrollbargains an overlay thumb, auto-hide and a focus ring.ScrollAreatakesvariant="overlay", which draws the thumb over the content so the box keeps its full width.--newt-scrollbar-inset-startand--newt-scrollbar-inset-endmove the ends of the track, and--newt-scrollbar-thumb-widthand--newt-scrollbar-thumb-max-heightsize the thumb.autoHideshows the thumb only on hover, on keyboard focus and while the area scrolls.scrollbarAutoHideClassNamedoes the same for an element of your own. The thumb colour reads--newt-scrollbar-thumband--newt-scrollbar-thumb-hover, and falls back to the colours it had.Three things change for existing code. A
focusableviewport now draws its focus ring inside its box, where anoverflow: hiddenancestor cannot clip it. The body ofapp-launcherand the list ofslash-command-suggestionsuse the styled scrollbar, so both items now installscrollbar. In React,ScrollAreamoves to a client component inscroll-area.tsx. The class strings move toscrollbar-classes.ts, so a Server Component can still use them.scrollbar.tsxexports both, so imports stay the same. The default variant isnative, so the scrollbar itself looks as it did. In the HTML distribution, the overlay thumb needs the newscrollbar.jsand adata-newt-scrollbarattribute. Add the item again to get the new files. -
select-menucan now draw a select as it appears under a message. Add the item again to get the changes.sideandalignplace the panel.side="top"opens it above the trigger, and it still flips when that side has no room. In the HTML flavour, setdata-side="top"on the root anddata-alignon the panel.triggerClassNameandcontentClassName(triggerClassandcontentClassin Vue) merge classes onto the trigger and the panel. Both parts carry adata-slot:select-menu-triggerandselect-menu-content.- An option takes
emoji, a unicode character drawn where the icon would be.iconwins when an option has both. renderItem(React) and the#itemslot (Vue) draw the content of a row.renderItemDescriptionand#item-descriptiondraw only the description. A row drawn withrenderItemor#itemnames its option with all of its text.- The trigger has
tabindex="-1"while the list is open, so an axe audit no longer reports it underaria-hidden-focus. Focus still returns to it on close. The other focusable elements of the page can still be reported; the docs page says why. - In the HTML flavour, mark the label of a row with
newt-select-menu__option-label. The script copies that text to the trigger. A row without the class still gives all of its text, as before. The script also copies thenewt-select-menu__option-emojiof a row to the trigger.
-
slash-commandandslash-command-suggestionshave real text separators and a layout that follows the picker. Add both items again to get the changes.- The text of a
SlashCommandis now/conf menu save key:prefix. A real space stands between two parts and a real colon follows each option name. A copy, a search andtextContentall give that text. The chip still draws each gap 4px wide. SlashCommandtakeschildrenin React and a default slot in Vue. The content follows the last option inside the chip, after a space.- The text of a
SlashCommandSuggestionis now/warn, with no non-breaking space. A margin on the slash draws the gap. SlashCommandAppIconsizes its first child whatever the element is. An icon component that renders a<span>now gets half the size of the circle, as an inline SVG does.SlashCommandSuggestionsFooteris a new part: a bar under the rail and the list, for the command being typed.- The width cap of the picker reads
--newt-slash-suggestions-max-width. The default is still 640px. Set it tononeto make the picker as wide as the composer. SlashCommandSuggestionsRailtakesorientation:"vertical"or"horizontal".- In a picker narrower than 480px, the rail becomes a row under the list, unless
orientationfixes it. A suggestion puts the app name beside the command name and gives the description the full width, on up to two lines.
Six things change for existing code.
- The chip is inline content and no longer a flex container. A class that relied on
gapor on a flex child no longer applies. - The colon is no longer generated by CSS. In the HTML flavour, write it in the markup:
<span class="newt-command__option-name">user:</span>. Write one space between two parts and none after the slash. - In the HTML flavour, wrap the slash of a suggestion in
newt-slash-suggestions__option-slashin place of/ . - The picker is a grid and a size container (
container-type: inline-size). Its width must not depend on its content, so keepw-fullor give it a width.flex-colon the picker has no effect now: the footer and a horizontal rail take their own rows. - A picker narrower than 480px changes layout as described above. Pass
orientation="vertical"to keep the rail beside the list. SlashCommandAppIconnow sets the size of a first child that is not an<img>, and that size wins over a size class on the child. Put text straight inside the icon, with no wrapper element.
- The text of a
-
A new
text-displayitem, and message parts that follow what a Components V2 message sends. Add the changed items again to get the changes.text-displayis a block of message text. It keeps the line breaks of its string (white-space: pre-line).sizetakesheading-1,heading-2,heading-3andsubtext, the#,##,###and-#sizes of theMarkdowncomponent.aspicks the element, soas="h3"makes a heading size a real heading. The HTML flavour isnewt-text-displaywith--heading-1,--heading-2,--heading-3and--subtext.Dividertakesspacing="small"(4px) andspacing="large"(8px), the two steps of a V2 separator.sm,mdandlgstill work. The HTML flavour addsnewt-divider--smallandnewt-divider--large.Buttontakes content before and after the label: theleadingandtrailingprops in React, the#leadingand#trailingslots in Vue, andnewt-btn__leadingandnewt-btn__trailingin the HTML flavour. Each sits in its own box, so an icon component or a unicode emoji gets the gap. Theemojiimage URL prop still works.Buttontakessize="message", 32px high, for a button in a message. The height is fixed, so a link button or an emoji image keeps the row aligned. The HTML flavour addsnewt-btn--message.Reactiondraws its emoji from its children in React and from its default slot in Vue, for an icon or an image component. The slot wins overemojiandemojiSrc. SetemojiAltto name it.formatLabelstill builds the accessible name. The HTML flavour addsnewt-reaction__emoji.InviteNametakesas, asButtondoes. PassNuxtLink,RouterLinkor another link component to keep client navigation. In React, the part takes the props of that component, such asto.EmbedAuthorIcon,EmbedFooterIcon,InviteIcon,MediaGalleryItemandSectionThumbnailtakeas, so you can pass an image component such asNuxtImg. In React, each part takes the props of that component. The spoiler ofMediaGalleryItemandSectionThumbnailstill works with it.
Three things change for existing code.
- An
Embedwith nocolordraws its bar in--newt-border, the same neutral default asV2Container. It used--newt-brandbefore. Passcolor="var(--newt-brand)"to keep the old bar. An explicitcolorworks as before. SectionThumbnailis 85px square. It was 86px.- A
Buttonwith no label renders no label box, so an emoji-only button has no extra gap after the emoji.
-
addanddiffnow warn when a component uses a theme name your project does not declare. Before, a class such asshadow-elevation-highorduration-fastproduced no CSS, and nothing said so. The CLI reads your stylesheet and the local files it imports, such as@import "newt.css". It lists each missing name and prints the block to paste:@themeentries on Tailwind v4,theme.extendentries on v3, and the raw--newt-*variables on both.The new
newtui tokenscommand appends that block for you. It adds only the missing names, so a second run writes nothing. Pass component names to limit it to what they use, and--dry-runto print the block without writing it. On Tailwind v3 it prints thetailwind.configentries instead of editing the file.The theme now maps
duration-fastandduration-baseon Tailwind v4 through--transition-duration-fastand--transition-duration-base. Earlierinitruns did not write them, so these classes had no effect on v4. Runnpx newtui tokensto add them. On Tailwind v3 the preset now readsvar(--newt-duration-fast)andvar(--newt-duration-base)instead of fixed values.Components now read their radii and their sans and mono stacks from the newt tokens, not from your Tailwind scale.
rounded-mdbecamerounded-[var(--newt-radius-md)], andfont-sansbecamefont-[family-name:var(--newt-font-sans)]; the same holds forsm,lg, the sided radii andfont-mono. Before, a host with its own scale restyled them: in an app with Nuxt UIrounded-mdis 12px, not 8px. Tailwind v3 compiled the default 6px. Both forms compile on Tailwind v3 and v4, and arounded-*orfont-*class you pass still wins. A newt/create preset’s radius and font now reach the components too. Runnpx newtui add <component> --overwriteto update installed components. To keep your own scale inside newt/ui, set--newt-radius-*and--newt-font-*to it, as the theming guide shows. -
Every name and text a component writes itself now comes from a prop. English stays the default, so nothing changes until you pass a translation. Add the changed items again to get the new props. The new Translating labels page lists every prop and its English default.
MessageComposertakeslabels:group,placeholder,addandsend.groupandplaceholderare functions of the channel name.defaultMessageComposerLabelsholds the English text.SlashCommandtakesformatLabel, which builds the chip’s name from the command path and the options.defaultSlashCommandLabelis the English default.AppLauncherItemtakespromotedLabelfor thePromotedbadge.MemberListAppTagandMessageGroupBotTagtakelabelandverifiedLabel. Anaria-labelonMessageGroupBotTagstill wins.SectionThumbnailandMediaGalleryItemtakespoilerLabel.EmbedTimestamptakeslocale,timeZoneandformatter.formatterwins over the other two.localedefaults toen-US, as before. Pass a fixed locale and time zone, so the server and the browser write the same text.TimestamptakestimeZone. It defaults to the zone of the runtime, as before.ThreadPreviewCounttakesformatCount.PinInputtakesformatCellLabelfor the name of each box.PermissionStatestakeslabelswithdeny,inheritandallow.EntitySelecttakesemptyLabel.FileUploadtakespromptandbrowseLabel.ExpressionsPickertakeslabelsfor every name and text it writes.defaultExpressionsPickerLabelsholds the English text.unavailablebuilds the name of an item you cannot choose from its label.- In the HTML flavour,
tag-input.jsreadsdata-newt-remove-labelfrom the field, with{tag}for the chip’s text.token-field.jsreadsdata-newt-reveal-label,data-newt-hide-labelanddata-newt-copied-label.expressions-picker.jsreads alabelsobject from its JSON data, with{label}inunavailablefor the item’s name.
One thing changes for existing code. In Vue,
expressionKindsis now a list of kinds, and the entries ofskinTonesno longer carry alabel. Read the names fromdefaultExpressionsPickerLabelsinstead.
@newtui/nuxt 2.0.0
-
Register
components/uibefore Nuxt scanscomponents/. Nuxt gives a file to the first directory that scans it, so the module registered nothing: components stayed<UiButton />, and eachindex.tsbarrel caused aNUXT_B3011duplicate name warning. The components are now<Button />(or<NewtButton />withprefix: "Newt"), as the documentation says, and the warnings are gone. If your templates use theUinames, rename them or remove the module. -
The token stylesheet of the module now declares
--newt-streamingand--newt-text-message. The streaming dot ofstatus-indicatorkeeps its colour, and message text inmessage-grouptakes its own colour. No change is needed in your project.