Příznaky+DTverse
ÚvodDesign systémŠablony
Příznaky+ · @flags-plus/uiv0

Design systém

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.

01 · Principy

Technický list, ne leták

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.

  • Bento kartaPrezentace funkcí a přehledů. Mono hlavička VERZÁLKAMI, hairline, text, vizuál na šedém podkladu se vzorem. Tvrdý stín 4 px.
  • Inverzní panelTechnické bloky: parametry, logy, běhy, výpisy. Černá lišta s mono titulkem nad bílým obsahem.
  • CardKlidná plocha s hairline rámečkem pro formuláře a běžný obsah. Bez stínu, ať nesoutěží s daty.
  • AkcentOranžová #ff5b1f jen pro tečky, aktivní stav, hover stín primárního tlačítka a jednu zvýrazněnou hodnotu. Nikdy jako plocha s textem.
  • Světlý motiv výchozíTmavý je volitelný přes data-theme="dark" (přepínač v hlavičce, volba v localStorage).
  • Radius 0Ostré rohy všude – karty, ovládací prvky i overlaye. Kulatá je jen tečka stavu.
02 · Tokeny

Barvy, písmo, stíny, vzory

Všechno jsou CSS proměnné na :root; Tailwind je čte přes @theme inline (bg-surface, text-muted, border-ink, shadow-hard…).

Barvy

Ž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.

--bg☼ #fafaf9 · ☾ #0c0c0bpozadí stránky
--surface☼ #ffffff · ☾ #131312karty, prvky
--surface-2☼ #f4f4f3 · ☾ #1a1a19podklad ilustrací, hover
--surface-3☼ #ebebe9 · ☾ #252523stisk
--text☼ #0a0a0a · ☾ #f0f0edtext
--text-2☼ #3b3b39 · ☾ #cfcfcbsekundární text
--text-muted☼ #686865 · ☾ #9d9d98popisky (AA)
--text-faint☼ #8f8f8b · ☾ #6b6b67jen dekorace
--line☼ #e5e5e3 · ☾ #262624hairline
--line-strong☼ #d1d1ce · ☾ #383835rámečky prvků
--ink☼ #1a1a1a · ☾ #75756fbento rámeček, stín
--inverse☼ #0a0a0a · ☾ #f0f0edlišta panelu, primární
--accent☼ #ff5b1f · ☾ #ff6a33hlavní akcent (vzácně)
--accent-text☼ #c2410c · ☾ #ff8c5eakcent jako text
--blue☼ #2350e6 · ☾ #7a95ffsekundární akcent, focus
--success☼ #2c7a4b · ☾ #6cc792stav OK
--warning☼ #92600a · ☾ #e3ac4avarování
--danger☼ #c0352b · ☾ #f2776fchyba
--info☼ #2350e6 · ☾ #93a9ffinformace

Typografická škála

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.

display · 76

Příznaky+

h1 · 44

Pravidla nad produkty

h2 · 32

Spouštěč, vykreslení, akce

h3 · 22

Banner na kartě produktu

h4 · 17 / 500

Titulek prvku

text lg · 18

Doplněk vykreslí štítek nebo banner přímo na kartě produktu.

text · 15

Výchozí text administrace. Délka řádku ideálně do 72 znaků.

text sm · 13

Nápověda, popisky a sekundární informace.

mono label · 11
Technické parametry

Stíny

Tvrdé, bez rozmazání. Hover u interaktivních karet stín zvětší a kartu posune; stisk ji „zamáčkne“.

--shadow-hard-sm · 2px
--shadow-hard · 4px
--shadow-hard-lg · 6px
--shadow-soft · šedý
hover primárního tlačítka
tsx
box-shadow: var(--shadow-hard);   /* 4px 4px 0 var(--shadow-color) */
className="shadow-hard"             /* Tailwind utilita */

Vzory ilustrací

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.

grid
dots
halftone
hatch
plain
tsx
<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" />

Tvar, pohyb, focus

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).

--radius: 0
--dur: 160ms
focus ring
03 · Layout

Mřížka a rytmus

Kontejnery, mřížka, stack a hlavičky. Mezery jsou na škále 4 px (gap 1–12).

Container

Šířky sm 640 · md 880 · lg 1200 · xl 1440 · full, boční odsazení 16 / 32 px.

Container sm
Container md
Container lg
tsx
<Container size="lg">…</Container>

Grid

Pevné sloupce (3/4/6 → 2 na tabletu → 1 na mobilu) nebo automatické plnění přes min.

