Jednoduché a silné
Pravidlo = spouštěč + vykreslení + akce
Žádné pevné šablony. Bloky se skládají, takže stejné pravidlo umí štítek, banner i akci do košíku.
Všechny komponenty administrace i prezentačního webu ve všech variantách, s ukázkou kódu. Světlý motiv je výchozí, tmavý přepnete ikonou v hlavičce.
Systém vychází z estetiky technických specifikací: téměř bílá plocha, černý inkoust, ostré rohy a tvrdé stíny. Barva je signál, ne dekorace.
Všechno jsou CSS proměnné na :root; Tailwind je čte přes @theme inline (bg-surface, text-muted, border-ink, shadow-hard…).
Živý vzorek odpovídá aktuálnímu motivu, vedle hodnoty pro světlý a tmavý. Text --text-muted splňuje kontrast 4,5 : 1 na obou plochách.
Inter pro text a nadpisy (nadpisy ve váze 400, záporný letter-spacing), IBM Plex Mono pro štítky, čísla a kód. Obě písma self-host, licence SIL OFL 1.1.
Doplněk vykreslí štítek nebo banner přímo na kartě produktu.
Výchozí text administrace. Délka řádku ideálně do 72 znaků.
Nápověda, popisky a sekundární informace.
Tvrdé, bez rozmazání. Hover u interaktivních karet stín zvětší a kartu posune; stisk ji „zamáčkne“.
box-shadow: var(--shadow-hard); /* 4px 4px 0 var(--shadow-color) */
className="shadow-hard" /* Tailwind utilita */Podklad vizuálu bento karet, prázdných stavů a jeviště náhledu. Třídy .ui-pattern-* nebo Tailwind bg-grid-paper / bg-dots / bg-halftone / bg-hatch.
<div className="ui-pattern-grid" /> // milimetrový papír
<div className="ui-pattern-dots" /> // tečkový rastr
<div className="ui-pattern-halftone" />
<div className="ui-pattern-hatch" />Radius 0 (--radius). Pohyb 160 ms, křivka cubic-bezier(.2,.8,.2,1); prefers-reduced-motion animace vypne. Focus = 2px modrý obrys s odsazením, viditelný na všech prvcích (zkuste Tab).
Kontejnery, mřížka, stack a hlavičky. Mezery jsou na škále 4 px (gap 1–12).
Šířky sm 640 · md 880 · lg 1200 · xl 1440 · full, boční odsazení 16 / 32 px.
<Container size="lg">…</Container>Pevné sloupce (3/4/6 → 2 na tabletu → 1 na mobilu) nebo automatické plnění přes min.
<Grid cols={3} gap={4}>…</Grid>
<Grid min="180px">…</Grid>Svislý / vodorovný stack; Divider jako hairline, inkoustová linka nebo s mono popiskem.
<Stack direction="row" gap={2}>…</Stack>
<Divider /> <Divider ink /> <Divider label="nebo" />Hlavička stránky administrace: eyebrow, H1, popis, akce, pod ní hairline.
Co se zobrazí na kartách produktů a co se stane po kliknutí.
<PageHeader eyebrow="Projekt · arthas.cz" title="Pravidla"
description="Co se zobrazí na kartách produktů."
actions={<Button variant="primary" icon="plus">Nové pravidlo</Button>} />Sekce prezentačního webu a dokumentace: eyebrow, H2, perex, volitelně akce vpravo.
Spouštěč vybere produkty, vykreslení určí, co se ukáže, akce co se stane po kliknutí.
<Section eyebrow="Funkce" title="Jedno pravidlo, tři kroky" lead="…" actions={…}>…</Section>Mono hlavička VERZÁLKAMI, hairline, titulek a text, vizuál na šedém podkladu. Ilustrace jsou jen CSS vzory a jednoduchá SVG.
Pravidlo = spouštěč + vykreslení + akce
Žádné pevné šablony. Bloky se skládají, takže stejné pravidlo umí štítek, banner i akci do košíku.
7,4 kB gzip, jeden request
Statický config.json z CDN, observer jen na přidané karty.
Funguje na 7 oficiálních šablonách
Adaptéry per šablona, testovací matice nad demo e-shopy Shoptetu.
Jeden řádek do Editoru šablon
Kontrola nasazení ověří, že se widget na e-shopu opravdu načítá.
<script src="https://cdn.dtverse.dev/p/arthas/widget.js" async></script>✓ widget nalezen na 3/3 stránkách
Layout ve sloupcích
Ikona, text a vypočtená cena z feedu.
Zobrazení pravidel za týden
Karta jako odkaz: hover stín vyroste, stisk kartu zamáčkne.
<BentoGrid cols={3}>
<BentoCard label="Jednoduché a silné" meta="01"
title="Pravidlo = spouštěč + vykreslení + akce"
visual={<NodesIllo />} pattern="grid" index={0}>
Žádné pevné šablony…
</BentoCard>
<BentoCard span={2} bleed pattern="plain" visual={<Terminal … />} />
<BentoCard href="/pravidla" shadow="soft" /> {/* soft | hard | none */}
</BentoGrid>level = velikost (display, 1–4), as = sémantika. Nadpisy ve váze 400, titulky prvků (4) 500.
<Heading level="display">Příznaky+</Heading>
<Heading level={2} as="h1">Přehled</Heading>Text: size sm / md / lg, tone default / secondary / muted. MonoLabel: verzálky s rozpalem, volitelně tečka akcentu.
Velký perex pro úvod sekce.
Běžný text. Doplněk jen vykresluje, slevy a vouchery řeší Shoptet.
Sekundární text.
Malý tlumený text pro nápovědu.
<Text size="lg" tone="muted">…</Text>
<MonoLabel dot>Latence</MonoLabel>
<MonoLabel tone="accent">Nové</MonoLabel>Hledání: ⌘ K · selektor span.flag-vyprodej · klíč arthas-7f3a
Stiskněte <Kbd>⌘</Kbd> <Kbd>K</Kbd> · selektor <Code>span.flag-vyprodej</Code>Monochromní blok s lištou a tlačítkem Kopírovat (bez zvýrazňování syntaxe – záměrně).
<script src="https://cdn.dtverse.dev/p/arthas/widget.js" async></script><CodeBlock language="html" code={snippet} />Tmavý blok pro výstupy úloh, logy a ukázky příkazů. Řádek jako string = příkaz ($), { type: 'out' } = výstup.
pnpm feed:fetch arthas↓ stahuji XML feed (2,4 MB)…✓ 1 248 produktů · příznaky: vyprodej, novinka, tippnpm generate:config arthas
<Terminal title="worker · feed" cursor lines={[
"pnpm feed:fetch arthas",
{ type: "out", text: "✓ 1 248 produktů, 3 příznaky" },
]} />Sada lucide (licence ISC), tenký obrys 1,5 px, velikost 16–20 px podle kontextu. Názvy jsou sémantické – kód stránek neřeší kresbu. Ikony pro vykreslení pravidel na e-shopu jsou samostatná otevřená sada (řeší SDK).
<Icon name="rules" /> // dekorativní
<Icon name="warning" label="Varování" /> // s významem → role="img"Primární je černé (inverzní) a při hoveru „vystoupí“ s tvrdým stínem v akcentu. Na stránce nejvýš jedno primární tlačítko na akci.
<Button variant="primary">Uložit</Button>
<Button>Zrušit</Button> // secondary (výchozí)
<Button variant="ghost" size="sm">Více</Button>
<Button variant="danger" icon="trash">Smazat</Button>
<Button variant="link">Zobrazit log</Button><Button variant="primary" icon="plus">Nové pravidlo</Button>
<Button iconRight="arrow-right">Pokračovat</Button>
<Button variant="primary" loading>Ukládám</Button>
<Button disabled>Nedostupné</Button>
<IconButton icon="edit" label="Upravit" />
<IconButton icon="more" label="Další akce" variant="outline" /><ButtonLink href="/pravidla" variant="primary" iconRight="arrow-up-right">Otevřít</ButtonLink>
<Button block>Přes celou šířku</Button>Spojená skupina se sdílenými hranami. label je povinný (role=group).
<ButtonGroup label="Pořadí">
<Button icon="arrow-up">Nahoru</Button>
<Button icon="arrow-down">Dolů</Button>
</ButtonGroup>Mono tlačítko pro lišty bloků; stav „Zkopírováno“ se oznámí čtečce (aria-live).
arthas-7f3a<CopyButton value="arthas-7f3a" />Field propojí popisek, nápovědu a chybu s prvkem (id, aria-describedby, aria-invalid). Všechny prvky fungují v nativním formuláři se server actions (name).
<Field label="URL e-shopu" hint="Včetně https://" required>
<Input name="eshopUrl" type="url" placeholder="https://www.eshop.cz" />
</Field>
<Field label="E-mail" error="Zadejte platný e-mail."><Input name="email" /></Field>
<Field label="Poznámka" optional><Input size="sm" /></Field>NativeSelect pro jednoduché formuláře a auto-odeslání; Select (Radix) s vlastním seznamem – s name odesílá hodnotu i v nativním formuláři.
<Field label="Widget"><NativeSelect name="widgetMode">…</NativeSelect></Field>
<Field label="Widget"><Select name="mode" options={MODES} defaultValue="visible" /></Field>Vyhledávací výběr (ARIA combobox): filtruje bez ohledu na diakritiku, šipky / Enter / Esc. Pro výběr ikony, příznaku nebo produktu.
<Combobox aria-label="Ikona" name="icon" placeholder="Hledat ikonu…"
options={ICON_NAMES.map((n) => ({ value: n, label: n, icon: n }))} /><Checkbox name="active" label="Aktivní" description="…" defaultChecked />
<RadioGroup name="action" variant="card" options={[…]} defaultValue="cart" />
<Switch name="enabled" label="Zapnuto" defaultChecked />ColorPicker: nativní kapátko + hex pole + swatche; odesílá hex v name.
<Slider label="Průhlednost" unit=" %" defaultValue={90} ticks={["0", "50", "100"]} />
<ColorPicker name="bg" defaultValue="#ff5b1f" /><FileInput name="import" accept=".csv" />
<InputGroup prefix="https://" placeholder="www.eshop.cz" />
<InputGroup suffix="Kč" type="number" />
<SearchInput placeholder="Hledat produkt…" shortcut="/" />Čísla a technické hodnoty jsou v mono písmu s tabulkovými číslicemi. Barva jen ve stavech.
Inverzní lišta s mono titulkem. Pro parametry, logy, běhy úloh; flush pro tabulky a terminál.
| Čas | Produktů | Stav |
|---|---|---|
| 19. 11. 06:00 | 1 248 | OK |
| 18. 11. 06:00 | 1 244 | OK |
| 17. 11. 06:00 | — | HTTP 503 |
<Panel title="Stav widgetu" icon="activity" meta="před 2 min"
actions={<IconButton icon="refresh" label="Obnovit" />}>
<SpecList items={…} />
</Panel>variant: line (výchozí) · ink · hard · soft · dashed; s href je interaktivní.
Výchozí, hairline rámeček.
Inkoustový rámeček.
Tvrdý stín.
Šedý offset.
Zástupné / připravované.
Hover posune a přidá stín.
<Card title="Profil" description="…" footer={<Button variant="primary">Uložit</Button>}>…</Card>
<Card variant="hard" href="/pravidla/1" title="…" />Tabulka parametrů: popisek s tečkovaným podtržením vlevo, hodnota vpravo. stacked pro úzké sloupce.
<SpecList items={[{ label: "Klíč projektu", value: "arthas-7f3a" }, …]} />Primitivy Table / Th / Td (num, muted, align) + CellStack pro dvouřádkové buňky.
| Produkt | Příznaky | Sklad | Cena |
|---|---|---|---|
Trekové boty Alpine GTXART-1040 | Výprodej | 12 | 2 490 Kč |
Batoh Summit 32 lART-1047 | Novinka | 0 | 1 890 Kč |
Funkční triko Merino 150ART-1054 | — | 48 | 990 Kč |
Spacák Polar −10 °CART-1061 | Tip | 3 | 3 290 Kč |
<Table><thead><tr><Th>Produkt</Th><Th align="right">Cena</Th></tr></thead>
<tbody><tr><Td><CellStack primary="…" secondary="ART-1040" /></Td><Td num align="right">2 490 Kč</Td></tr></tbody>
</Table>Řazení kliknutím na hlavičku (aria-sort), stránkování na klientu, prázdný stav. Buňky jsou ReactNode → lze předat ze serverové komponenty.
Stan Ridge 2PART-1096 | 2 | 5 990 Kč |
Bunda Storm ShellART-1082 | 15 | 4 490 Kč |
Spacák Polar −10 °CART-1061 | 3 | 3 290 Kč |
Trekové boty Alpine GTXART-1040 | 12 | 2 490 Kč |
Hůlky Carbon ProART-1075 | 7 | 2 190 Kč |
| Pravidlo | Produktů |
|---|---|
Zatím žádná pravidla Vytvořte první pravidlo a vyberte, na kterých produktech se zobrazí. | |
<DataTable pageSize={5} defaultSort={{ key: "price", dir: "desc" }}
columns={[{ key: "name", header: "Produkt", sortable: true },
{ key: "price", header: "Cena", sortable: true, align: "right", num: true }]}
rows={products.map((p) => ({ id: p.id, cells: { name: p.name, price: czk(p.price) },
sort: { price: p.price } }))} /><StatRow>
<Stat label="Produktů" value="1 248" hint="z feedu" />
<Stat label="Zobrazení" value="18,2" unit="tis." delta="12 %" trend="up" />
</StatRow>Černý pruh = aktuální, světle šedý = srovnání; tone accent / blue jen pro jednu zvýrazněnou hodnotu.
<BarMeter unit=" ms" legend={{ current: "Příznaky+", compare: "průměr" }}
items={[{ label: "p50", value: 38 }, { label: "p50 průměr", value: 120, tone: "compare" }]} />
<Progress value={64} label="Generování config.json" /><Badge tone="success" dot>Zobrazeno</Badge>
<Badge tone="solid-accent">Nové</Badge>
<Tag onRemove={() => …}>Výprodej</Tag>
<StatusDot tone="success" pulse>online</StatusDot>Čtverec s iniciálami (nebo obrázkem); AvatarStack pro skupinu.
<Avatar name="David Novák" />
<AvatarStack><Avatar name="A B" /><Avatar name="C D" inverse /></AvatarStack>Feed zatím není napojený
Vložte URL XML feedu ze Shoptetu a stáhněte první data.
<EmptyState glyph="◇" title="…" description="…" actions={…} />
<Skeleton lines={3} /> <Spinner size={20} />Řádky s geometrickým glyfem (◇ ◆ ● ◐ ◊ ▣) nebo ikonou; aktivní řádek má tmavší rámeček a tečku akcentu.
<FeatureList items={[{ glyph: "◇", title: "Spouštěč", description: "…" },
{ glyph: "◆", title: "Vykreslení", active: true }]} />Tón danger má role=alert, ostatní role=status. Notice je alias (přijímá i ok / error).
Režim jen pro administrátory
Snippet nenalezen
Stažení feedu selhalo
<Alert tone="warning" title="Snippet nenalezen" action={<Button size="sm">Zkontrolovat</Button>}>…</Alert>Dlaždice modulů skládá hub z dat modulu (modul nedodává komponentu). Průvodce prvními kroky zmizí po splnění povinných kroků.
Varianty data / generic / loading / unavailable. Stav jako StatusDot, tarif s využitím limitů (plný limit = akcent), metriky 2 × 3, upozornění, verze a CTA.
<WidgetTile name="Příznaky+" icon="rules" status="warning"
plan={{ name: "free", usage: [{ label: "Pravidla", used: 12, limit: 1000 }] }}
metrics={[{ label: "Pravidla", value: 12 }, …]} version="config 14"
cta={{ label: "Otevřít", href: "/priznaky" }} alerts={[{ level: "warning", text: "…" }]} />
<WidgetTile variant="generic" name="Příznaky+" plan={{ name: "free" }} statusLabel="zapnuto" cta={…} />
<WidgetTile variant="loading" name="Příznaky+" />
<WidgetTile variant="unavailable" name="Příznaky+" cta={…} />Kroky ◇ / ◆ s průběhem. Nehotový krok s odkazem je klikatelný, další krok je zvýrazněný akcentem; volitelný krok má štítek.
<SetupChecklist steps={[
{ title: "Fakturační e-mail", done: true },
{ title: "URL e-shopu", href: "/nastaveni/eshop", done: false },
{ title: "Pozvat kolegu", optional: true, done: false },
]} />Sekce nastavení: popis vlevo, pole vpravo, tlačítko Uložit patří do sekce. Na mobilu pod sebou.
<FormSection title="Firemní údaje" description="Povinný je jen fakturační e-mail.">
<form>…<Button type="submit">Uložit</Button></form>
</FormSection>Radix primitivy bez výchozího vzhledu: 1px inkoustový rámeček, tvrdý stín, inverzní lišta. Fokus je uvězněn v dialogu, Esc zavírá.
<Dialog>
<DialogTrigger asChild><Button variant="primary">Nové pravidlo</Button></DialogTrigger>
<DialogContent eyebrow="Pravidlo" title="Nové pravidlo" description="…"
footer={<DialogClose asChild><Button variant="primary">Vytvořit</Button></DialogClose>}>
…
</DialogContent>
</Dialog>Potvrzení destruktivní akce (AlertDialog). V aplikaci onConfirm odešle formulář přes formRef.current.requestSubmit().
<ConfirmDialog trigger={<Button variant="danger">Odebrat</Button>}
title="Odebrat jan@eshop.cz?" confirmLabel="Odebrat" onConfirm={() => formRef.current?.requestSubmit()} />Vysouvací panel pro editaci a detail; side right (na mobilu přes celou šířku), left, bottom.
<Sheet>
<SheetTrigger asChild><Button>Upravit</Button></SheetTrigger>
<SheetContent title="…" description="…" side="right" footer={…}>…</SheetContent>
</Sheet>Tooltip nesmí být jediným nositelem informace (dotyková zařízení).
<DropdownMenu>
<DropdownMenuTrigger asChild><IconButton icon="more" label="Akce" /></DropdownMenuTrigger>
<DropdownMenuContent align="end">
<DropdownMenuItem icon="edit" shortcut="E">Upravit</DropdownMenuItem>
<DropdownMenuSeparator />
<DropdownMenuItem icon="trash" danger>Smazat</DropdownMenuItem>
</DropdownMenuContent>
</DropdownMenu>
<Tooltip content="Zkopíruje klíč"><IconButton icon="copy" label="Kopírovat" /></Tooltip>ToastProvider jednou v layoutu, pak const toast = useToast(); toast({ title, description, tone }).
const toast = useToast();
toast({ title: "Nastavení uloženo", tone: "success" });Specifické komponenty editoru pravidel. Vykreslení na kartě dodá SDK – CardPreview je jen rám se sloty.
Rám živého náhledu karty produktu. Karta má záměrně neutrální „e-shopový“ vzhled. children = vykreslené pravidlo ve zvoleném slotu, bez children čárkovaný zástupný prostor.
Trekové boty Alpine GTX
Skladem<CardPreview meta="template-13 · Disco" flags={["Výprodej"]} slot="image-bottom"
product={{ name: "Trekové boty", price: "1 245 Kč", priceBefore: "2 490 Kč" }}>
<RuleBanner />
</CardPreview>Volba poměru sloupců banneru: předvolby, vlastní zápis (1–4 čísla 1–12) a velký náhled. S name odešle např. „1:3:2“.
Hodnota: 1 : 3 : 2
<RatioPicker value={ratio} onChange={setRatio} columnLabels={["ikona", "text", "cena"]} name="ratio" />Výběr ikony bloku nebo typu akce; vybraná dlaždice má tvrdý stín a tečku akcentu (aria-pressed).
Vybráno: percent
<IconGrid>
{icons.map((n) => <IconTile key={n} icon={n} label={n} selected={sel === n} onClick={() => setSel(n)} />)}
</IconGrid>Celé obrazovky poskládané z komponent. Statická data, žádné napojení na server.
Přihlašovací karta
Formulář vlevo, technický panel vpravo.
Dashboard projektu
KPI, stav widgetu, běhy feedu, upozornění.
Produkty z feedu
Hledání, filtr příznaku, hromadné přiřazení.
Nastavení + živý náhled
Spouštěč → layout → bloky → akce → vzhled.