WEBORITY UI
One set of parts for every Webority screen
Search by name, by prop, or by what you need to do. 155 components in 10 groups.
webority-ui is the shared Webority design system: one set of design tokens and one component catalogue, published as public packages and consumed by every product. The customer portals are built in React, and the marketing and admin sites in Razor Pages. A control exists once in the library; every product gets it, and every improvement to it, by version bump. Nothing is restyled or re-implemented per product.
Install
Pick your surface. Both load the same theme and render the same markup.
npm install @webority/theme @webority/ui-reactimport { AppButton } from "@webority/ui-react";
<AppButton>Save invoice</AppButton>dotnet add package Webority.Ui.Razor@addTagHelper *, Webority.Ui.Razor
<app-button>Save invoice</app-button>The packages
| Package | Version | Registry | What it is |
|---|---|---|---|
@webority/theme | 0.165.0 | npm | The SCSS design system: the --wui-* tokens and all component CSS. Both surfaces load this same stylesheet. |
@webority/ui-react | 0.165.0 | npm | The React components: the App* primitives (AppButton, AppSelect and the rest) used in every customer portal. |
@webority/ui-elements | 0.165.0 | npm | Framework-agnostic <wui-*> web components: the shared behaviour engine for the hard interactive controls. Internal: you never write these directly. |
Webority.Ui.Razor | 0.165.0 | NuGet | The Razor Class Library: the <app-*> tag helpers used in marketing and admin sites, mirroring the React API. |
One component, two spellings
Same component, same name, same props: only the spelling changes with the surface. React uses PascalCase components with camelCase props; Razor uses kebab-case tag helpers with kebab-case attributes.
// React (a portal screen)
<AppButton leftIcon="plus">Add member</AppButton><!-- Razor (a .cshtml page) -->
<app-button left-icon="plus">Add member</app-button>Both render the same markup, styled by the same theme CSS. The hard interactive controls (the select with its search, multiple, tag and country modes, the phone field and the date picker) share one implementation (the internal <wui-*> element underneath), so keyboard behaviour, accessibility and visuals cannot drift between surfaces.
Where to start
- Start with Choosing a component: pick by the need, not the look.
- Then open the component's page: overview, live examples, when-to-use guidance, do and don't, and the full props table.
- The rules that keep every product consistent: you only ever write
App*(React) or<app-*>(Razor), never the internal<wui-*>; never hand-roll what the catalogue already has; visuals come from the theme tokens, never per-product hex values.
Browse by group
Every group opens to its components, with live examples first.
Recent changes
Version 0.165.0. Every change names the component it touches.
AppResizable, AppResizableHandle, AppResizablePanel, AppRollingNumber and AppRowSwitch, the Razor tags <app-resizable>, <app-resizable-handle>, <app-resizable-panel>, <app-rolling-number> and <app-row-switch> (with AppRollingNumberFormat), and the elements <wui-resizable> and <wui-rolling-number> (with @webority/ui-elements/elements/resizable and @webority/ui-elements/elements/rolling-number) are removed with no successor. Consumer edit: delete the use; webority upgrade 0.165.0 flags each one and rewrites nothing. Still used in: none (an rg for the old names across every checkout under ~/Code finds no use outside the library's own sandboxes and generated kit releases). (TASK-25441)
labels on <app-nav-link>) now fails the build with WUI002 naming the attribute and the attributes the tag takes. 97 tags are checked: those whose helper rebuilds its markup and does not forward unbound attributes. Consumer edit: remove or correct the attribute the message names; no codemod ships because an rg over the product and library checkouts under ~/Code found no page that this breaks. (TASK-23744)
AppChart and AppChartCard type the chart number format. The format of series, x, y and size takes only its known fields (style, currency, unit, decimals, pattern), each with its closed set of values, and @webority/ui-react exports the ChartFormat type; the Canvas manifest lists the same fields, so a design check catches a misspelt key. A format written inline in the prop still compiles. A series, axis or format kept in a variable or built by a .map no longer does, because TypeScript widens { style: "number" } there to style: string. Consumer edit: type that variable or map result with ChartFormat (for example format?: ChartFormat). No codemod ships: an rg for AppChart with a format literal across the product and library checkouts under ~/Code finds one hit, webority-chat packages/chat-react/src/renderers/ChartPart.tsx:37, which moves by hand in its next release. (TASK-24164)
<app-popover> no longer adds the app-popover class, so its root is transparent as AppPopover's is. A page that sets a layout class on <app-popover> moves it to the trigger; the one hit in the checkouts is webority-support Ticket.cshtml (class="ms-1"). (BUG-26985)
AppDataTable rowActions returns a list of actions ({ key, label, icon, iconVariant, onClick, href or to, tone, disabled, disabledReason, menuOnly, showLabel }) instead of buttons, drawn by the new AppRowActions: icon buttons from sm up and one "More actions for <name>" menu below it. Entries that are false, null or undefined are skipped, so canEdit && { ... } leaves an action out; a to goes through the table's new linkComponent. A rowActions that returns anything but a list throws a TypeError naming the codemod. <app-row-actions> takes only <app-row-action> children (label, icon, icon-variant, href, tone="Danger", disabled, disabled-reason, menu-only, show-label) instead of free markup. Consumer edit: run node scripts/codemods/row-actions.mjs <folder> --check to list every block, then without --check to rewrite the Razor ones; a Razor block holding a form, partial or badge, every React rowActions and every className="u-row-actions" is reported for a person to restate as a list. An rg for rowActions={ and <app-row-actions across the product and library checkouts under ~/Code finds 279 hits: webority-os 135, csd-icsds 84, capnix 23, lumex 12, keystone 7, lexa 7, the libraries 7, ensemble 2, foodme 1 and orientbell-tile-talk 1. (TASK-25470)