Track B

React

This is the package the public site is built from. Everything below is the real component, imported from @id-identity/ui and rendered by this page. Nothing here is a screenshot or a copy of the markup, so a specimen that stops working stops the build.

The tracks swapped roles in D98. What a visitor reads, browses and is convinced by is React; what the commerce engine owns, meaning carts, prices and the order lifecycle, stays in DynamicWeb. The Razor partials for that half are catalogued separately, and the two sets answer to the same tokens and the same rules.

Components

85

counted from the package source

Entry points

19

counted from package.json

Version

0.2.0

installed by tag

Looking for the other half? The Razor catalogue holds the partials DynamicWeb renders behind the transaction.

How to install it

The package is consumed from a git tag, and its built output is committed like every other generated artifact here. A consumer loads the token stylesheet, extends Tailwind from the shipped theme, and imports from the entry point it needs.

"@id-identity/ui": "github:klhpicture-jpg/id-partner-room#ui-v0.2.0&path:packages/ui"

Seven of those entry points ship a use client directive and the rest do not. That split is asserted on every build by pnpm pack:check, which installs the tarball into a stricter consumer than this repo and typechecks it, because a component that silently becomes a Server Component fails at the first piece of state and says nothing on the way.

@id-identity/ui@id-identity/ui/layout@id-identity/ui/product@id-identity/ui/commerce@id-identity/ui/sections@id-identity/ui/chrome@id-identity/ui/buy@id-identity/ui/form@id-identity/ui/overlay@id-identity/ui/Icon@id-identity/ui/icons@id-identity/ui/image-contract@id-identity/ui/IDLogo@id-identity/ui/ProductImage@id-identity/ui/CopyLinkButton@id-identity/ui/PrintButton@id-identity/ui/data@id-identity/ui/data/charts@id-identity/ui/tailwind

Primitives

The pieces an application is assembled from: surfaces, actions, status chips, waiting states and the empty case. Token utilities only, and no import from any host app, which is what makes the package portable.

import { Button, Badge, Card } from '@id-identity/ui'

ButtonFive variants, two sizes.
Button pendingaria-busy, never disabled: a disabled submit is dropped from the form data along with the cart command.
NeutralIn progressApprovedAwaiting approvalRejected
BadgeThe quiet B2B status family.
ActionsTwo actions that share a moment.

Order 41028

Awaiting approval

Placed 28 August by Mette N.

2 lines

Card is a surface. It carries no domain knowledge, which is why an order, a budget and a user list can all sit in one.

Card, CardHeader
Skeleton, SkeletonTextA placeholder earns its place only when it has the shape of what replaces it.

Recalculating basket total

PendingNoteA wait that belongs to a region.

Open orders

12

Across 3 sites

StatCard

No orders yet

Orders placed by your colleagues appear here once approved.

EmptyStateThe title is a heading, so it lands in the page outline.
PRO Wear T-shirt
ProductImagePlaceholder

CardCardHeaderBadgeActionsButtonSkeletonSkeletonTextPendingNoteStatCardEmptyStateProductImagePlaceholder

Layout

Page structure as components rather than as remembered class strings. Width, rhythm, the twelve-column grid, and the type roles that go with them. A heading level and a type step are separate props on purpose: an h2 is allowed to look small.

import { Container, Stack, Heading, Text } from '@id-identity/ui/layout'

Workwear that lasts

A shirt is a uniform for four years, not a season

Text with measure caps the line length so a paragraph stays readable. It reads from the same type scale as everything else, which is why a rebuild of the tokens moves this sentence too.

The typography rules
Heading, Eyebrow, Textlevel sets the outline, step sets the size.
span 4
span 4
span 4
GridTwelve columns, named spans.

Section carries the band, Container carries the measure. Nesting them is how every page on the public site is built.

Section, ContainerTone and width in one.

A full-bleed band inside a measured column.

BleedEscapes the container without leaving the grid.

ContainerBleedStackGridSectionHeadingTextEyebrowLink

Product

