10Buttons

Four variants. One size by default. The primary is near-black.

Every button below is the real <Button> from @evalgist/design-system. If a variant gets renamed or removed, this page will stop compiling.

Variants

primary · outline · ghost · destructive

Sizes & states

sm · default · lg · icon · disabled

With glyph

Gap is 8px; icons are 16 px
11Badges

Four jobs. Four palettes. Always paired with a glyph or a label.

Every badge below is the real <Badge> from the package — if the cva config drifts, these chips will look wrong or the build will fail.

Job status

Lifecycle of a position
DraftAnalyzingPendingActiveCompleteErrorError

Confidence bands

Replaces a numeric score
Suggested matchPossible matchWeak match

Qualification verdict

Per criterion, per candidate
Evidence foundPartial evidenceNo quote foundUnresolved

Candidate status

Reviewer's verdict
ShortlistedRejectedUndecided

Origin

Where a criterion came from
From vacancyManualAI suggestion

Generic shadcn variants

DefaultSecondaryDestructiveOutline
12Inputs

Slate border, white fill, near-black text, neutral focus ring.

Real <Input>, <Label>, and <Select> from the package. The focus ring is the canonical neutral 2px at 30% — never chromatic.

Form fields

Editable line

Borderless single-line fields for inline rename and criterion editing. Focus restores input chrome; blur on an empty trimmed value reverts when revertOnEmptyBlur is set.

Account email

Inline primary-email editing. This local demonstration accepts code 123456 and never sends email or changes an account.

Primary email

person@example.com

Select

13Cards

White fill. Slate-200 border. Ten-pixel corners. Lifts only on hover.

All real <Card*> primitives from the package. Padding is p-6 (roomy) or p-4 (dense).

Dense — job card

dashboard
Senior data engineer · Ghent
Opened 2 days ago · 147 resumes analyzed
Complete
12 Suggested match48 Possible match87 Weak match
Reviewed: 10 of 147

Platform — account deletion in progress

auth fence
Account deletion in progress
Deletion is still running. You can close this page.

Your Evalgist account is being deleted. You have been signed out and cannot use Shortlist until deletion finishes.

If you did not request deletion, contact support via evalgist.ai.

Roomy — auth card

standalone
Welcome back
Sign in to continue reviewing.
14Primitives

Shared primitives for dense product surfaces.

Batch A and B primitives cover status, menus, tables, confirmations, forms, and notifications. Product-specific rows, filters, and panels stay in the app.

Alert and tooltip

status · explanation
Credits added
Your balance is now 102 credits. Success and warning alerts announce politely (role="status"); only errors interrupt with role="alert".
Credits added
90 credits added. You now have 102 credits. Confirmation keeps the chrome neutral and reserves emerald for the icon — a quieter status than success, still role="status".
Running low
You have 2 credits left. Warning reserves amber; red is for the empty state.

Alert — inline actions

warning · composed

Alert lays its children out on a two-column [icon, content] grid, and only AlertTitle and AlertDescription opt into the content column. Anything else you add — an actions row, an error line — must carry col-start-2 itself, or it renders inside the 16px icon column. Use AlertActions for button rows (ghost secondary, default primary). On warning surfaces the primary action uses monochrome default; outline is for non-primary alternates only.

Check removed details
1 document still contains text that looks like a name. Everything else continued on its own.

Sample banner

above page header · conversion

Example assessment

Read-only data with synthetic answers, suggested scores, and quoted evidence.

Start your own

Alert — error with file manifest

destructive · composed

The destructive variant carries a faint tinted surface and edge so an error reads as a distinct surface, not just red text; the body and the per-item manifest stay neutral for legibility. Compose a two-column manifest inside AlertDescription (filenames in an aligned column, reasons in the second) and put the dismiss in AlertAction.

Dropdown menu

actions
Senior data engineer
147 candidates · last analyzed today

Table

candidate list
CandidateBandEvidenceStatus
Anika VerbruggenSuggested match4 quotesReviewed
Milan PeetersPossible match3 quotesNeeds check
Sara BenaliWeak match2 quotesQueued

Skeleton

loading state
Analyzing uploaded resumes

Processing panel

upload · parsing · import

Extracting vacancy text

Keep this page open while Shortlist reads the file and prepares the criteria review.

4s
Extracting text and identifying criteria.

Job_Posting.docx

