Skip to content
Uventex Care · design system v2

Build it like uventex.com

Every customer-facing surface — help center, portal, messenger, emails, request page — should feel like part of uventex.com. These are the tokens and components to do it, measured from the live site. Agents' desk uses the same tokens in a denser layout.

<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Roboto:wght@400;500;700;900&display=swap">
<link rel="stylesheet" href="/assets/uventex.css">      ← tokens + components (required)
<script src="/assets/icons.js"></script>               ← uvIcon('name'), <i data-uv-icon="name"> (optional)
<script src="/assets/uv-ui.js" defer></script>         ← UvUI.toast / confirm / dialog / tabs (public pages)
<script src="/assets/site-chrome.js" defer></script>   ← uventex.com header + footer (public pages)
  • Never hard-code a brand color — use the variables below (var(--uv-blue), var(--uv-gradient)…). Prefer the semantic aliases (--uv-text, --uv-border, --uv-card) in new code: they flip in dark mode.
  • v1 classes are stable (.btn .card .pill .input .field .avatar .tag .muted .empty). Everything added in v2 is uv--prefixed or a modifier on a v1 class, so it can't collide with desk.css.
  • Module-specific CSS goes in modules/<name>/public/*.css, prefixed with your module name. If you build something reusable, tell the design owner so it moves here.
  • Works at 375px. Test with the browser at phone width before you ship.

The uventex.com look

What makes a page read as Uventex (measured on uventex.com, full table in docs/sessions/design.md):

  • Page background #F2F5F6, white cards with 16px radius, soft shadow --shadow-card, 16px gaps.
  • Big headings in the display font, dark #23262F, second word in the blue→lime gradient: Explore Events.
  • Dark header #1B1B1B with white wordmark; dark footer.
  • One gradient pill per screen for the main action; white buttons with a thin gradient border inside cards; near-black #333 for everything else.
  • Small grey pill chips for meta ("5 days left"), blue line icons for dates/places.
  • New brand colors, purple gradients, drop-shadow-heavy cards.
  • Gradient on body text, on more than one or two words, or on several buttons at once.
  • Blue full-width headers on inner pages (uventex.com is blue only over the home hero).
  • Emoji as icons in product UI; stock photos of athletes (use real logos or nothing).
  • Browser alert() / confirm() — use UvUI.confirm() or UVX.modal().

Color

Click a swatch to copy its variable. Values are read live from the stylesheet.

Brand

Gradients

Neutrals

Feedback

Ticket status

Contrast: body text #404040 on white is 10.4:1; --uv-muted is 3.5:1 — use it for secondary info at ≥13px, never for the only copy of important text. White on --uv-blue is 3:1 — fine for 16px+ bold buttons, use --uv-blue-700 for small blue text.

Typography

Roboto for UI and body (load it from Google Fonts as above). Display (--font-display: SF Pro Display on Apple, falls back to Roboto) for page titles and hero headlines — exactly like uventex.com.

.uv-display · 64/700
Transform passion
.uv-page-title · 48/700
Explore Events
.uv-h1 · 36/700
How can we help?
.uv-h2 · 28/700
Registrations & payments
.uv-h3 · 22/700
Request a refund
.uv-h4 · 16/700
Card and section titles
.uv-lead · 16/400
Lead paragraph and public body copy.
body · 14/400
Desk body text — tables, forms, threads.
.uv-small · 13
Meta, timestamps, helper text
.uv-eyebrow · 12/700
Section eyebrow
.uv-kbd / .uv-code
⌘ K   support+abc@uventex.com

Tokens: --fs-2xs 11 · --fs-xs 12 · --fs-sm 13 · --fs-base 14 · --fs-md 16 · --fs-lg 18 · --fs-xl 22 · --fs-2xl 28 · --fs-3xl 36 · --fs-4xl 48 · --fs-5xl 64, weights --fw-regular … --fw-black, line heights --lh-tight 1.1 · --lh-snug 1.3 · --lh-base 1.5 · --lh-loose 1.7. Use 16px for public pages (uventex.com body size) and 14px in the desk. Inputs on mobile must be ≥16px or iOS zooms.

Spacing & radius

4px grid. Card padding 16 (desk 14–18), section gaps 24–48, page gutters 16 (mobile) / 24.

--r-xs 4
chips, kbd
--r-sm 6
small buttons
--r 8
buttons, inputs
--r-lg 12
desk cards
--r-xl 16
public cards
--r-2xl 24
big panels
--r-pill

Elevation & motion

--shadow-1
desk cards
--shadow-card
public cards
--shadow-card-hover
--shadow-2
menus, toasts
--shadow-3
dialogs

Motion: --dur-1 120ms (hover), --dur-2 200ms (popovers, toasts), --dur-3 320ms (drawers, sheets), easing --ease. Everything respects prefers-reduced-motion. Layers: --z-header 40 · --z-dropdown 45 · --z-dialog 50 · --z-toast 60 · --z-tooltip 70 (the messenger widget sits above all at 2147483000).

Icons

Line icons, 24px grid, 2px stroke, round caps — same style as the desk's UVX.icon(). Load /assets/icons.js; in the desk every icon here is also registered via UVX.icon_add (the desk's own drawings win on name clashes). Click to copy the name.

Inline: <span data-uv-icon="trophy"></span> or el.innerHTML = uvIcon('trophy', 'uv-icon lg')
ICON:calendarICON:sparklesICON:awardICON:headset

Buttons

.btn is near-black (#333) — the default, like uventex.com's Sign in. Use one .btn.gradient pill per screen for the main public action. .btn.outline-gradient is the "Join now" card button. Destructive actions are .btn.danger, confirmed with a dialog.

  • Label = verb + object ("Send reply", "Create article"). Icon buttons need aria-label.
  • Add .is-loading + disabled while a request is in flight — this also prevents double submits.

Forms

Wrap each control in label.field (v1: uppercase label) or label.field.plain (sentence-case — use on public pages). Hints and errors go under the input; mark invalid inputs with aria-invalid="true".

ICON:upload
Drop files here or click to attach (PNG, JPG, PDF · 10 MB)

Search

  • Every input has a visible label (placeholder is not a label). Use autocomplete on email/name.
  • Spam honeypot fields: <input class="uv-hp" name="website" tabindex="-1" autocomplete="off">.

Tabs & segmented

.uv-tabs for page sections (gradient underline). .uv-tabs.pills for filters. .uv-seg is uventex.com's Current / Past toggle. Wire behaviour with UvUI.tabs(el) (arrow keys + ARIA).

Conversation panel

Badges, chips & status

newopenpendingon-holdsolvedclosed UrgentHighNormal
DefaultICON:mail EmailAAUHealthySLA in 25mBreachedVIPNewtag refund 5 days leftLive 1237
  • Status = .pill.st.st-{status} (dot + tint). The desk's tickets owner may extend it; these six are the canonical colors.
  • Don't rely on color alone — the status text is always visible.

Avatars

MJPRMKTG ICON:botADGT JO MJP+4

Pick .av-1…8 from a stable hash of the user id/email so a person keeps their color everywhere.

Cards & surfaces

.uv-card is the uventex.com card (radius 16, soft shadow, 16px padding) — use on public pages. .card (v1, radius 12 + border) stays the desk card. .uv-panel is the big light container ("Explore Uventex").

ICON:ticket

Registrations

Sign up for events, divisions, waivers.

ICON:membership

AAU memberships

Buy, renew, print your card.

Period
Sep 1, 2026 – Aug 31, 2027
First reply (median)
42m
▲ 18% faster than last week

Explore Uventex

Big content panel — #F7F9FA, radius 24, padding 48.

Still need help?

Chat with our team or send us a request — we usually reply within a few hours.

Tables

Wrap in .uv-table-wrap (rounded, scrolls horizontally). Add .stack + data-label on cells so rows become cards under 640px. Numbers: .num. Sortable headers: aria-sort.

RequestStatusUpdatedReplies
#1042 · Charged twice for Coastal Classicopen2h ago3
#1039 · Can't find my AAU cardpendingYesterday1
#1017 · Change division for my sonsolvedNov 25

Dialogs

On public pages use UvUI.dialog / confirm / alert (/assets/uv-ui.js): focus trap, Escape, focus restore, aria-modal, bottom sheet on phones. In the desk use UVX.modal(); for custom markup the classes are below.

if (await UvUI.confirm({ title: 'Cancel this request?', body: 'We will stop working on it.', ok: 'Cancel request', danger: true })) { … }
const d = UvUI.dialog({ title: 'Rate your experience', body: formEl, actions: [{ label: 'Skip', value: null }, { label: 'Send', value: 'send', primary: true }] });
const choice = await d.result;

Toasts & alerts

Toasts confirm something that just happened (auto-hide, aria-live). Alerts explain a state on the page (persist). Banners are site-wide.

ICON:info
We usually reply within 4 business hours. You'll get an email when we do.
ICON:check-circle
Your request #1042 was sent.
ICON:alert-triangle
Registration closes in 2 days.
ICON:alert
We couldn't send your message. Check your connection and try again.
ICON:lock
Internal note — customers never see this.
ICON:sparkles
AI off — demo. Suggestions come from templates until an API key is set.
Local mock-up for testing Uventex Care — not the real site. Open the desk

Empty states & loading

Every list needs an empty state that says what goes here and the next step. Show skeletons (not spinners) for content that has a known shape; spinners for actions.

ICON:inbox

No requests yet

When you contact Uventex support, your conversations show up here.

ICON:search

No results for “refnd”

Try fewer words, or ask us.

Loading your requests…

Put aria-busy="true" on the region while loading and role="status" / aria-live="polite" on text that updates.

Article content

Wrap rendered Markdown (help-center articles, KB previews, email previews) in .uv-prose. Headings get anchor offsets for the sticky header.

Request a refund

Refunds are set by each event organizer. Uventex processes them once the organizer approves. See refund policies.

  1. Open My registrations.
  2. Choose the event and select Request refund.
  3. Pick a reason and submit.
Processing fees are non-refundable unless the event is cancelled.
WhenRefund
More than 14 days beforeFull, minus fees
Within 14 daysOrganizer decides

Your reference looks like UVX-104233.

Public header & footer

Every public page (help center, portal, request page, developers) uses the uventex.com header and footer. Easiest: placeholders + /assets/site-chrome.js. Inner pages use the dark header (uventex.com is blue only over the home hero).

<header data-uv-site-header data-product="Help Center" data-active="help"></header>
<section class="uv-hero compact"><h1>How can we <em>help?</em></h1> …search… </section>
<main class="uv-container"> … </main>
<footer data-uv-site-footer></footer>
<script src="/assets/site-chrome.js" defer></script>
// data-active: help | portal | events | memberships | studios | rankings
// data-user='{"name":"Jordan Lee"}' shows the signed-in name; data-signin="false" hides Sign in; data-variant="blue" for home-style
// data-nav="minimal" keeps only Help center + My requests. Re-render after changes: UvSiteChrome.render()
Uventex help center

How can we help?

Messenger

The widget renders in a shadow DOM, so it can't use this stylesheet — it mirrors these values: launcher and header #1B1E1F with a 3px --uv-gradient bar, panel radius 16, cards like .uv-card, user bubbles --uv-blue, bot avatar .avatar.bot, chips like button.uv-chip. Page integration:

<script src="https://support.uventex.com/widget.js" defer></script>
UventexCare('identify', { userId, email, name, role, club, userHash })   // signed-in uventex.com user
UventexCare('open')  ·  UventexCare('ask', 'How do I renew my AAU membership?')

See it live on the uventex.com mock-up (toggle "Signed-in demo").

Emails

Email clients ignore external CSS and variables — inline these literal values (they match the tokens):

Canvas / card#F2F5F6 background, white 600px card, radius 16, 1px #E3E8EA border
WordmarkEmail clients can't show SVG — use the PNGs (448×88, show at width="112" height="22"): /assets/uventex-logo-email-dark.png on white, /assets/uventex-logo-email-white.png on #1B1B1B. Absolute URL from PUBLIC_URL; alt="Uventex". Uventex
HeaderWhite header with the dark wordmark, or #1B1B1B bar with the white one; 4px gradient strip #01A1DA → #CDD620 (solid #01A1DA fallback)
TextRoboto, Helvetica, Arial; 16/24 #404040; headings 22/700 #23262F; muted #838C8F
Button#333333 bg, white 16/500, radius 8, padding 14px 24px (bulletproof table button). Primary CTA may use #01A1DA.
CSATTwo buttons "Good, I'm satisfied" #1F9D55 / "Bad, I'm unsatisfied" #D93036, or 5 emoji-free numbered links
Footer12/18 #7A7A7A: "Uventex Labs Corporation · support@uventex.com", request link, ticket number [#1234]

Always ship a plain-text part, keep the reply-above-this-line marker, dark-mode safe: no text in images, avoid pure-white logos on transparent backgrounds.

Desk classes (v1, owned by tickets)

Inside the agent desk use the desk layout classes from public/desk/desk.css together with these tokens. Module pages register via UVX.route() and render into UVX.main().

ClassUse
.page · .page-head (h1, .sub, .grow)Every desk page: scroll container + title row with actions
.card · .panelDesk card (radius 12) · padded card with h2 + .sub
.tlistTicket-style table (clickable rows)
.kpis > .kpi.card (.k .v .d, .good/.warn/.bad)Metric tiles
.grid22/3 + 1/3 columns, stacks at 980px
.segDesk segmented control (dark active) — .uv-seg is the public one
.bars · .chart · .legend · .minibarSimple reports
.modal-bg > .modal.cardBuilt by UVX.modal()
.empty · .muted · .note-boxEmpty text · secondary text · blue info box

Accessibility checklist

  • Visible focus everywhere — don't remove outlines; :focus-visible and --uv-focus are built in.
  • Labels on every control; icon-only buttons get aria-label; decorative SVGs aria-hidden (icons.js does this).
  • Async content: aria-live="polite" (new chat messages, search results count, toasts); errors role="alert".
  • Dialogs: focus moves in, is trapped, Escape closes, focus returns (UvUI does this).
  • Hit targets ≥ 36px (44px on touch); inputs ≥ 16px font on mobile.
  • Add a skip link (.uv-skip) on public pages; one <h1> per page; landmarks (header/nav/main/footer).

Dark mode (ready, not on)

Set <html data-theme="dark"> and every token flips. Nothing switches automatically yet — the desk and some modules still hard-code whites. Use semantic tokens in new code so this keeps working. Try the toggle at the bottom right.

Changelog

  • v2 — 2026-11-09: measured uventex.com tokens (display type, card shadow, gradients, dark chrome), semantic + dark-ready tokens, spacing/type/motion scales; components: forms (select arrow, checks, switch, search, dropzone), tabs/segmented, badges/chips/counts, statuses on-hold/closed, avatars, tables (stacking), dialogs/drawer, toasts/alerts/banner, empty/skeleton/spinner, menus/tooltips/breadcrumbs/pager/progress/steps, prose, public header/footer/hero/CTA band; icons.js, site-chrome.js, uv-ui.js; email wordmark PNGs; utilities .hide-sm (≤640px) / .hide-md (≤980px) and .skip (alias of .uv-skip).
  • v1: brand tokens, buttons, fields, cards, pills, tags, avatars.