A card is not always buyable and a price is not always there. State suppresses the buy affordance and joins the link's accessible name, so nobody discovers on arrival that the garment is gone. B2B prices need a login, so an absent price is a state rather than an empty string.

import { ProductCard, ProductGrid, ProductGridItem } from '@id-identity/ui/product'

  • View product
    PRO Wear T-shirtNew

    PRO Wear T-shirt

    No. 0300

    kr. 139,00 (kr. 111,20 excl. VAT)

  • View product
    GEYSER active T-shirtCampaign

    GEYSER active T-shirt

    No. G21000 · S to 4XL

    kr. 159,00 (kr. 127,20 excl. VAT) Previous price kr. 189,00

  • View product
    SEVEN SEAS Flannel unisex

    SEVEN SEAS Flannel unisex

    No. S64

    Sold out · request a notification on the product page

  • View product

    Without a price

    No. 0510

    From kr. 189,00 (from kr. 151,20 excl. VAT)

    Volume pricing from 10 units

Third card: sold out, so the quick-buy slot is suppressed and the link reads "SEVEN SEAS Flannel unisex, No. S64, sold out". Fourth: no image, a From price with a volume note. Hover the first card for the quick-buy reveal.

New products

The heading states why these products (D49); "Selected products" is a shrug.

View all

ProductCardProductGridProductGridItem

Commerce furniture

Everything a product surface stands on that is not the card: prices with commercial context, stock as shape and word, filters as links, tables built for 200 rows, and the seam pieces around a buy. Each is its Track A partial's contract, classes verbatim.

import { DealerPrice, StockIndicator, FilterBar } from '@id-identity/ui/commerce'

kr. 139,00(kr. 111,20 excl. VAT)

kr. 119,00(kr. 95,20 excl. VAT)Previous price kr. 139,00Spar kr. 20,00

kr. 94,52kr. 139,00-32%Your net price excl. VAT

Price on requestRequest a price for the selected quantity and customization.

DealerPriceWho you are decides which number leads: public, campaign, dealer, request.

In stock· 1.240 units

Low stock· under 50 units

Sold out

Backordered· expected week 40

Discontinued

StockIndicatorFive states; sold out is a hollow ring, so the dot survives greyscale.

No. 0300 · PRO Wear T-shirt

  • EN ISO 20471 · Class 2
  • OEKO-TEX® STANDARD 100
  • Industrial wash 60 °C
ArticleNumber, CertBadgeRow
Volume pricingAll prices are per unit excl. VAT. The discount is calculated automatically.
1 to 9 unitskr. 111,20
10 to 49 unitskr. 103,40(your current price tier)
50 to 99 unitskr. 97,80
VolumePriceTableTiers stated before the till; the current tier marked, never celebrated.
BreadcrumbThe current page is not a link; JSON-LD comes from the same trail.

42 of 270 products

FilterBar + FilterPanelEvery filter change is a link; a zero-count value stays visible as text.
Order lines
Item no.ProductQuantityPrice excl. VAT
No. 0300PRO Wear T-shirt, navy240kr. 26.688,00
No. S64SEVEN SEAS Flannel unisex48kr. 14.352,00
TableHairlines, mono headers, tabular numerals.

Cart updated

PRO Wear T-shirt, navy, XL. Quantity changed from 24 to 48.

Go to cart

FlashMessageNot a toast: in flow, until the next navigation.

Add kr. 339,40 excl. VAT to reach the free-shipping threshold. Otherwise kr. 49,00.

FreightProgressArithmetic, never pressure.
Size
SizeChoiceRectangles choose, pills act (D30). Native radios; the chip is the label.
Body measurements, men
SizeChestWaist
M9686
L10492
XL11298
SizeGuideTableThe size column is sticky; nothing hidden, nothing stacked.
PaginationA list of links; the greyed edge is not a disabled button.

ArticleNumberCertBadgeRowStockIndicatorDealerPriceVolumePriceTableBreadcrumbPaginationShowMoreTableFilterBarFilterPanelSortSelectFlashMessageFreightProgressSizeGuideTableSizeChoiceNotifyMeBuyBarSearchSuggest