cols 3 · 1
cols 3 · 2
cols 3 · 3
auto · 1
auto · 2
auto · 3
auto · 4
auto · 5
auto · 6
auto · 7
tsx
<Grid cols={3} gap={4}>…</Grid>
<Grid min="180px">…</Grid>

Stack a Divider

Svislý / vodorovný stack; Divider jako hairline, inkoustová linka nebo s mono popiskem.

jednadvětři


tsx
<Stack direction="row" gap={2}>…</Stack>
<Divider />  <Divider ink />  <Divider label="nebo" />

PageHeader

Hlavička stránky administrace: eyebrow, H1, popis, akce, pod ní hairline.

Projekt · arthas.cz

Pravidla

Co se zobrazí na kartách produktů a co se stane po kliknutí.

tsx
<PageHeader eyebrow="Projekt · arthas.cz" title="Pravidla"
  description="Co se zobrazí na kartách produktů."
  actions={<Button variant="primary" icon="plus">Nové pravidlo</Button>} />

Section

Sekce prezentačního webu a dokumentace: eyebrow, H2, perex, volitelně akce vpravo.

Funkce

Jedno pravidlo, tři kroky

Spouštěč vybere produkty, vykreslení určí, co se ukáže, akce co se stane po kliknutí.

tsx
<Section eyebrow="Funkce" title="Jedno pravidlo, tři kroky" lead="…" actions={…}>…</Section>
04 · Bento

Bento karty

Mono hlavička VERZÁLKAMI, hairline, titulek a text, vizuál na šedém podkladu. Ilustrace jsou jen CSS vzory a jednoduchá SVG.

Jednoduché a silné

01

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.

SPOUŠTĚČVYKRESLENÍAKCE

Rychlé na e-shopu

02

7,4 kB gzip, jeden request

Statický config.json z CDN, observer jen na přidané karty.

  • Core SDK7,4 kB
  • Průměr widgetů46 kB
Příznaky+srovnání

Všechny šablony

03

Funguje na 7 oficiálních šablonách

Adaptéry per šablona, testovací matice nad demo e-shopy Shoptetu.

Nasazení

snippet

Jeden řádek do Editoru šablon

Kontrola nasazení ověří, že se widget na e-shopu opravdu načítá.

shoptet · editor
<script src="https://cdn.dtverse.dev/p/arthas/widget.js" async></script>✓ widget nalezen na 3/3 stránkách

Banner 1 : 3 : 2

04

Layout ve sloupcích

Ikona, text a vypočtená cena z feedu.

1 : 3 : 2

Technické parametry

spec
Doručení
config.json · CDN
Události
pp:ready · pp:card:rendered
Režimy
Zobrazeno / Jen admin / Skryto
Stav
online

Analytika

05

Zobrazení pravidel za týden

Karta jako odkaz: hover stín vyroste, stisk kartu zamáčkne.

Typy akcí

06
  • OdpočetDo konce akce zbývá…
  • VoucherPřidat do košíku s kódem
  • CashbackVypočtená hodnota z ceny

API

pattern: grid · dots · halftone · hatch · plain · span 1–3 · rowSpan 1–2
tsx
<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>
05 · Typografie

Text, štítky a kód

Heading

level = velikost (display, 1–4), as = sémantika. Nadpisy ve váze 400, titulky prvků (4) 500.

Display

Heading 1

Heading 2

Heading 3

Heading 4

tsx
<Heading level="display">Příznaky+</Heading>
<Heading level={2} as="h1">Přehled</Heading>

Text a MonoLabel

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.

Technické parametryLatenceProjektNové
tsx
<Text size="lg" tone="muted">…</Text>
<MonoLabel dot>Latence</MonoLabel>
<MonoLabel tone="accent">Nové</MonoLabel>

Kbd a Code

Hledání: ⌘ K · selektor span.flag-vyprodej · klíč arthas-7f3a

tsx
Stiskněte <Kbd>⌘</Kbd> <Kbd>K</Kbd> · selektor <Code>span.flag-vyprodej</Code>

CodeBlock

Monochromní blok s lištou a tlačítkem Kopírovat (bez zvýrazňování syntaxe – záměrně).

snippet · hlavička e-shopu
<script src="https://cdn.dtverse.dev/p/arthas/widget.js" async></script>
tsx
<CodeBlock language="html" code={snippet} />

Terminal

Tmavý blok pro výstupy úloh, logy a ukázky příkazů. Řádek jako string = příkaz ($), { type: 'out' } = výstup.