Reading file and preparing criteria review.

45 KB

Reading assessment

Long-running work switches to an indeterminate state without inventing precision.

8s
Still working. Scanned files can take a little longer.

Preparing assessment

A second source stacks as its own row via additionalFiles.

Finding questions, points, and expected answers.

Pharmacogenomics_case.docx

File read. Finding questions and grading guidance.

17 KB

Correction_key.docx

Correction key. Reading points and expected answers.

21 KB

Confirmations

alert dialog
Archive position
Confirmation is explicit when the action changes evidence state.

Confirm dialog

destructive · async pending
Neutral confirmation
Default variant. The confirm button uses the primary action style.
Destructive confirmation
Async confirm. The dialog shows a pending state and stays open if the action throws.

Recovery dialog

blocked action · kept work
Active shortlist limit
Use when an action is blocked but the user's current work can still be recovered.

Form primitives

checkbox · textarea · message

Keep notes factual and anchored to evidence.

The human decision remains separate from the AI band.

Review workspace

tabs · sheet · popover · toggles
Four quotes support the current band. One quote requires reviewer confirmation.
Familiarity with microscopic techniquesrequired
Native disclosure — the chevron rotates on open, the row stays keyboard-operable, and no client state is needed.
Resume
Document excerpt and highlighted quote.
Evidence
Band rationale and reviewer controls.
17Confidence

Three bands. Four qualification verdicts. One progress bar that tells the story.

Confidence is a band, not a percentage — shown in English, backed by evidence. Progress is the <Progress> primitive; the band is a <Badge>.

Match bands

Per candidate · always with a label
Anna De Smet
Suggested match
5/6 met
Pieter Vermeulen
Possible match
3/6 met
Laila El-Khatib
Suggested match
5/6 met
Yves Maes
Weak match
1/6 met

Qualification verdicts

Per criterion
5+ years SQLData warehousingCloud certificationBelgian driver's license
18EmptyState

The inline empty surface. Dashed border, neutral icon plate, one action at most.

<EmptyState> is the section-level empty primitive — drop it inside a section that has no rows yet. The action slot accepts any React node so the design system stays Next-agnostic; consumers compose their own link primitive.

No action — purely informational

admin · settings unavailable

Settings unavailable

The admin settings API did not return model settings.

With an action slot

dashboard · credits page

No screening results yet

Run your first analysis to see what your credits produce.

Left aligned

dashboard · operational first run

No shortlists yet

Create the first shortlist or inspect the built-in sample before uploading any files.

Inset inside DataTable

admin · framed tables

No verdict reports

Reports appear here when reviewers disagree with a criterion verdict.

Operational variants

admin · logs and jobs

No positions yet

Positions will appear here after users create them.

No recent errors

Operational logs appear here when the app records warnings or errors.

19Stat cards

Label, number, optional hint. Chrome stays monochrome; color rides the data.

A page-header strip used on dashboards. The icon is optional and quiet; the colored bubble is gone. Destructive tone applies to the value when a number is genuinely bad — never as decoration.

Minimal

label + value

Shortlists

10

Resumes screened

323

Credits

14

With hint

quiet line below the number

Credits

4

Buy more credits

Resumes screened

323

Across 12 shortlists

Linkable

adds a thin trailing arrow that brightens on hover

Credits

14

Destructive tone

value turns destructive; hint follows. Used when the number means trouble — zero credits, failed run, etc.

Credits

0

Buy more credits

With icon

optional, thin, slate-400. Use sparingly — most stats don't need one.

Credits

14

20Trust strip

Small-print row of commitments, sitting under a CTA.

Used on commerce and billing surfaces to reassure right where the decision happens. Middle-dot separators, muted text, screen-readers skip the separator. Three to five items reads best — past that, split or trim.

Default

default separator is the middle dot (·)

Credits valid 12 months Non-refundable No subscription Stripe receipt

With a geo-aware item

render local payment-method names conditionally

Credits valid 12 months Non-refundable Card or Bancontact accepted No subscription Stripe receipt

Custom separator

bullet instead of middle dot

EU data residency Zero AI-provider retention Public subprocessors list

21Auto-cycle

Rotating demo with explicit play, pause, and progress.

`useAutoCycle()` drives the active index, owns prefers-reduced-motion, and pauses on hover or focus. `<AutoCycleProgressBar>` and `<AutoCyclePauseToggle>` give consumers a ready-to-place control. The bar pauses in place — hover does not reset progress.

