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 · destructiveSizes & states
sm · default · lg · icon · disabledWith glyph
Gap is 8px; icons are 16 pxFour 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 positionConfidence bands
Replaces a numeric scoreQualification verdict
Per criterion, per candidateCandidate status
Reviewer's verdictOrigin
Where a criterion came fromGeneric shadcn variants
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
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
dashboardPlatform — account deletion in progress
auth fenceYour 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
standaloneShared 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 · explanationAlert — inline actions
warning · composedAlert 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.
Sample banner
above page header · conversionExample assessment
Read-only data with synthetic answers, suggested scores, and quoted evidence.
Alert — error with file manifest
destructive · composedThe 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.
The rest of your upload was saved — re-upload the 2 files below.
- CV Hamza Fadli PhD.pdfOnly PDF and DOCX files are supported.
- GHENT PhD CV (ANNET).pdfFile must be 10 MB or smaller.
Dropdown menu
actionsTable
candidate list| Candidate | Band | Evidence | Status |
|---|---|---|---|
| Anika Verbruggen | Suggested match | 4 quotes | Reviewed |
| Milan Peeters | Possible match | 3 quotes | Needs check |
| Sara Benali | Weak match | 2 quotes | Queued |
Skeleton
loading stateProcessing panel
upload · parsing · importExtracting vacancy text
Keep this page open while Shortlist reads the file and prepares the criteria review.
Job_Posting.docx
Reading file and preparing criteria review.
Reading assessment
Long-running work switches to an indeterminate state without inventing precision.
Preparing assessment
A second source stacks as its own row via additionalFiles.
Pharmacogenomics_case.docx
File read. Finding questions and grading guidance.
Correction_key.docx
Correction key. Reading points and expected answers.
Confirmations
alert dialogConfirm dialog
destructive · async pendingRecovery dialog
blocked action · kept workForm primitives
checkbox · textarea · messageReview workspace
tabs · sheet · popover · togglesFamiliarity with microscopic techniquesrequired
One sober link for prose and policy. Underlined, foreground, neutral focus ring.
The real <TextLink> from @evalgist/design-system. Use it for legal and policy links instead of hand-rolling an anchor className. Pass asChild to wrap next/link; render a plain anchor for external URLs.
Inline (default)
Underlined in running text; underline drops on hoverFor the precise policy, see Privacy, Terms, and Subprocessors.
Standalone
For a labelled link cluster; underline appears on hoverExternal
No asChild; renders a plain anchorThe full overview lives on evalgist.ai/shortlist.
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 labelQualification verdicts
Per criterionThe 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 unavailableSettings unavailable
The admin settings API did not return model settings.
With an action slot
dashboard · credits pageNo screening results yet
Run your first analysis to see what your credits produce.
Left aligned
dashboard · operational first runNo shortlists yet
Create the first shortlist or inspect the built-in sample before uploading any files.
Inset inside DataTable
admin · framed tablesNo verdict reports
Reports appear here when reviewers disagree with a criterion verdict.
Operational variants
admin · logs and jobsNo positions yet
Positions will appear here after users create them.
No recent errors
Operational logs appear here when the app records warnings or errors.
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 + valueShortlists
10
Resumes screened
323
Credits
14
With hint
quiet line below the numberCredits
4
Buy more credits
Resumes screened
323
Across 12 shortlists
Linkable
adds a thin trailing arrow that brightens on hoverDestructive 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.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 conditionallyCredits valid 12 months Non-refundable Card or Bancontact accepted No subscription Stripe receipt
Custom separator
bullet instead of middle dotEU data residency Zero AI-provider retention Public subprocessors list
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 candidateComposition 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.activeandcycle.jumpTo(i)for the click-to-pin affordance. Setaria-currenton 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.
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 pageDo credits expire?
Can I get a refund?
Will I be charged again automatically?
Standalone
without the Card wrapper, e.g. inline on a docs pageWhat payment methods are accepted?
Where are my receipts?
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 analysisLocked after analysis. Rename the title, or start a new shortlist to change the role.
Retention note
upload queueOriginal files are retained for 14 days, then deleted automatically.
When to use
ruleUse 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.
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 stateRole uploaded
DoneSales Manager parsed
Add role
CurrentUpload or paste the role
Evaluation criteria
BlockedWaiting for role details
Review candidates
Up nextOnce screening completes
Each state, isolated
What the tile carries vs. what the row carriesRole uploaded
DoneSales Manager parsed
- state
complete- tile
bg-emerald-50 text-emerald-700- row
—- badge
variant="shortlist-done"
Add role
CurrentUpload or paste the role
- state
current- tile
bg-muted text-foreground- row
ring-1 ring-inset ring-foreground/15- badge
variant="secondary"
Evaluation criteria
BlockedWaiting for role details
- state
blocked- tile
bg-muted text-muted-foreground- row
—- badge
variant="outline"
Review candidates
Up nextOnce screening completes
- state
not-started- tile
bg-muted text-muted-foreground- row
—- badge
variant="outline"
Rules
Why this looks the way it does- 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.
- 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.
- 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.
- aria-current="step" on the current row. The visual cue is paired with the assistive-technology cue, not a substitute.
- 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/uiand refer back to this section.
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| User | Role | Usage | Status |
|---|---|---|---|
| nora@university.edu | Admin | 3 shortlists | Active |
| viktor@institute.org | User | 1 shortlist | Active |
| lena@college.be | User | 7 shortlists | Suspended |
With pagination
footer · numbered pages for server-paged tables that outgrow Load more| Invoice | Buyer |
|---|---|
| 2026001234 | Buyer 1234 |
| 2026001233 | Buyer 1233 |
| 2026001232 | Buyer 1232 |
| 2026001231 | Buyer 1231 |
| 2026001230 | Buyer 1230 |
Without toolbar
plain framed table| User | Role | Usage | Status |
|---|---|---|---|
| nora@university.edu | Admin | 3 shortlists | Active |
| viktor@institute.org | User | 1 shortlist | Active |
| lena@college.be | User | 7 shortlists | Suspended |
Wide — horizontal scroll
overflows the column; edge fade appears| User | Role | Org | Usage | Cost | Status | Created | Last seen | Plan | Actions |
|---|---|---|---|---|---|---|---|---|---|
| nora@university.edu | Admin | University of Ghent | 3 shortlists | €42.10 | Active | 2026-01-14 | 2026-06-16 | Pilot | View · Edit |
| viktor@institute.org | User | Royal Institute | 1 shortlist | €8.75 | Active | 2026-03-02 | 2026-06-15 | Pilot | View · Edit |
| lena@college.be | User | Merelbeke College | 7 shortlists | €118.40 | Suspended | 2025-11-28 | 2026-05-30 | Trial | View · Edit |
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 surfaceAdmin
Users
Find users, inspect usage, grant credits, and manage support status.
States
rest · refreshing (spins, disabled)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 belowUploadedAug 25, 2026, 5:45 PM
Criteria confirmedAug 25, 2026, 5:45 PM
Source prepared
Native PDF text
AI check
1 credit · 8 criteria assessed
Reviewer resolutionAug 25, 2026, 5:46 PM
Evidence found · Confirmed against the resume
ScoredAug 25, 2026, 5:47 PM
PublishedAug 25, 2026, 5:51 PM
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 · attributedBridge design brief
Design a pedestrian bridge for a 24 m span. Address load, materials, and safety.
- Produce a labelled concept sketch and explain load transfer to the supports.
- Compare steel, timber and reinforced concrete for the deck.
- Identify two safety risks and propose a mitigation for each.
Criterion Weight Structural reasoning 40% Material justification 35% Safety analysis 25%
Document preview
scrollable · documentExperience
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)