worker · feed
pnpm feed:fetch arthas↓ stahuji XML feed (2,4 MB)…✓ 1 248 produktů · příznaky: vyprodej, novinka, tippnpm generate:config arthas
tsx
<Terminal title="worker · feed" cursor lines={[
  "pnpm feed:fetch arthas",
  { type: "out", text: "✓ 1 248 produktů, 3 příznaky" },
]} />
06 · Ikony

Ikony

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).

Všechny ikony (75)

overviewrulesproductsfeedsettingscogusersaccountshieldstorebuildingactivitylayerscolumnssunmooncloseplusminuschevronchevron-downchevron-upchevron-leftchevron-rightarrow-rightarrow-up-rightarrow-uparrow-downsortcopychecklogoutsearchmenumoreinfowarningerrorsuccesshelpuploaddownloadtrashediteyeeye-offexternalterminalcodebellcalendarclocktimerlinkmaillockfilterrefreshloadergripimagefilepalettesparklesglobetagcartticketpercentgifttruckstarheartzapclick
tsx
<Icon name="rules" />                 // dekorativní
<Icon name="warning" label="Varování" />  // s významem → role="img"
07 · Akce

Tlačítka

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.

Varianty × velikosti

sm
md
lg
tsx
<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>

S ikonou, jen ikona, načítání, zakázané

tsx
<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, block

tsx
<ButtonLink href="/pravidla" variant="primary" iconRight="arrow-up-right">Otevřít</ButtonLink>
<Button block>Přes celou šířku</Button>

ButtonGroup

Spojená skupina se sdílenými hranami. label je povinný (role=group).

tsx
<ButtonGroup label="Pořadí">
  <Button icon="arrow-up">Nahoru</Button>
  <Button icon="arrow-down">Dolů</Button>
</ButtonGroup>

CopyButton

Mono tlačítko pro lišty bloků; stav „Zkopírováno“ se oznámí čtečce (aria-live).

arthas-7f3a
tsx
<CopyButton value="arthas-7f3a" />
08 · Formuláře

Formuláře

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 a Input

Včetně https://
Zadejte platný e-mail.
tsx
<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>

Textarea, NativeSelect, Select

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.

Max. 80 znaků.
tsx
<Field label="Widget"><NativeSelect name="widgetMode">…</NativeSelect></Field>
<Field label="Widget"><Select name="mode" options={MODES} defaultValue="visible" /></Field>

Combobox

Vyhledávací výběr (ARIA combobox): filtruje bez ohledu na diakritiku, šipky / Enter / Esc. Pro výběr ikony, příznaku nebo produktu.

Nativní příznaky z feedu.
tsx
<Combobox aria-label="Ikona" name="icon" placeholder="Hledat ikonu…"
  options={ICON_NAMES.map((n) => ({ value: n, label: n, icon: n }))} />

Checkbox, RadioGroup, Switch

Checkbox
Radio
Switch
tsx
<Checkbox name="active" label="Aktivní" description="…" defaultChecked />
<RadioGroup name="action" variant="card" options={[…]} defaultValue="cart" />
<Switch name="enabled" label="Zapnuto" defaultChecked />

Slider a ColorPicker

ColorPicker: nativní kapátko + hex pole + swatche; odesílá hex v name.

Průhlednost pozadí90 %
Velikost písma13 px
tsx
<Slider label="Průhlednost" unit=" %" defaultValue={90} ticks={["0", "50", "100"]} />
<ColorPicker name="bg" defaultValue="#ff5b1f" />

FileInput, InputGroup, SearchInput

https://
Kč
tsx
<FileInput name="import" accept=".csv" />
<InputGroup prefix="https://" placeholder="www.eshop.cz" />
<InputGroup suffix="Kč" type="number" />
<SearchInput placeholder="Hledat produkt…" shortcut="/" />
09 · Data

Zobrazení dat

Čísla a technické hodnoty jsou v mono písmu s tabulkovými číslicemi. Barva jen ve stavech.

Panel

Inverzní lišta s mono titulkem. Pro parametry, logy, běhy úloh; flush pro tabulky a terminál.

Stav widgetu

před 2 min
Režim
Jen pro administrátory
Verze SDK
1.0.3
Šablona
template-13 · Disco
Nasazení
nalezeno

Poslední běhy feedu

ČasProduktůStav
19. 11. 06:001 248OK
18. 11. 06:001 244OK
17. 11. 06:00—HTTP 503
tsx
<Panel title="Stav widgetu" icon="activity" meta="před 2 min"
  actions={<IconButton icon="refresh" label="Obnovit" />}>
  <SpecList items={…} />
</Panel>