Demo card

Click a row to jump · hover to pause · 3.5 s cycle per candidate
3 candidates · sorted by match
Dr. S. ChenSuggested match

All three qualifications met. 12 peer-reviewed papers on file.

Composition contract

What every consumer wires up
  • Wrap the visual container with {...cycle.containerProps} — that wires pointer and focus pause.
  • Render <AutoCyclePauseToggle cycle={cycle} /> next to the content title so the affordance is discoverable.
  • Render <AutoCycleProgressBar cycle={cycle} /> along the bottom of the same container — the bar drives the cycle.
  • Map your items with cycle.active and cycle.jumpTo(i) for the click-to-pin affordance. Set aria-current on the active item.
  • Under prefers-reduced-motion: reduce, the bar and toggle render nothing and the cycle does not advance. Static state shows item 0.
22FAQ

Three-to-five short Q&As that handle the predictable objections.

Native <details> so it works without JavaScript, collapses by default, opens to one item at a time without state management. Use on commerce, pricing, and onboarding surfaces — anywhere a small set of repeat questions blocks a decision.

In a Card

standard wrapping for a billing or pricing page
Frequently asked
Do credits expire?
Yes. Each credit is valid for 12 months from the date it is granted. Unused credits expire after that.
Can I get a refund?
Credits are non-refundable. Each credit is valid for 12 months from the date it is granted; unused credits can be spent any time within that window.
Will I be charged again automatically?
No. Each purchase is one-time. There is no subscription.

Standalone

without the Card wrapper, e.g. inline on a docs page
What payment methods are accepted?
Stripe Checkout surfaces local methods per buyer country.
Where are my receipts?
Stripe issues a receipt by email on every purchase.
26Status notice

State that is already true, without an alert.

A muted inline strip for working surfaces. No border, no action, no page-level placement. Use when the surface is locked, read-only, or retained and the user only needs to know why. Keep copy to one or two short sentences.

Locked working state

vacancy edit after analysis

Locked after analysis. Rename the title, or start a new shortlist to change the role.

Retention note

upload queue

Original files are retained for 14 days, then deleted automatically.

When to use

rule

Use StatusNotice for state that is already true and does not ask the user to act. Use Alert when the state is an error, warning, or success that needs attention. Use SampleBanner for page-level example-data notices. Do not use StatusNotice as a form field, input, or primary call to action.

25Step states

Four states, one cue at a time.

The icon-tile-plus-row pattern used by setup strips and task checklists. State lives in the icon tile and, when current, in a single hairline on the row. The badge says the same thing in words. Never two cues for the same state — pick one.

The strip

One row per state

Role uploaded

Done

Sales Manager parsed

Add role

Current

Upload or paste the role

Evaluation criteria

Blocked

Waiting for role details

Review candidates

Up next

Once screening completes

Each state, isolated

What the tile carries vs. what the row carries

Role uploaded

Done

Sales Manager parsed

state
complete
tile
bg-emerald-50 text-emerald-700
row
—
badge
variant="shortlist-done"

Add role

Current

Upload or paste the role

state
current
tile
bg-muted text-foreground
row
ring-1 ring-inset ring-foreground/15
badge
variant="secondary"

Evaluation criteria

Blocked

Waiting for role details

state
blocked
tile
bg-muted text-muted-foreground
row
—
badge
variant="outline"

Review candidates

Up next

Once screening completes

state
not-started
tile
bg-muted text-muted-foreground
row
—
badge
variant="outline"

Rules

Why this looks the way it does
  1. One cue per state. A ring and a badge for the same row is two voices saying the same word. The badge stays; the row hairline replaces the louder cues we tried first.
  2. Tile fill stays monochrome except for complete. Emerald 50/700 is reserved for finished work — the only state that earns a semantic colour. Current is signalled by the row, not by a tinted tile.
  3. Blocked and not-started share the tile. The badge does the differentiating. Two near-identical tile treatments with different badges is correct; two ways of saying "this is not the active step" is not.
  4. aria-current="step" on the current row. The visual cue is paired with the assistive-technology cue, not a substitute.
  5. Not yet a primitive. The pattern lives inline in apps/shortlist/components/jobs/setup-progress-strip.tsx. When a second surface needs the same icon-tile-plus-state vocabulary, extract <StatusIconTile> into @evalgist/design-system/ui and refer back to this section.