Sections and chrome

The editorial furniture a content page is composed of, and the navigation that carries it. Hero, Footer, Navigation and CookieConsent are full-bleed surfaces; the two band pieces below render live, and the rest are proven by the same jsdom and axe suite as everything else.

import { Hero, StatsBand, Footer } from '@id-identity/ui/sections'

GarmentStripThe category streets under the hero: links only.

Example figures

Workwear for the task.

Find a dealer
43
Example data: company history
6XL
Example data: stocked size range
100%
Example data: test coverage
StatsBandThe inverse statement band; figures in the sans with tabular-nums (D53).

HeroHeroMediaEditorialSplitEditorialMediaStatsBandGarmentStripNewsletterSignupFooterErrorPageCookieConsentNavigation

Buying

The two client pieces of a purchase. The stepper wraps a real native number field, so it posts like any form control and a dealer can type 48; the quick-buy drawer is a native form, deliberately not a mini PDP.

import { QuantityStepper, QuickBuy } from '@id-identity/ui/buy'

Quantity

Quick buy

Quick buy

No. 0300

PRO Wear T-shirt

kr. 139,00 (kr. 111,20 excl. VAT)

Size
Quantity

QuantityStepperQuickBuy

Forms

An autocomplete token is required by the type system, which is this system's version of the autocomplete rule: a checkout field that a browser cannot fill is a field a customer types wrong. Optional fields are marked, required ones are not, and the error summary is the first thing focus lands on after a failed submit.

import { Input, Select, ErrorSummary } from '@id-identity/ui/form'

The microcopy the components supply themselves is Danish: (valgfrit) on an optional field and Der er noget at rette above the error summary. That is deliberate for a Danish-market shop and it is also the part that has to become translatable before the package ships a second language. Every string a page passes in is the page's own, which is why the labels below are English.

Eight digits, no spaces.

Enter an email address, for example mette@firma.dk

InputRequired, with a helper, and in error. Only the optional ones carry a mark.

Optional. Reaches the driver, not the warehouse.

Select, Textarea
Delivery (optional)
Checkbox, RadioGroup
ErrorSummaryRendered above the form, focused on submit, every message a link to its field.

FormFieldInputTextareaSelectCheckboxRadioGroupErrorSummary

Overlays

Dialog and Drawer are the native dialog element, so the focus trap, the Escape key and the top layer come from the platform rather than from a library. Tabs is hand-written to the ARIA pattern with a roving tabindex, because a tab set is small enough that a dependency costs more than it saves.

import { Dialog, Drawer, Tabs } from '@id-identity/ui/overlay'

Confirm the order

Quantities can still be changed afterwards.

The focus trap, the Escape key and the top layer come from the platform. Try tabbing: focus cannot leave this box.

Filters

The same native dialog, against an edge. This is what the mobile navigation and the filter panel are both built from.

60 % cotton, 40 % polyester, 210 g/m². Arrow keys move between tabs; Home and End jump to the ends.

DialogDrawerTabs

Data

Tier 0 is layout and stays CSS on every surface: a stat tile, a bar list, note boxes, an empty state. Tier 1 needs a scale or an axis and goes to Recharts. Colour follows the entity and never the rank, series order is fixed, and data never animates.

import { StatCard, BarList, Callout } from '@id-identity/ui/data'

Reorder rate

68 %

+4 pp compared with the previous quarter

Example data

StatCardFrom ./data: delta, basis, sparkline.
Top articlesWeek 35 · pieces
  • PRO Wear T-shirt1.425
  • GEYSER active T-shirt980
  • SEVEN SEAS Polo610
  • Other340
View as table
Top articles as a table
NamepiecesShare
PRO Wear T-shirt1.42542%
GEYSER active T-shirt98029%
SEVEN SEAS Polo61018%
Other34010%
BarList
CalloutFive variants, role=note.

No orders in this period