Card

variant: line (výchozí) · ink · hard · soft · dashed; s href je interaktivní.

line

Výchozí, hairline rámeček.

Obsah karty.

ink

Inkoustový rámeček.

hard

Tvrdý stín.

soft

Šedý offset.

dashed

Zástupné / připravované.

interaktivní (href)

Hover posune a přidá stín.

tsx
<Card title="Profil" description="…" footer={<Button variant="primary">Uložit</Button>}>…</Card>
<Card variant="hard" href="/pravidla/1" title="…" />

SpecList

Tabulka parametrů: popisek s tečkovaným podtržením vlevo, hodnota vpravo. stacked pro úzké sloupce.

Klíč projektu
arthas-7f3a
Feed
XML · každých 6 h
Produktů
1 248
Pravidel
5 aktivních / 7
Plán
trial
tsx
<SpecList items={[{ label: "Klíč projektu", value: "arthas-7f3a" }, …]} />

Table

Primitivy Table / Th / Td (num, muted, align) + CellStack pro dvouřádkové buňky.

ProduktPříznakySkladCena
Trekové boty Alpine GTXART-1040
Výprodej
122 490 Kč
Batoh Summit 32 lART-1047
Novinka
01 890 Kč
Funkční triko Merino 150ART-1054
—
48990 Kč
Spacák Polar −10 °CART-1061
Tip
33 290 Kč
tsx
<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>

DataTable

Ř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
25 990 Kč
Bunda Storm ShellART-1082
154 490 Kč
Spacák Polar −10 °CART-1061
33 290 Kč
Trekové boty Alpine GTXART-1040
122 490 Kč
Hůlky Carbon ProART-1075
72 190 Kč
1–5 z 18
PravidloProduktů

Zatím žádná pravidla

Vytvořte první pravidlo a vyberte, na kterých produktech se zobrazí.

tsx
<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 } }))} />

Stat a StatRow

Produktů ve feedu1 248dnes 06:00
Aktivní pravidla5/ 7
Zobrazení za 7 dní18,2tis.▲ 12 %vs. minulý týden
Chyby feedu1▼ 117. 11.
tsx
<StatRow>
  <Stat label="Produktů" value="1 248" hint="z feedu" />
  <Stat label="Zobrazení" value="18,2" unit="tis." delta="12 %" trend="up" />
</StatRow>

BarMeter a Progress

Černý pruh = aktuální, světle šedý = srovnání; tone accent / blue jen pro jednu zvýrazněnou hodnotu.

  • p50 vykreslení38 ms
  • p50 průměr120 ms
  • p95 vykreslení74 ms
  • p95 průměr260 ms
  • první karta12 ms
Příznaky+průměr widgetů
Generování config.json64 %
Využití pravidel (3 / 5)60 %
Stahování feedu40 %
Hotovo
tsx
<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, Tag, StatusDot

neutralaccentsuccesswarningdangerinfoinverseoutlinesolid-accent
VýprodejNovinkaTipDoprava zdarmabez odebrání
neutralonlinečekáchybainfoběží
tsx
<Badge tone="success" dot>Zobrazeno</Badge>
<Badge tone="solid-accent">Nové</Badge>
<Tag onRemove={() => …}>Výprodej</Tag>
<StatusDot tone="success" pulse>online</StatusDot>

Avatar

Čtverec s iniciálami (nebo obrázkem); AvatarStack pro skupinu.

David NovákDavid NovákEva Malápetr@eshop.czJana KrátkáOta DlouhýIva Nová
tsx
<Avatar name="David Novák" />
<AvatarStack><Avatar name="A B" /><Avatar name="C D" inverse /></AvatarStack>

EmptyState, Skeleton, Spinner

Feed zatím není napojený

Vložte URL XML feedu ze Shoptetu a stáhněte první data.

NačítámNačítám
tsx
<EmptyState glyph="◇" title="…" description="…" actions={…} />
<Skeleton lines={3} />  <Spinner size={20} />

FeatureList

Řádky s geometrickým glyfem (◇ ◆ ● ◐ ◊ ▣) nebo ikonou; aktivní řádek má tmavší rámeček a tečku akcentu.

  • SpouštěčPříznak Výprodej nebo ruční výběr
  • VykresleníBanner 1:3:2 na kartě
  • AkceDo košíku s voucherem
  • VzhledBarvy a pozice
tsx
<FeatureList items={[{ glyph: "◇", title: "Spouštěč", description: "…" },
  { glyph: "◆", title: "Vykreslení", active: true }]} />

Alert