34Data table

Filters belong to the table, not floating above it.

<DataTable> wraps the real <Table> in its own card surface with an optional toolbar — a non-scrolling strip on the same surface as the rows — and an optional footer for <DataTablePagination>. The body scrolls horizontally for wide tables while the toolbar stays put. Distinct from <ActionToolbar>, which is a standalone bulk-action bar that sits above content.

With toolbar

search · filter · count, attached to the table
3 shown
UserRoleUsageStatus
nora@university.eduAdmin3 shortlistsActive
viktor@institute.orgUser1 shortlistActive
lena@college.beUser7 shortlistsSuspended

With pagination

footer · numbered pages for server-paged tables that outgrow Load more
InvoiceBuyer
2026001234Buyer 1234
2026001233Buyer 1233
2026001232Buyer 1232
2026001231Buyer 1231
2026001230Buyer 1230

Without toolbar

plain framed table
UserRoleUsageStatus
nora@university.eduAdmin3 shortlistsActive
viktor@institute.orgUser1 shortlistActive
lena@college.beUser7 shortlistsSuspended

Wide — horizontal scroll

overflows the column; edge fade appears
UserRoleOrgUsageCostStatusCreatedLast seenPlanActions
nora@university.eduAdminUniversity of Ghent3 shortlists€42.10Active2026-01-142026-06-16PilotView · Edit
viktor@institute.orgUserRoyal Institute1 shortlist€8.75Active2026-03-022026-06-15PilotView · Edit
lena@college.beUserMerelbeke College7 shortlists€118.40Suspended2025-11-282026-05-30TrialView · Edit
35Refresh button

Reload is utility chrome, not a call to action.

<RefreshButton> is an icon-only ghost control: no label competing with the page title. The name lives in an aria-label and a tooltip; the glyph spins and the control disables while a refresh is in flight. It belongs in the page header's actions slot. Requires a TooltipProvider ancestor — the app shell mounts one.

In a page header

actions slot · on the canvas surface

Admin

Users

Find users, inspect usage, grant credits, and manage support status.

States

rest · refreshing (spins, disabled)
36Timeline

A vertical record of what happened, and when.

<Timeline> renders an ordered list of events on a single connecting rail: the line caps at the first and last dot instead of overshooting. It is data-driven — pass an items array of { label, timestamp, detail }. It never formats dates; the caller passes an already-formatted timestamp so the component stays framework-pure. Used for the analysis audit's processing record.

Processing record

timestamp rides the label line; detail wraps below
  1. UploadedAug 25, 2026, 5:45 PM

  2. Criteria confirmedAug 25, 2026, 5:45 PM

  3. Source prepared

    Native PDF text

  4. AI check

    1 credit · 8 criteria assessed

  5. Reviewer resolutionAug 25, 2026, 5:46 PM

    Evidence found · Confirmed against the resume

  6. ScoredAug 25, 2026, 5:47 PM

  7. PublishedAug 25, 2026, 5:51 PM

35Markdown content

Rendered structure, not a wall of text.

<MarkdownContent> renders trusted, user-owned Markdown (parsed assessments, vacancy sources) on the design system's type scale — headings, lists, tables, and code, so a round-trippable source reads as a document, not a blob. Use variant="document" inside a scrollable <SourceExcerpt presentation="document"> for parsed resume and vacancy sheets. The same variant shows an uploaded assessment's readable text, with paragraph breaks added and no structure invented. It is not for untrusted third-party input.

Inline excerpt

default · attributed

Bridge design brief

Design a pedestrian bridge for a 24 m span. Address load, materials, and safety.

  1. Produce a labelled concept sketch and explain load transfer to the supports.
  2. Compare steel, timber and reinforced concrete for the deck.
  3. Identify two safety risks and propose a mitigation for each.
CriterionWeight
Structural reasoning40%
Material justification35%
Safety analysis25%
Source:Parsed from the uploaded assessment

Document preview

scrollable · document

Experience

Programme Director — Northgate Foundation (2014–present)

  • Lead the operating team across finance, HR, IT, and facilities.
  • Own the €4.8M annual operating budget.

Education

  • MBA, KU Leuven (2010)
  • BA Public Administration, Ghent University (2006)
Source:Parsed from the uploaded resume