Skip to content
Razor catalogue

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.

Try date table toast form layout Press Ctrl K anywhere

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.

React portals
@webority/ui-react
Install
npm install @webority/theme @webority/ui-react
Use it
import { AppButton } from "@webority/ui-react";

<AppButton>Save invoice</AppButton>
Razor sites
Webority.Ui.Razor
Install
dotnet add package Webority.Ui.Razor
Use it
@addTagHelper *, Webority.Ui.Razor

<app-button>Save invoice</app-button>

The packages

PackageVersionRegistryWhat it is
@webority/theme0.165.0npmThe SCSS design system: the --wui-* tokens and all component CSS. Both surfaces load this same stylesheet.
@webority/ui-react0.165.0npmThe React components: the App* primitives (AppButton, AppSelect and the rest) used in every customer portal.
@webority/ui-elements0.165.0npmFramework-agnostic <wui-*> web components: the shared behaviour engine for the hard interactive controls. Internal: you never write these directly.
Webority.Ui.Razor0.165.0NuGetThe 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.

Full changelog

Breaking Resizable 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)
Breaking Theme A page that passes an attribute a tag helper does not declare and would silently drop (for example a misspelt 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)
Breaking Chart 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)
Breaking Popover <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)
Breaking DataTable Row actions are one list. 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)