Tón danger má role=alert, ostatní role=status. Notice je alias (přijímá i ok / error).

Režim jen pro administrátory

Widget vidí jen přihlášený správce e-shopu.
Nastavení uloženo.

Snippet nenalezen

Na úvodní stránce e-shopu jsme widget nenašli.
Neutrální poznámka s inkoustovým okrajem.
tsx
<Alert tone="warning" title="Snippet nenalezen" action={<Button size="sm">Zkontrolovat</Button>}>…</Alert>
09.1 · Hub

Dashboard a nastavení

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ů.

WidgetTile

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.

Příznaky+

upozornění
Tariffree
  • Pravidla12 / 1 000
  • Ruční výběr100 000 / 100 000
Pravidla
12
10 zapnuto
Produkty
48 210
Varování
2
Režim
admin
Zdroj
feed
Sync
15 min
  • Poslední build má 2 varování.

Příznaky+

zapnuto

Bannery na kartách produktů.

Tariffree

Příznaky+

Příznaky+

bez dat

Data modulu nejsou k dispozici.

tsx
<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={…} />

SetupChecklist

Kroky ◇ / ◆ s průběhem. Nehotový krok s odkazem je klikatelný, další krok je zvýrazněný akcentem; volitelný krok má štítek.

Začínáme

Hotovo 2 z 4
  1. Firemní údajeFakturační e-mail projektu.hotovo
  2. URL e-shopuAdresa e-shopu pro snímek vzhledu a identitu.hotovo
  3. Zapnout modulVyberte modul z katalogu.čeká
  4. Pozvat koleguvolitelnéČlenové projektu a jejich role.čeká
tsx
<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 },
]} />

FormSection

Sekce nastavení: popis vlevo, pole vpravo, tlačítko Uložit patří do sekce. Na mobilu pod sebou.

Projekt

Název projektu vidí všichni členové.

Firemní údaje

Povinný je jen fakturační e-mail, ostatní údaje doplníte později.
tsx
<FormSection title="Firemní údaje" description="Povinný je jen fakturační e-mail.">
  <form>…<Button type="submit">Uložit</Button></form>
</FormSection>
11 · Overlay

Overlay

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

tsx
<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>

ConfirmDialog

Potvrzení destruktivní akce (AlertDialog). V aplikaci onConfirm odešle formulář přes formRef.current.requestSubmit().

tsx
<ConfirmDialog trigger={<Button variant="danger">Odebrat</Button>}
  title="Odebrat jan@eshop.cz?" confirmLabel="Odebrat" onConfirm={() => formRef.current?.requestSubmit()} />

Sheet / Drawer

Vysouvací panel pro editaci a detail; side right (na mobilu přes celou šířku), left, bottom.

tsx
<Sheet>
  <SheetTrigger asChild><Button>Upravit</Button></SheetTrigger>
  <SheetContent title="…" description="…" side="right" footer={…}>…</SheetContent>
</Sheet>

DropdownMenu, Popover, Tooltip

Tooltip nesmí být jediným nositelem informace (dotyková zařízení).

tsx
<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>

Toast

ToastProvider jednou v layoutu, pak const toast = useToast(); toast({ title, description, tone }).

    tsx
    const toast = useToast();
    toast({ title: "Nastavení uloženo", tone: "success" });
    12 · Produkt

    Prvky pro pravidla

    Specifické komponenty editoru pravidel. Vykreslení na kartě dodá SDK – CardPreview je jen rám se sloty.

    CardPreview

    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.

    Náhled karty produktutemplate-13 · Disco
    Výprodej
    Sleva s kódem VYPRODEJ
    1 121 Kč

    Trekové boty Alpine GTX

    Skladem
    1 245 Kč2 490 Kč
    slot: image-bottom
    tsx
    <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>

    RatioPicker

    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“.

    Vlastní poměr, např. 1:3:2

    Hodnota: 1 : 3 : 2

    tsx
    <RatioPicker value={ratio} onChange={setRatio} columnLabels={["ikona", "text", "cena"]} name="ratio" />

    IconTile a IconGrid

    Výběr ikony bloku nebo typu akce; vybraná dlaždice má tvrdý stín a tečku akcentu (aria-pressed).

    Vybráno: percent

    tsx
    <IconGrid>
      {icons.map((n) => <IconTile key={n} icon={n} label={n} selected={sel === n} onClick={() => setSel(n)} />)}
    </IconGrid>
    13 · Šablony

    Ukázkové stránky

    Celé obrazovky poskládané z komponent. Statická data, žádné napojení na server.