Widen the date range, or check whether the site has ordered under a different account.

Clear the filter
EmptyStateFrom ./data: icon in flow, one exit.
Pieces shippedExample data, five weeks
View as table
Data table, unit: pieces
PeriodT-shirtsPolos
Week 311.240820
Week 321.310795
Week 331.180910
Week 341.425980
Week 351.3901.040
TimeSeriesChartRecharts, fixed series order.
Size runExample data, article 0300
View as table
Data table, unit: pieces
Periodpieces
S210
M480
L520
XL390
2XL180
CategoryBarChartOne axis, always.

StatCardBarListCalloutEmptyStateChartFrameTimeSeriesChartCategoryBarChartSERIES

Single-purpose entry points

Seven small modules that would each drag a dependency or a client boundary into a bigger file. Importing them one at a time is how a server-rendered page stays server-rendered.

import { Icon } from '@id-identity/ui/Icon'

IconA named icon from icons/icons.json. Decorative by contract, so an icon-only control carries its own label.
ID Identity
IDLogo
PRO Wear T-shirt

0300

PRO Wear T-shirt

ProductImageClick opens a native lightbox dialog.
CopyLinkButton, PrintButtonBoth client components, both with a real failure path.
Master
800 x 867
Ratio
0.923
image-contractMeasured from all 28 files in the catalogue, so the browser reserves the right box before the bytes arrive.

IconICONSIDLogoProductImageCopyLinkButtonPrintButtonMASTER

Track parity, measured

Every Track A partial has an answer here, and CI fails when this claim and the code disagree: the map lives in foundations/parity-map.json, and pnpm parity checks that each matched component actually exists. Razor keeps only what the commerce engine owns (D98).

Matched

A React component carries the partial contract, classes verbatim.

  • article-number
  • badge
  • breadcrumb
  • button
  • buy-bar
  • callout
  • card
  • card-grid
  • cert-badge-row
  • chart-bar
  • chart-donut
  • chart-plot
  • cookie-consent
  • dealer-price
  • dialog
  • drawer
  • editorial-split
  • empty-state
  • error-page
  • error-summary
  • filter-bar
  • filter-panel
  • filter-select
  • flash-message
  • footer
  • form-field
  • freight-progress
  • garment-strip
  • hero
  • navigation
  • newsletter-signup
  • notify-me
  • pagination
  • product-card
  • product-rail
  • quantity-stepper
  • quick-buy
  • search-suggest
  • size-guide
  • stat-card
  • stats-band
  • stock-indicator
  • table
  • tabs
  • volume-price

Composed by the app

Page recipes assembled from matched pieces; the composition is the page's.

  • custom-wear
  • dealer-locator
  • design-paths
  • home
  • industry-page
  • job-mosaic
  • pdp
  • product-grid
  • related-products
  • search-results
  • seo-meta
  • seo-product

Stays Razor (D98)

Cart, checkout, account and the order lifecycle live where the engine lives.

  • account-shell
  • account-users
  • address-book
  • address-select
  • cart
  • checkout
  • designer-shell
  • invoice-list
  • login
  • order-confirmation
  • order-detail
  • order-history
  • order-summary
  • order-timeline
  • quantity-matrix
  • returns-request
  • sign-in-prompt

74 partials45 matched12 composed by the app17 stay Razor

What proves this page

A gallery is a claim. These are the checks that make it one you can rely on, and all of them run in CI on every change.

  • Every component above is rendered in jsdom and checked with axe. The suite asserts behaviour and structure, never appearance, because jsdom has no layout engine and a test that claims otherwise is lying.
  • The package is packed into a tarball and installed into a consumer with stricter TypeScript settings than this repo uses, then typechecked. That step is the only one that proves someone outside this repository can install it.
  • Every utility class here resolves to a token in both Tailwind 3 and Tailwind 4. An unknown class compiles to nothing without a word of warning, so the bridge check compiles a real fixture and reads the CSS.

pnpm testpnpm pack:checkpnpm tw4pnpm check:brandpnpm tokens