The EU VAT Info design system
Tokens, components and page patterns behind EU VAT Info. Every example renders with the production stylesheet, so what you see here is what ships.
- Colour tokens
- 38
- Shape, depth and motion tokens
- 7
- Component classes
- 38
- Icons
- 59
- Live examples
- 48
- Blade components
- 31
Referenčná príručka dizajnového systému je dostupná v angličtine.
Principles
Seven decisions every page follows. They explain the rules further down and settle anything the rules do not cover.
People come here to get a rate, a total or a validation result they can put on an invoice. The interface reads like a well-kept technical reference: cool near-white paper ruled with hairlines, Familjen Grotesk heads over IBM Plex Sans, keys you press, panels cut on two corners, and one electric cobalt signal for what you can act on. Figures are the loudest type on any screen. Nothing glows, blurs or bounces.
-
Exact, not shiny
Surfaces are opaque paper. Depth is a hairline, a paper step and, on keys only, a real bottom edge. No glass, blur, glow or decorative gradients.
-
Ink is identity, cobalt is action
Blue-grey ink carries headings and figures; cobalt (
action,button) marks what you can press, what is selected and keyboard focus, and stays under about 5% of a screen outside the rate field. Status colours mean status and nothing else. -
Numbers are the hero
Results use the largest type on the view (Familjen Grotesk 600, tabular), a plain-language summary line and, under the calculator total, the fifty-cell meter.
-
Keys and cuts
Buttons are keycaps that lift 1px on hover and sink on press. Panels, chips and fields are cut on two opposite corners where the browser supports
corner-shape, and fall back to a plain 6–8px radius. -
Honest states
Loading, empty, error and "service unavailable" states are designed, worded and announced; nothing fails silently.
-
Accessible by default
WCAG 2.2 AA in both themes, a visible cobalt focus ring on every surface, field edges at 3:1 or better, 44px touch targets and reduced-motion support.
-
Quiet motion
Keys travel in 120ms; menus fade in with a 4px drop; the rate field drifts at 30 fps, pauses off screen and is one still under reduced motion.
Colour
Semantic tokens carry meaning, not hue. Each one has a light and a dark value, and the data-theme attribute on the html element swaps them, so templates never need dark: variants.
Surfaces
-
workspace- Light
- #F8FBFE
- Dark
- #0A0E17
Paper: page canvas, header, heroes
-
surface- Light
- #FDFEFF
- Dark
- #111722
Cards, fields, tables, menus
-
surface-subtle- Light
- #F3F6FA
- Dark
- #151C28
Table heads, result panes, the footer
-
surface-muted- Light
- #E8EDF3
- Dark
- #1D2431
Sunken trays, hover fills, placeholders
-
line- Light
- #DADEE4
- Dark
- #272E3B
Hairlines between rows and around cards
-
line-strong- Light
- #C2C8CF
- Dark
- #3E4858
Key outlines, popover edges
Text
-
ink- Light
- #111825
- Dark
- #EBEFF4
Headings, values, primary text
-
ink-muted- Light
- #3C434E
- Dark
- #B7BEC8
Supporting text and labels (AA on every surface)
-
ink-quiet- Light
- #5D646E
- Dark
- #939CA9
Placeholders, meta, field edges (3:1 or better)
Brand
-
brand- Light
- #121823
- Dark
- #05080F
Graphite: the
hero-canvasband for code and calls to action -
brand-deep- Light
- #0D131D
- Dark
- #03060B
Text on white keys inside graphite
-
brand-soft- Light
- #E3F0FF
- Dark
- #18263F
Cobalt wash panels on paper
Action
-
action- Light
- #0462D3
- Dark
- #75B4FF
Links, selection, focus, data bars (never behind white text)
-
action-deep- Light
- #0040BB
- Dark
- #A8D2FF
Text on
action-soft, hovered links -
action-soft- Light
- #E3F0FF
- Dark
- #192B49
Pressed chips, active rows, the one highlighted table row
-
button- Light
- #0462D3
- Dark
- #0462D3
The primary key face, which carries white text (stays saturated in dark)
-
button-hover- Light
- #004FC8
- Dark
- #2673DF
Hover for
buttonfaces
Status
-
success- Light
- #007748
- Dark
- #63D99B
Verified, valid, decrease in rate
-
success-soft- Light
- #E0FAEA
- Dark
- #103324
Verified, valid, decrease in rate
-
warning- Light
- #AE4900
- Dark
- #F9BA5F
Needs attention, scheduled
-
warning-soft- Light
- #FFF2D7
- Dark
- #42270E
Needs attention, scheduled
-
danger- Light
- #BE2323
- Dark
- #FE8B83
Invalid, error, increase in rate
-
danger-soft- Light
- #FFEEEE
- Dark
- #4B1D1B
Invalid, error, increase in rate
Fixed colours
The same in both themes: the code surfaces, which stay graphite in light and dark.
-
code#121823 -
code-raised#1E2532 -
code-muted#2F3848
Syntax colours
For code samples on the graphite code surface, in both themes. Syntax stays in the cobalt family; only status codes take green and red.
- keyword #75B4FF
- function #E3E8EE
- string #9FD2F2
- literal #A9C3FF
- comment #939CA9
- ok #6CD79D
- error #FE8B83
Keys
The faces and bottom edges of keys and chips. They reach templates through the app-button and app-chip classes and the shadow-key utilities.
-
button-edgeThe primary key's border and bottom edge -
key-faceSecondary keys and chips -
key-edgeThe bottom edge of secondary keys and chips
Rate field tints
glyph-1 to glyph-4, lightest to densest, with action-deep for the densest cells. The rateField component reads them, and a graphite band swaps in its own set.
VAT map ramp
A single-hue ordinal ramp, checked for colour-vision deficiency. It flips in dark mode so higher rates gain contrast against the dark surface, and every region is also listed as text.
Contrast pairs
WCAG 2.2 contrast ratios computed from the tokens above. Body text needs 4.5:1; large text, icons and borders need 3:1.
| Pair | Tokens | Light | Dark |
|---|---|---|---|
| Body text ink on surface | ink on surface | 17.6:1 AAA | 15.5:1 AAA |
| Supporting text ink-muted on surface | ink-muted on surface | 9.9:1 AAA | 9.6:1 AAA |
| Meta and placeholders ink-quiet on surface | ink-quiet on surface | 5.9:1 AA | 6.5:1 AA |
| Links and selection action on surface | action on surface | 5.6:1 AA | 8.3:1 AAA |
| Selected chip action-deep on action-soft | action-deep on action-soft | 7.4:1 AAA | 9.0:1 AAA |
| Success success on success-soft | success on success-soft | 5.1:1 AA | 7.8:1 AAA |
| Warning warning on warning-soft | warning on warning-soft | 5.1:1 AA | 8.1:1 AAA |
| Danger danger on danger-soft | danger on danger-soft | 5.4:1 AA | 6.2:1 AA |
| Button label white on button | white on button | 5.7:1 AA | 5.7:1 AA |
| Text on graphite white on brand | white on brand | 17.7:1 AAA | 20.0:1 AAA |
| Cobalt on paper action on workspace | action on workspace | 5.4:1 AA | 9.0:1 AAA |
Typography
Familjen Grotesk at weight 600 for headings and figures, IBM Plex Sans for reading and JetBrains Mono for machine values, all three self-hosted. Headings stay one colour, labels stay in sentence case, and every figure that can change or be compared is set in tabular numbers.
Display
Hero headings, and hero results with font-display on the figure
3rem 600 1.04
€1,487.50
text-4xl sm:text-5xl font-semibold tracking-[-0.03em] sm:leading-[1.04]
Headline
Page header titles
2.5rem 600 1.08
VAT rate change history
text-3xl sm:text-[2.5rem] font-semibold tracking-[-0.03em]
Section
Section headings inside a page
Recorded changes
text-xl font-semibold text-ink
Title
Card titles
1.125rem 600 1.35
Germany VAT rates and formulas
text-lg font-semibold text-ink
Body
Paragraphs, capped at 68–72 characters
1rem 400 1.6
VIES forwards your query to the national VAT database of the member state that issued the number and returns its registration status.
text-base leading-7 text-ink-muted
Small
Helper text and table cells
The country is detected from the VAT number prefix.
text-sm text-ink-muted
Label
Field labels, data labels and table heads, in sentence case and untracked
0.8125rem 500 1.35
Amount (excl. VAT)
font-display text-[0.8125rem] font-medium text-ink-muted
Mono
VAT numbers, API paths, code, the meter and the rate field; never a label or heading
DE123456789
font-mono
Context label and kicker
A short label that never stands above a heading: a group name or a source line, and the flag line in a country heading. Sentence case, never tracked capitals
Source: European Commission
EU member state
app-eyebrow, app-kicker
Tabular figures
Digits share one width, so columns of money and rates line up
Default
€1,111.11
€9,090.00
With tabular
€1,111.11
€9,090.00
Families
From the --font-display, --font-sans and --font-mono tokens. Three weights are in use: 400, 500 and 600, which font-bold also resolves to
Familjen Grotesk 19%
Familjen Grotesk Variable, Familjen Fallback, IBM Plex Sans Variable, ui-sans-serif, system-ui, sans-serif
Plex 400 Plex 500 Plex 600
IBM Plex Sans Variable, Plex Fallback, ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif, Apple Color Emoji, Segoe UI Emoji
LT100019070512 country_code ░░░░████
JetBrains Mono Variable, ui-monospace, SF Mono, Cascadia Code, Menlo, Consolas, monospace
Shape
Three radius tokens and two cuts. Keys, fields and chips take 6px and cards 8px; the primary task card is cut on two opposite corners, and fields and chips take the smaller cut. Pills are not part of the system: rounded-full is kept for spinners, avatars and numbered steps.
-
rounded-control6pxKeys, fields, chips, segmented tray, menu rows, icon wells, notes
-
rounded-card8pxapp-surfacecards, popovers, menus, code blocks, graphite panels -
rounded-panel8pxThe primary task card (
app-surface-raised, alsocut), the command palette, graphite CTA blocks -
cut16px bevelTwo opposite corners bevelled on a panel where corner-shape is supported
-
cut-sm8px bevelThe same on fields and chips
-
rounded-xs2pxFlags, badges, keyboard hints and bar ends
-
rounded-full50%Spinners, avatars and numbered step markers only
Elevation
Depth is a hairline first, then a paper step. Three shadows lift resting cards, the one primary task card and things that float; keys stand on a real 2px bottom edge and sink onto an inset shadow when pressed.
-
shadow-cardResting cards (built into
app-surface)1 layer
-
shadow-workflowThe primary task card (built into
app-surface-raised)2 layers
-
shadow-floatingMenus, popovers, the palette, toasts (built into
app-popover)2 layers
-
shadow-keyThe 2px bottom edge of secondary keys and chips
-
shadow-key-accentThe bottom edge of the primary key
-
shadow-key-pressA key pressed in: the chosen chip, the segmented tray,
:active
Motion
Quiet and quick, all on the out-quint curve. Keys travel 1–2px and change colour in the short duration, thumbs and menus move in the longer one, and the rate field drifts at 30 fps and pauses off screen. Nothing scales or springs, and reduced-motion settings collapse every duration and still the field.
Easing
ease-out-quint
cubic-bezier(0.22, 1, 0.36, 1)
Colour changes
120ms
Key travel and pressable feedback on colour, borders and shadows
Position changes
200ms
Sliding thumbs and menus that drop 4px
Position change at 200ms on ease-out-quint
Layout
One page width, a four-pixel spacing grid and grids that start from a single column, so no page scrolls sideways at 320px.
app-container
- Phones
- 16px gutters
- From sm
- 24px gutters
- From lg
- 32px gutters
| Prefix | Min width |
|---|---|
| sm: | 640px |
| md: | 768px |
| lg: | 1024px |
| xl: | 1280px |
| 2xl: | 1536px |
| Where | Classes |
|---|---|
| Between sections | py-8 sm:py-10 |
| Hero bottom | pb-10 sm:pb-14 |
| Card padding | p-5 sm:p-6 |
| Card grids | gap-4 or gap-6 |
| Reading width | max-w-[68ch] |
Form fields
Fields are cut on two corners and edged in ink-quiet, so the edge holds 3:1 against paper. Labels sit above, help and errors below, linked with aria-describedby. Validate on the client for instant feedback and again on the server.
Text field
app-field, cut on two corners, with help text
As registered with the national tax authority.
Blade
<div class="max-w-sm">
<label for="sg-company" class="mb-1.5 block font-display text-[0.8125rem] font-medium text-ink-muted">Company name</label>
<input id="sg-company" type="text" class="app-field" placeholder="Example GmbH" aria-describedby="sg-company-help">
<p id="sg-company-help" class="mt-1.5 text-xs text-ink-muted">As registered with the national tax authority.</p>
</div>
Error
aria-invalid plus a message that says what to fix
German VAT numbers have nine digits after DE.
Blade
<div class="max-w-sm">
<label for="sg-vat-number" class="mb-1.5 block font-display text-[0.8125rem] font-medium text-ink-muted">VAT number</label>
<input
id="sg-vat-number"
type="text"
value="DE12345"
class="app-field border-danger font-mono focus:border-danger focus:ring-danger/15"
aria-invalid="true"
aria-describedby="sg-vat-number-error"
>
<p id="sg-vat-number-error" class="mt-1.5 text-xs font-medium text-danger">German VAT numbers have nine digits after DE.</p>
</div>
Select
app-select keeps the native control
Blade
<div class="max-w-sm">
<label for="sg-rate-type" class="mb-1.5 block font-display text-[0.8125rem] font-medium text-ink-muted">Rate type</label>
<select id="sg-rate-type" class="app-select">
<option>Standard</option>
<option>Reduced</option>
<option>Super-reduced</option>
<option>Parking</option>
</select>
</div>
Prefix and search
Money inputs are tabular
Blade
<div class="grid max-w-xl grid-cols-1 gap-4 sm:grid-cols-2">
<div>
<label for="sg-amount" class="mb-1.5 block font-display text-[0.8125rem] font-medium text-ink-muted">Amount (excl. VAT)</label>
<div class="relative">
<span class="pointer-events-none absolute inset-y-0 left-3.5 flex items-center font-semibold text-ink-quiet" aria-hidden="true">€</span>
<input id="sg-amount" type="text" inputmode="decimal" value="1,250.00" class="app-field tabular h-12 pl-10 text-lg font-semibold">
</div>
</div>
<div>
<label for="sg-search" class="mb-1.5 block font-display text-[0.8125rem] font-medium text-ink-muted">Country</label>
<div class="relative">
<x-ui.icon name="search" class="pointer-events-none absolute left-3.5 top-1/2 size-4 -translate-y-1/2 text-ink-quiet" />
<input id="sg-search" type="search" placeholder="Search countries…" class="app-field h-12 pl-10">
</div>
</div>
</div>
VAT number format hint
A warning under the field when a number does not fit its country’s format; it never blocks the check
This does not look like a VAT number from Germany (DE999999999). Check for a typing mistake, or validate it anyway.
Blade
<div class="max-w-xl">
<label for="sg-format-number" class="mb-1.5 block font-display text-[0.8125rem] font-medium text-ink-muted">VAT number</label>
<input
id="sg-format-number"
type="text"
value="DE12345678"
class="app-field font-mono"
aria-describedby="sg-format-hint"
>
<p id="sg-format-hint" class="mt-3 flex items-start gap-2 text-sm font-medium text-warning" role="status">
<x-ui.icon name="alert-triangle" class="mt-0.5 size-4 shrink-0" />
<span>This does not look like a VAT number from Germany (DE999999999). Check for a typing mistake, or validate it anyway.</span>
</p>
</div>
Selection controls
A segmented control for two equal modes on a sunken tray, chips for choosing among values, and chip tabs for switching panels. Chips are small keys that press in when chosen.
Segmented control
A key-face thumb on a sunken tray slides 200ms; data-value is rendered on the server too
Blade
<div x-data="{ mode: 'exclude' }">
<div role="radiogroup" aria-label="Calculation mode" class="app-segmented" data-value="exclude" :data-value="mode">
<span class="app-segmented-thumb" aria-hidden="true"></span>
<button type="button" role="radio" aria-checked="true" :aria-checked="(mode === 'exclude').toString()" class="app-segment" x-on:click="mode = 'exclude'">
<x-ui.icon name="plus" class="size-3.5" />
Add VAT
</button>
<button type="button" role="radio" aria-checked="false" :aria-checked="(mode === 'include').toString()" class="app-segment" x-on:click="mode = 'include'">
<x-ui.icon name="minus" class="size-3.5" />
Remove VAT
</button>
</div>
</div>
Chips
Small keys; app-chip-active presses one in, with aria-pressed; dashed for “add custom”
Blade
<div class="flex flex-wrap gap-2" role="group" aria-label="VAT rate" x-data="{ rate: 19 }">
<button type="button" class="app-chip app-chip-active min-h-10 px-3.5" :class="{ 'app-chip-active': rate === 19 }" aria-pressed="true" :aria-pressed="(rate === 19).toString()" x-on:click="rate = 19">
<span class="font-medium opacity-80">Standard</span>
<span class="tabular">19%</span>
</button>
<button type="button" class="app-chip min-h-10 px-3.5" :class="{ 'app-chip-active': rate === 7 }" aria-pressed="false" :aria-pressed="(rate === 7).toString()" x-on:click="rate = 7">
<span class="font-medium opacity-80">Reduced</span>
<span class="tabular">7%</span>
</button>
<button type="button" class="app-chip min-h-10 border-dashed px-3.5">
<x-ui.icon name="plus" class="size-3.5" />
Custom %
</button>
</div>
Chip tabs
A tablist with arrow-key movement
Open Settings → Connectors and add the server URL.
Add the server to ~/.cursor/mcp.json.
Connect with Streamable HTTP and no authentication.
Blade
<div x-data="{
tab: 'claude',
tabs: ['claude', 'cursor', 'other'],
move(step) {
this.tab = this.tabs[(this.tabs.indexOf(this.tab) + step + this.tabs.length) % this.tabs.length];
this.$nextTick(() => document.getElementById('sg-tab-' + this.tab).focus());
},
}">
<div role="tablist" aria-label="AI client" class="flex flex-wrap gap-2" x-on:keydown.arrow-right.prevent="move(1)" x-on:keydown.arrow-left.prevent="move(-1)">
@foreach(['claude' => 'Claude', 'cursor' => 'Cursor', 'other' => 'Other clients'] as $key => $label)
<button
type="button"
role="tab"
id="sg-tab-{{ $key }}"
aria-controls="sg-panel-{{ $key }}"
aria-selected="{{ $loop->first ? 'true' : 'false' }}"
:aria-selected="(tab === @js($key)).toString()"
tabindex="{{ $loop->first ? 0 : -1 }}"
:tabindex="tab === @js($key) ? 0 : -1"
@class(['app-chip', 'app-chip-active' => $loop->first])
:class="{ 'app-chip-active': tab === @js($key) }"
x-on:click="tab = @js($key)"
>{{ $label }}</button>
@endforeach
</div>
@foreach(['claude' => 'Open Settings → Connectors and add the server URL.', 'cursor' => 'Add the server to ~/.cursor/mcp.json.', 'other' => 'Connect with Streamable HTTP and no authentication.'] as $key => $step)
<p role="tabpanel" id="sg-panel-{{ $key }}" aria-labelledby="sg-tab-{{ $key }}" tabindex="0" class="mt-4 text-sm text-ink-muted" x-show="tab === @js($key)" @unless($loop->first) x-cloak @endunless>{{ $step }}</p>
@endforeach
</div>
Surfaces
Opaque paper with hairline borders. Cards hold content, the cut raised card holds the primary task, popovers float, the tool hero is paper over the rate field, and brand panels sit only inside a graphite band.
Tool hero and the rate field
hero-field with <x-hero-backdrop />: an ASCII field drawn from the 27 standard rates
EU VAT calculator
Raw cells on the left resolve into one column per member state on the right, each as tall as its standard rate. Keep headings on the left half.
Blade
{{-- On a page, write <x-hero-backdrop /> as the first child of hero-field; it reads the live rates. This specimen passes fixed rates so it renders without the database. --}}
<div class="hero-field rounded-card border border-line">
<div class="hero-ground" aria-hidden="true" x-data="rateField(@js(\App\Support\DesignSystem\ComponentCatalog::SAMPLE_RATES))"></div>
<div class="relative px-5 py-10 sm:px-8 sm:py-14">
<h4 class="max-w-sm text-3xl font-semibold tracking-[-0.03em] text-ink">EU VAT calculator</h4>
<p class="mt-2 max-w-[40ch] text-sm leading-6 text-ink-muted">Raw cells on the left resolve into one column per member state on the right, each as tall as its standard rate. Keep headings on the left half.</p>
</div>
</div>
Card
app-surface on paper
Germany VAT rates
A card sits on paper with a hairline border and the resting card shadow.
Source: European Commission
Blade
<div class="app-surface max-w-md p-5 sm:p-6">
<h4 class="text-lg font-semibold text-ink">Germany VAT rates</h4>
<p class="mt-2 text-sm leading-6 text-ink-muted">A card sits on paper with a hairline border and the resting card shadow.</p>
<p class="app-eyebrow mt-4">Source: European Commission</p>
</div>
Raised task card
app-surface-raised, cut on two corners, once per view, on a hero
Total (incl. VAT)
€1,487.50
€1,250.00 plus 19% VAT in Germany
Blade
<div class="app-surface-raised max-w-md p-5 text-ink sm:p-6">
<p class="font-display text-[0.8125rem] font-medium text-ink-muted">Total (incl. VAT)</p>
<p class="tabular mt-1 font-display text-4xl font-semibold tracking-[-0.03em] text-ink">€1,487.50</p>
<p class="mt-2 text-sm text-ink-muted">€1,250.00 plus 19% VAT in Germany</p>
</div>
Popover
app-popover for menus, the palette and toasts
Theme
Blade
<div class="app-popover w-64 p-1.5">
<p class="px-2.5 pb-1 pt-1.5 font-display text-[0.8125rem] font-medium text-ink-muted">Theme</p>
@foreach([['monitor', 'System'], ['sun', 'Light'], ['moon', 'Dark']] as [$icon, $label])
<button type="button" @class(['flex min-h-10 w-full items-center gap-2.5 rounded-control px-2.5 text-left text-sm', 'bg-action-soft font-semibold text-action-deep' => $loop->first, 'text-ink hover:bg-surface-muted' => ! $loop->first])>
<x-ui.icon :name="$icon" class="size-4" />
{{ $label }}
</button>
@endforeach
</div>
Brand panel
app-brand-panel for tiles and fields inside a graphite band
- Standard
- 19%
- Reduced
- 7%
- Currency
- EUR
Blade
<div class="grid max-w-lg grid-cols-3 gap-3">
@foreach([['Standard', '19%'], ['Reduced', '7%'], ['Currency', 'EUR']] as [$label, $value])
<dl class="app-brand-panel flex flex-col-reverse p-3 text-center">
<dt class="font-display text-[0.8125rem] font-medium text-white/75">{{ $label }}</dt>
<dd class="tabular font-display text-2xl font-semibold text-white">{{ $value }}</dd>
</dl>
@endforeach
</div>
Cut corners
cut and cut-sm bevel two opposite corners where corner-shape is supported, and keep the plain radius elsewhere
cut
A 16px bevel on the primary task card and the graphite call to action.
cut-sm is built into app-field and app-select.
Blade
<div class="grid max-w-3xl grid-cols-1 items-start gap-4 sm:grid-cols-3">
<div class="cut rounded-panel border border-line bg-surface p-4">
<code class="font-mono text-xs text-ink">cut</code>
<p class="mt-1 text-sm text-ink-muted">A 16px bevel on the primary task card and the graphite call to action.</p>
</div>
<div>
<label for="sg-cut-field" class="mb-1.5 block font-display text-[0.8125rem] font-medium text-ink-muted">Amount</label>
<input id="sg-cut-field" type="text" inputmode="decimal" value="100.00" class="app-field tabular">
<p class="mt-1.5 text-xs text-ink-muted"><code class="font-mono">cut-sm</code> is built into app-field and app-select.</p>
</div>
<div class="flex flex-wrap gap-2">
<span class="app-chip">Standard 19%</span>
<span class="app-chip app-chip-active">Reduced 7%</span>
</div>
</div>
Note
app-note: a quiet paper aside with an info icon
The standard rate applies to most goods and services.
Blade
<p class="app-note max-w-lg">
<x-ui.icon name="info" class="mt-1 size-4 text-action" />
<span>The standard rate applies to most goods and services.</span>
</p>
Text and code
Links, keyboard hints, badges, long-form prose, code and disclosures. Status badges always carry an icon or a word, never colour alone.
Links, keys and inline code
app-link, app-kbd and an app-eyebrow source line
Source: European Commission
Read the VIES guidance, press ⌘ K to search, and send
country_code with every request.
Blade
<div class="max-w-xl space-y-3">
<p class="app-eyebrow">Source: European Commission</p>
<p class="text-base leading-7 text-ink-muted">
Read the <a href="#content" class="app-link">VIES guidance</a>, press <kbd class="app-kbd">⌘</kbd> <kbd class="app-kbd">K</kbd> to search, and send
<code class="rounded-xs bg-surface-muted px-1.5 py-0.5 font-mono text-[0.875em] text-ink">country_code</code> with every request.
</p>
</div>
Badges
app-badge with a tone pair
Blade
<div class="flex flex-wrap items-center gap-2">
<span class="app-badge bg-action-soft text-action-deep">2026 rates</span>
<span class="app-badge bg-surface-muted text-ink-muted">Standard</span>
<span class="app-badge bg-success-soft text-success">
<x-ui.icon name="check-circle" class="size-3.5" />
Valid
</span>
<span class="app-badge bg-warning-soft text-warning">
<x-ui.icon name="clock" class="size-3.5" />
Scheduled
</span>
<span class="app-badge bg-danger-soft text-danger">
<x-ui.icon name="x-circle" class="size-3.5" />
Invalid
</span>
</div>
Prose
app-prose for Markdown and long translations
How a VIES check works
VIES forwards the query to the national database of the member state that issued the number. Greece uses EL rather than its ISO code GR.
- Registration status for intra-EU trade
- Company name and address, where the member state shares them
Results are reference data, not tax advice.
Blade
<div class="app-prose max-w-[68ch]">
<h4>How a VIES check works</h4>
<p>VIES forwards the query to the national database of the member state that issued the number. <strong>Greece uses EL</strong> rather than its ISO code GR.</p>
<ul>
<li>Registration status for intra-EU trade</li>
<li>Company name and address, where the member state shares them</li>
</ul>
<blockquote>Results are reference data, not tax advice.</blockquote>
</div>
Code block
app-code stays graphite in both themes
GET /api/v1/calculate?amount=100&country=DE
200// 100 net at the German standard rate { "net": 100, "vat": 19, "gross": 119, "currency": "EUR" }
Blade
<div class="app-code max-w-xl">
<div class="flex items-center justify-between gap-3 border-b border-white/10 py-2 pl-4 pr-3">
<p class="font-mono text-xs"><span class="font-semibold text-syntax-ok">GET</span> <span class="text-white/60">/api/v1/calculate?amount=100&country=DE</span></p>
<span class="font-mono text-xs text-syntax-ok">200</span>
</div>
<pre tabindex="0" class="overflow-x-auto p-4 font-mono text-xs leading-5 text-white/85"><span class="text-syntax-comment">// 100 net at the German standard rate</span>
{
<span class="text-syntax-function">"net"</span>: <span class="text-syntax-literal">100</span>,
<span class="text-syntax-function">"vat"</span>: <span class="text-syntax-literal">19</span>,
<span class="text-syntax-function">"gross"</span>: <span class="text-syntax-literal">119</span>,
<span class="text-syntax-function">"currency"</span>: <span class="text-syntax-string">"EUR"</span>
}</pre>
</div>
Disclosure
Native details and summary for FAQs
Do I need an account?
No. Every tool is free and needs no sign-up.
Are the answers tax advice?
No. The rates are reference data. Check important cases with a tax adviser.
Blade
<div class="app-surface max-w-2xl divide-y divide-line">
@foreach([
['Do I need an account?', 'No. Every tool is free and needs no sign-up.'],
['Are the answers tax advice?', 'No. The rates are reference data. Check important cases with a tax adviser.'],
] as [$question, $answer])
<details class="group" @if($loop->first) open @endif>
<summary class="flex min-h-14 cursor-pointer list-none items-center justify-between gap-4 px-5 py-4 font-semibold text-ink [&::-webkit-details-marker]:hidden">
{{ $question }}
<x-ui.icon name="chevron-down" class="size-4 text-ink-quiet transition-transform duration-150 group-open:rotate-180" />
</summary>
<p class="px-5 pb-4 text-sm leading-6 text-ink-muted">{{ $answer }}</p>
</details>
@endforeach
</div>
Questions
x-faq-list: native disclosures, with FAQPage data built from the same list
Questions about VAT in Germany
What is the VAT rate in Germany?
The standard VAT rate in Germany is 19%. Reduced rates of 7% apply to selected goods and services.
How do I add VAT to a price in Germany?
Multiply the net price by 1.19. For example, €100.00 plus 19% VAT is €119.00.
How do I remove VAT from a price in Germany?
Divide the price including VAT by 1.19. For example, €100.00 including 19% VAT is €84.03 before VAT.
Blade
<x-faq-list
id="sg-faq"
title="Questions about VAT in Germany"
class="max-w-3xl"
:faqs="[
['q' => 'What is the VAT rate in Germany?', 'a' => 'The standard VAT rate in Germany is 19%. Reduced rates of 7% apply to selected goods and services.'],
['q' => 'How do I add VAT to a price in Germany?', 'a' => 'Multiply the net price by 1.19. For example, €100.00 plus 19% VAT is €119.00.'],
['q' => 'How do I remove VAT from a price in Germany?', 'a' => 'Divide the price including VAT by 1.19. For example, €100.00 including 19% VAT is €84.03 before VAT.'],
]"
/>
Data display
Numbers are the hero. Tables right-align figures in tabular type, breakdowns use definition lists, the calculator total sits over the fifty-cell meter, and bars run on an action track with square ends.
Table
app-table inside a card, scrollable on phones
| Country | Standard | Reduced | VAT on €100 |
|---|---|---|---|
|
|
19% | 7% | €19.00 |
|
|
20% | 5.5%, 10% | €20.00 |
|
|
27% | 5%, 18% | €27.00 |
Blade
<div class="app-surface overflow-hidden">
<div class="relative overflow-x-auto" tabindex="0" role="group" aria-label="Standard rates">
<table class="app-table min-w-[30rem]">
<thead>
<tr>
<th scope="col" class="pl-5">Country</th>
<th scope="col" class="text-right">Standard</th>
<th scope="col" class="text-right">Reduced</th>
<th scope="col" class="pr-5 text-right">VAT on €100</th>
</tr>
</thead>
<tbody>
@foreach([['DE', 'Germany', '19%', '7%', '€19.00'], ['FR', 'France', '20%', '5.5%, 10%', '€20.00'], ['HU', 'Hungary', '27%', '5%, 18%', '€27.00']] as [$iso, $name, $standard, $reduced, $vat])
<tr class="transition-colors hover:bg-surface-subtle">
<td class="pl-5">
<span class="flex items-center gap-2.5 font-semibold text-ink">
<x-ui.flag :iso="$iso" />
{{ $name }}
</span>
</td>
<td class="tabular text-right font-display font-semibold text-ink">{{ $standard }}</td>
<td class="tabular text-right text-ink-muted">{{ $reduced }}</td>
<td class="tabular pr-5 text-right text-ink">{{ $vat }}</td>
</tr>
@endforeach
</tbody>
</table>
</div>
</div>
Breakdown
A dl of label and value pairs
- Net amount
- €1,250.00
- VAT 19%
- + €237.50
- Gross amount
- €1,487.50
Blade
<dl class="max-w-sm divide-y divide-line rounded-control border border-line bg-surface text-sm">
<div class="flex items-center justify-between px-4 py-3">
<dt class="text-ink-muted">Net amount</dt>
<dd class="tabular font-semibold text-ink">€1,250.00</dd>
</div>
<div class="flex items-center justify-between px-4 py-3">
<dt class="text-ink-muted">VAT 19%</dt>
<dd class="tabular font-semibold text-action-deep">+ €237.50</dd>
</div>
<div class="flex items-center justify-between px-4 py-3">
<dt class="font-semibold text-ink">Gross amount</dt>
<dd class="tabular font-semibold text-ink">€1,487.50</dd>
</div>
</dl>
Meter
app-meter: fifty mono cells under the calculator total, aria-hidden beside the figures
Total (incl. VAT)
€1,487.50
Blade
{{-- €1,250.00 plus 19% VAT: the VAT is 16% of the total, so 8 of the 50 cells are filled. --}}
<div class="max-w-md">
<p class="font-display text-[0.8125rem] font-medium text-ink-muted">Total (incl. VAT)</p>
<p class="tabular mt-1 font-display text-4xl font-semibold tracking-[-0.03em] text-ink">€1,487.50</p>
<div class="app-meter mt-4" aria-hidden="true">
<p class="app-meter-cells"><span class="text-ink-quiet">{{ str_repeat('░', 42) }}</span><span class="text-action">{{ str_repeat('█', 8) }}</span></p>
<div class="mt-2 flex justify-between font-display text-xs text-ink-muted">
<span>Net 84%</span>
<span>VAT 16%</span>
</div>
</div>
</div>
Bars and map legend
bg-action on bg-action/15 with square ends; the map ramp swatches
Net 84% VAT 16%
- < 20%
- 20%
- 21–22%
- 23–24%
- ≥ 25%
- No data
Blade
<div class="max-w-md space-y-5">
<div>
<div class="flex h-1.5 overflow-hidden rounded-xs bg-action/15" aria-hidden="true">
<div class="h-full w-[84%] bg-action"></div>
</div>
<p class="mt-1.5 flex justify-between font-display text-xs text-ink-muted">
<span>Net 84%</span>
<span>VAT 16%</span>
</p>
</div>
<ul class="flex flex-wrap items-center gap-x-4 gap-y-1.5 text-xs text-ink-muted" aria-label="Map legend">
@foreach(['< 20%', '20%', '21–22%', '23–24%', '≥ 25%'] as $step => $label)
<li class="inline-flex items-center gap-1.5">
<span class="eu-map-swatch eu-map-swatch-{{ $step }}" aria-hidden="true"></span>
{{ $label }}
</li>
@endforeach
<li class="inline-flex items-center gap-1.5">
<span class="eu-map-swatch eu-map-swatch-none" aria-hidden="true"></span>
No data
</li>
</ul>
</div>
Menus and toasts
Popovers fade in with a 4px drop and close on Escape or an outside click. Toasts confirm quick actions without moving the page.
Menu
Closes on Escape or an outside click
Blade
<div class="min-h-52">
<div class="relative inline-block" x-data="{ open: true }" x-on:click.outside="open = false" x-on:keydown.escape="open = false">
<button type="button" class="app-button-secondary" aria-haspopup="true" aria-controls="sg-language-menu" aria-expanded="true" :aria-expanded="open.toString()" x-on:click="open = !open">
<x-ui.icon name="languages" class="size-4" />
Language
<x-ui.icon name="chevron-down" class="size-4 transition-transform duration-150" x-bind:class="open && 'rotate-180'" />
</button>
<div
id="sg-language-menu"
x-cloak
x-show="open"
x-transition:enter="transition duration-150 ease-out-quint"
x-transition:enter-start="-translate-y-1 opacity-0"
x-transition:leave="transition duration-100 ease-out"
x-transition:leave-end="opacity-0"
class="app-popover absolute left-0 top-full z-20 mt-1.5 w-56 p-1.5"
>
@foreach(['English', 'Deutsch', 'Français'] as $language)
<button type="button" class="flex min-h-10 w-full items-center rounded-control px-2.5 text-left text-sm text-ink hover:bg-surface-muted" x-on:click="open = false">{{ $language }}</button>
@endforeach
</div>
</div>
</div>
Toasts
$store.toasts.push(message, tone)
Blade
<div class="flex flex-wrap items-center gap-3">
<button type="button" class="app-button-secondary" x-data x-on:click="$store.toasts.push('Calculation copied', 'success')">
<x-ui.icon name="check" class="size-4" />
Show a success toast
</button>
<button type="button" class="app-button-secondary" x-data x-on:click="$store.toasts.push('VIES is slow to respond right now', 'info')">
<x-ui.icon name="info" class="size-4" />
Show an info toast
</button>
</div>
Quick search
Opens with ⌘K, Ctrl K or /
Blade
<button type="button" class="app-button-secondary" x-data x-on:click="$store.palette.show()">
<x-ui.icon name="search" class="size-4" />
Open quick search
<kbd class="app-kbd">⌘K</kbd>
</button>
Icons
Lucide paths at a 1.75 stroke, drawn by one component. Select an icon to copy its tag; add a missing icon to components/ui/icon.blade.php in alphabetical order.
<x-ui.icon name="…" class="size-4" />
No icon matches “”. Add it to components/ui/icon.blade.php.
Flags and logo
The mark is an ink tile cut on two corners, with a paper slash and dot and a cobalt dot; it inverts with the theme. Flags are local SVGs with a hairline edge, in five sizes; Greece also accepts EL.
Logo
The mark with and without the wordmark; it inverts with the theme
Blade
<div class="flex flex-wrap items-center gap-8">
<span class="inline-flex items-center gap-2.5 font-display text-lg font-semibold tracking-[-0.02em] text-ink">
<x-ui.logo />
EU VAT Info
</span>
<x-ui.logo class="size-12" />
</div>
Flags
47 countries, sizes xs to xl
Blade
<div class="flex flex-wrap items-end gap-6">
@foreach(['xs', 'sm', 'md', 'lg', 'xl'] as $size)
<span class="flex flex-col items-center gap-2 font-mono text-xs text-ink-muted">
<x-ui.flag iso="de" :size="$size" alt="Germany" />
{{ $size }}
</span>
@endforeach
</div>
Page skeletons
Two page shapes. A tool page opens with a paper hero over the rate field, holding one raised task card; a reference page opens with the paper page header band.
Tool page
Calculator, validator, shared result
Blade
<section class="hero-field">
<x-hero-backdrop />
<div class="app-container relative pb-10 pt-6 sm:pb-14 sm:pt-8">
<x-site-breadcrumbs :items="[__('ui.nav.vat_calculator') => '']" />
<h1 class="mt-6 max-w-2xl text-4xl font-semibold tracking-[-0.03em] text-ink sm:text-5xl">…</h1>
<p class="mt-3 max-w-[54ch] text-base leading-7 text-ink-muted">…</p>
<div class="app-surface-raised mt-8 max-w-4xl overflow-hidden text-ink">…</div>
</div>
</section>
<div class="app-container space-y-8 py-8 sm:py-10">
<section class="app-surface p-5 sm:p-6">…</section>
</div>
Reference page
Tables, lists and guides
Blade
<x-page-header :title="__('ui.history.title')" :description="__('ui.history.subtitle')" :breadcrumbs="[__('ui.history.nav') => '']">
<x-slot:actions>…</x-slot:actions>
</x-page-header>
<div class="app-container space-y-8 py-8 sm:py-10">…</div>
Results
Lead with the answer in display type, restate it in one sentence, break it down, then offer actions. Announce changes through a polite live region.
Calculation result
Answer, summary, breakdown and actions
Total (incl. VAT)
€1,487.50
€1,250.00 plus 19% VAT in Germany
- Net amount
- €1,250.00
- VAT 19%
- + €237.50
Blade
<div class="grid max-w-3xl grid-cols-1 overflow-hidden rounded-card border border-line bg-surface md:grid-cols-2">
<div class="p-5">
<p class="font-display text-[0.8125rem] font-medium text-ink-muted">Total (incl. VAT)</p>
<div class="mt-1 flex items-end justify-between gap-3">
<p class="tabular font-display text-4xl font-semibold tracking-[-0.03em] text-ink">€1,487.50</p>
<button type="button" class="app-button-secondary h-9 min-h-9 px-3 text-xs" aria-label="Copy the calculation">
<x-ui.icon name="copy" class="size-3.5" />
Copy
</button>
</div>
<p class="mt-2 text-sm text-ink-muted">€1,250.00 plus 19% VAT in Germany</p>
</div>
<div class="border-t border-line bg-surface-subtle p-5 md:border-l md:border-t-0">
<dl class="divide-y divide-line rounded-control border border-line bg-surface text-sm">
<div class="flex items-center justify-between px-4 py-2.5">
<dt class="text-ink-muted">Net amount</dt>
<dd class="tabular font-semibold text-ink">€1,250.00</dd>
</div>
<div class="flex items-center justify-between px-4 py-2.5">
<dt class="text-ink-muted">VAT 19%</dt>
<dd class="tabular font-semibold text-action-deep">+ €237.50</dd>
</div>
</dl>
<button type="button" class="app-button-primary mt-4 h-10 min-h-10 w-full px-4">
<x-ui.icon name="share" class="size-4" />
Share result
</button>
</div>
</div>
Freshness and source
x-rate-freshness: the update date and the source, next to every rate
Blade
<div class="max-w-3xl space-y-4">
<x-rate-freshness updated="2026-10-01" />
<div class="hero-canvas rounded-card p-4">
<x-rate-freshness updated="2026-10-01" on-dark />
</div>
</div>
Country pages
Every country calculator is built from the same pieces: a heading on one grid with the content below, a rate reference that dates each rate, and common amounts that link their calculations.
Country heading
The flag beside the heading and the rate panel on the content edge, on paper
Kalkulačka DPH Germany
Jednoducho vypočítajte DPH pre transakcie v Germany. Aktuálna štandardná sadzba je 19%.
Členský štát EÚ
- Štandardná
- 19%
- Znížená
- 7%
- Mena
- EUR
Blade
{{-- On a country page the heading is the h1 and the trail is the page's breadcrumb; nested here it steps down. --}}
<x-calculator.country-header :country="\App\Support\DesignSystem\ComponentCatalog::sampleCountry()" :heading-level="4" breadcrumb-label="Example breadcrumb" />
Rate reference
Each rate with what it covers, its start date and the VAT number format
Sadzby DPH a vzorce pre Germany
Prehľad sadzieb
- Štandardná Štandardná sadzba sa uplatňuje na väčšinu tovarov a služieb. Platí od 1 jan 2021, predtým 16 %
- 19%
- Znížená Znížené sadzby sa v závislosti od krajiny vzťahujú na kategórie, ako sú potraviny, knihy, lieky alebo ubytovanie.
- 7%
- Mena
- EUR €
- Člen EÚ
- Áno
- Formát IČ DPH
- DE999999999
Prehľad výpočtov
Pripočítanie 19% DPH
Čistá suma × 1.19 = hrubá suma
100,00 € → 119,00 €
Odpočítanie 19% DPH
Hrubá suma ÷ 1.19 = čistá suma
100,00 € → 84,03 €
DPH obsiahnutú v cene s 19 % DPH zistíte tak, že cenu vynásobíte 19 a vydelíte 119.
Blade
<x-calculator.country-reference
:country="\App\Support\DesignSystem\ComponentCatalog::sampleCountry()"
:since="['since' => \Illuminate\Support\Carbon::parse('2021-01-01'), 'previous' => 16.0]"
/>
Common amounts
Every figure links its indexable calculation page
DPH z bežných súm: Germany
Pri základnej sadzbe 19 %. Otvorte sumu a uvidíte celý rozpis pripravený na zdieľanie.
| Suma | Po pripočítaní 19 % DPH | Po odpočítaní 19 % DPH |
|---|---|---|
| 100 € | +19,00 € 119,00 € | −15,97 € 84,03 € |
| 200 € | +38,00 € 238,00 € | −31,93 € 168,07 € |
| 500 € | +95,00 € 595,00 € | −79,83 € 420,17 € |
| 1 000 € | +190,00 € 1 190,00 € | −159,66 € 840,34 € |
| 2 500 € | +475,00 € 2 975,00 € | −399,16 € 2 100,84 € |
| 5 000 € | +950,00 € 5 950,00 € | −798,32 € 4 201,68 € |
| 10 000 € | +1 900,00 € 11 900,00 € | −1 596,64 € 8 403,36 € |
Blade
<x-calculator.common-amounts :country="\App\Support\DesignSystem\ComponentCatalog::sampleCountry()" />
Tiles and rows
Stat tiles summarise, link cards lead to tools, and list rows keep dates, names and figures in fixed columns.
Stat tiles
Status colour only on the icon
- Recorded changes
- 140
- Increases
- 111
- Decreases
- 29
- Scheduled
- 2
Blade
<div class="grid grid-cols-2 gap-3 lg:grid-cols-4">
@foreach([
['history', 'Recorded changes', '140', 'text-action'],
['trending-up', 'Increases', '111', 'text-danger'],
['trending-down', 'Decreases', '29', 'text-success'],
['clock', 'Scheduled', '2', 'text-warning'],
] as [$icon, $label, $value, $tone])
<div class="app-surface flex items-start gap-3 p-4">
<span class="flex size-9 shrink-0 items-center justify-center rounded-control bg-surface-muted {{ $tone }}" aria-hidden="true">
<x-ui.icon :name="$icon" class="size-4" />
</span>
<dl>
<dt class="font-display text-[0.8125rem] font-medium text-ink-muted">{{ $label }}</dt>
<dd class="tabular mt-0.5 font-display text-2xl font-semibold text-ink">{{ $value }}</dd>
</dl>
</div>
@endforeach
</div>
Link cards
An icon well, a title and one line
Blade
<ul class="grid grid-cols-1 gap-3 md:grid-cols-3">
@foreach([
['map', 'VAT map', 'Compare standard rates visually'],
['history', 'VAT history', 'Every recorded rate change'],
['code', 'VAT widget', 'Embed a calculator on your site'],
] as [$icon, $title, $text])
<li>
<a href="#tiles" class="app-surface pressable group flex h-full items-start gap-3 p-4 hover:border-line-strong">
<span class="flex size-9 shrink-0 items-center justify-center rounded-control bg-action-soft text-action" aria-hidden="true">
<x-ui.icon :name="$icon" class="size-4" />
</span>
<span>
<span class="block font-semibold text-ink group-hover:text-action">{{ $title }}</span>
<span class="mt-0.5 block text-sm text-ink-muted">{{ $text }}</span>
</span>
</a>
</li>
@endforeach
</ul>
List rows
Direction as an icon, a word for screen readers and a sign
-
Romania Standard
19% 21% Increase +2 pp -
Estonia Standard
22% 24% Increase +2 pp -
Luxembourg Standard
17% 16% Decrease −1 pp
Blade
<ol class="app-surface divide-y divide-line overflow-hidden">
@foreach([
['2025-08-01', 'RO', 'Romania', 19, 21],
['2025-07-01', 'EE', 'Estonia', 22, 24],
['2023-01-01', 'LU', 'Luxembourg', 17, 16],
] as [$date, $iso, $country, $old, $new])
<li class="flex flex-wrap items-center gap-x-4 gap-y-2 px-4 py-3.5 sm:flex-nowrap sm:px-5">
<time datetime="{{ $date }}" class="tabular w-24 shrink-0 text-sm text-ink-muted">{{ \Illuminate\Support\Carbon::parse($date)->format('j M Y') }}</time>
<div class="flex min-w-0 flex-1 items-center gap-3">
<x-ui.flag :iso="$iso" size="lg" class="h-5 w-[1.625rem]" />
<p class="flex min-w-0 flex-wrap items-center gap-2">
<span class="truncate font-semibold text-ink">{{ $country }}</span>
<span class="app-badge bg-surface-muted text-ink-muted">Standard</span>
</p>
</div>
<div class="flex shrink-0 items-center gap-3">
<span class="tabular text-sm text-ink-muted">
{{ $old }}%
<x-ui.icon name="arrow-right" class="inline size-3.5 align-[-2px] text-ink-quiet" />
<span class="font-semibold text-ink">{{ $new }}%</span>
</span>
<span @class(['tabular inline-flex min-w-16 items-center justify-end gap-0.5 text-xs font-semibold', 'text-danger' => $new > $old, 'text-success' => $new < $old])>
<x-ui.icon :name="$new > $old ? 'trending-up' : 'trending-down'" class="size-3.5" />
<span class="sr-only">{{ $new > $old ? 'Increase' : 'Decrease' }}</span>
{{ $new > $old ? '+' : '−' }}{{ abs($new - $old) }} pp
</span>
</div>
</li>
@endforeach
</ol>
States
Every async control has a loading state, every list an empty state with a next step, and every error says what happened and what to do.
Empty
A next step, not a dead end
No VAT rate changes match these filters
Try another country or rate type.
Blade
<div class="app-surface px-6 py-12 text-center">
<span class="mx-auto flex size-12 items-center justify-center rounded-control border border-line bg-surface-muted text-ink-quiet" aria-hidden="true">
<x-ui.icon name="search" class="size-5" />
</span>
<p class="mt-4 font-semibold text-ink">No VAT rate changes match these filters</p>
<p class="mt-1 text-sm text-ink-muted">Try another country or rate type.</p>
<button type="button" class="app-button-secondary mt-5">
<x-ui.icon name="x" class="size-4" />
Clear filters
</button>
</div>
Loading
Spinner plus aria-busy or a disabled button
Checking VIES…
Blade
<div class="flex flex-wrap items-center gap-6">
<p class="flex items-center gap-2 text-sm text-ink-muted">
<span class="block size-4 animate-spin rounded-full border-2 border-action/30 border-t-action" aria-hidden="true"></span>
Checking VIES…
</p>
<button type="button" class="app-button-primary" disabled aria-busy="true">
<span class="block size-4 animate-spin rounded-full border-2 border-white/30 border-t-white" aria-hidden="true"></span>
Validating
</button>
</div>
Success, outage and error
Outages are about the service, never the visitor
Valid VAT number
Registered for intra-EU trade in Germany.
VIES is temporarily unavailable
Showing the last stored result. Try again in a few minutes.
Not a valid VAT number
Check the digits or ask your customer to confirm their registration.
Blade
<div class="max-w-2xl space-y-3">
<div class="flex items-start gap-3 rounded-card border border-success/30 bg-success-soft p-4">
<x-ui.icon name="check-circle" class="mt-0.5 size-5 text-success" />
<div>
<p class="font-semibold text-ink">Valid VAT number</p>
<p class="text-sm text-ink-muted">Registered for intra-EU trade in Germany.</p>
</div>
</div>
<div class="flex items-start gap-3 rounded-card border border-warning/30 bg-warning-soft p-4">
<x-ui.icon name="alert-triangle" class="mt-0.5 size-5 text-warning" />
<div>
<p class="font-semibold text-ink">VIES is temporarily unavailable</p>
<p class="text-sm text-ink-muted">Showing the last stored result. Try again in a few minutes.</p>
</div>
</div>
<div class="flex items-start gap-3 rounded-card border border-danger/30 bg-danger-soft p-4">
<x-ui.icon name="x-circle" class="mt-0.5 size-5 text-danger" />
<div>
<p class="font-semibold text-ink">Not a valid VAT number</p>
<p class="text-sm text-ink-muted">Check the digits or ask your customer to confirm their registration.</p>
</div>
</div>
</div>
Calls to action
A flat graphite band with a white key and an outlined one, the only place white text appears outside code. Use one per page, after the content it follows from.
Graphite call to action
hero-canvas rounded-panel, once per page
Need VAT rate data in your app?
Every EU VAT rate through a free JSON API. No authentication required.
Blade
<div class="hero-canvas rounded-panel p-6 sm:p-8">
<div class="relative flex flex-col gap-5 md:flex-row md:items-center md:justify-between">
<div>
<p class="font-display text-xl font-semibold tracking-[-0.02em] text-white">Need VAT rate data in your app?</p>
<p class="mt-1.5 max-w-xl text-sm leading-6 text-white/80">Every EU VAT rate through a free JSON API. No authentication required.</p>
</div>
<div class="flex shrink-0 flex-wrap gap-3">
<button type="button" class="app-button-inverse">
<x-ui.icon name="code" class="size-4" />
View the API
</button>
<button type="button" class="app-button-on-brand">
<x-ui.icon name="database" class="size-4" />
EU VAT dataset
</button>
</div>
</div>
</div>
Storybook
Every example on this page is also a Storybook story, rendered from the same Blade file, so designers and developers can browse, theme-switch and audit components in isolation without the two ever drifting apart.
How the stories are made
-
Each example in
resources/views/styleguide/examplesis described once inComponentCatalog: its section, title, description and canvas. -
php artisan design-system:storybookrenders every example through Blade and writes one story file per section, plus the Design Tokens for the foundation pages. - Storybook 10.6.0 loads the production stylesheet and the site's Alpine components, with a light and dark switch and axe-core on every story.
- The test suite fails while the generated stories are out of date, so a change to an example, a component or the stylesheet always reaches Storybook.
Run it
Regenerate after changing an example or app.css; every deploy also publishes it at /storybook
Shell
yarn install
php artisan design-system:storybook
yarn storybook
yarn build-storybook
For AI agents
Everything on this page is also available in machine-readable form, generated from the same files the site is built from.
Design tokens
Colour, typography, radius, shadow, easing, duration and size tokens in the Design Tokens Community Group format 2025.10, with OKLCH values, hex fallbacks and dark-theme values under $extensions.
https://eu-vat.info/styleguide/design.tokens.json
DESIGN.md
The complete guide as Markdown: principles, every token and component recipe, patterns, accessibility rules and the checks the build enforces. Give it to your coding agent before it touches a template.
https://eu-vat.info/styleguide.md
Fetch both from a script
Plain HTTP, no key, CORS enabled
Shell
curl -s https://eu-vat.info/styleguide/design.tokens.json -o eu-vat-info.tokens.json
curl -s https://eu-vat.info/styleguide.md -o DESIGN.md
Quick start for agents
-
Use tokens only. Style with semantic utilities (
bg-surface,text-ink-muted,border-line,bg-action-soft,text-success) and theapp-*classes below. You must not use raw Tailwind palette colours (bg-blue-600),dark:variants, hex/rgb/oklch literals, default Tailwind shadows, blur, or gradient utilities in templates. -
Paper first. Pages sit on
workspacepaper. Tool heroes arehero-field(paper with the rate field);hero-canvasis the graphite band for code and calls to action, at most one per page. -
Pick the page skeleton. A tool page opens with
hero-field+<x-hero-backdrop />, a left-aligned heading and oneapp-surface-raisedcard. A reference page opens with<x-page-header>followed byapp-surfacecards insideapp-container. -
One primary key per view.
app-button-primaryfor it,app-button-secondaryorapp-button-ghostfor the rest;app-button-inverse/app-button-on-brandonly inside a graphitehero-canvasblock. -
Labels are plain. No eyebrows over headings, no tracked capitals, no small caps, no
uppercaseon labels, table heads or navigation. Labels are the display face at 0.8125rem, weight 500, sentence case,text-ink-muted. -
Text and numbers. Put every string in
lang/en/ui.phpand all 24 locales. Money goes throughApp\Support\Vat\Money::format, and every column or total of numbers usestabular. -
Before you commit, run
yarn build,php artisan testandvendor/bin/pint --test. The design tests run with the suite.
Rules and checks
The test suite fails the build when a template breaks one of these rules, naming the file, the line and the fix.
The build fails when a template
- uses a raw Tailwind palette colour
-
uses a
dark:variant -
writes a literal colour in a class or
styleattribute -
uses
backdrop-*blur utilities -
uses a gradient utility (
bg-linear-*,bg-radial-*,bg-conic-*,bg-gradient-*) - uses a default Tailwind shadow
-
uses a radius outside the scale (
rounded-md…rounded-3xlor an arbitraryrounded-[…]) -
makes a pill (
rounded-fulltogether with horizontal padding) -
writes an unescaped
@contextoutside a PHP block -
has an
<img>withoutalt -
adds inline
<svg>outside the icon and logo components
It also fails when a token, utility or component class in app.css is missing from DESIGN.md.
Do and don't
-
Do:
bg-surface,text-ink-muted,border-lineDon't:
bg-white,text-gray-500,border-gray-200 -
Do: Let tokens switch the theme
Don't:
dark:bg-slate-800 -
Do:
app-surface,app-popover,app-sticky-barDon't:
bg-white/70 backdrop-blur-xl -
Do: Paper
hero-field, or one graphitehero-canvasbandDon't:
bg-linear-to-r from-blue-600 to-violet-600 -
Do:
shadow-card,shadow-workflow,shadow-floatingDon't:
shadow-lg,shadow-xl, coloured glows -
Do:
rounded-control,rounded-card,rounded-panelDon't:
rounded-xl,rounded-[13px], pill buttons -
Do:
app-badge bg-success-soft text-successDon't:
rounded-full px-3 bg-green-100 -
Do: Labels in the display face, sentence case
Don't: Eyebrows,
uppercase,tracking-[0.08em], middle-dot meta strings -
Do:
bg-button text-whiteDon't:
bg-action text-white -
Do:
<x-ui.icon name="copy" />Don't: A new inline
<svg> -
Do: One
app-button-primaryper viewDon't: Several competing primary buttons
-
Do: The rate field from
<x-hero-backdrop />Don't: Photographs, illustrations or patterns behind a heading
-
Do: Status colour plus icon plus text
Don't: Colour alone to show state
Get a design system like this for your business
Tokens, accessible components and a living styleguide that your team and your AI agents can build with, set up for your brand on BusinessPress.