Všichni průvodci › Podle použití

Vaše data patří vám: otevřené formáty běhů a návrhů

Každý běh i každá verze designu odchází z Kaloka jako obyčejné soubory: HTML, CSS, obrázky, tokeny W3C DTCG, scénáře v YAML a plachta, která se otevře z disku.

Kaloko nic neukládá ve formátu, který umí číst jen Kaloko. Běh, verzi designu i celý koncept vyexportujete jako složku nebo zip. Otevřete ho z disku, dáte do gitu, předáte jinému nástroji, nebo si ho necháte, i když od nás odejdete.

Problém

Designové nástroje ukládají práci do vlastních formátů. Obrazovky, tokeny i historie se dají číst jen uvnitř nástroje, a kdo odejde, kreslí znovu. Testovací nástroje zase drží důkazy za svým vlastním prohlížečem.

Co se s Kalokem změní

• Návrhy jsou obyčejné webové soubory. Krok je index.html se svým CSS, JS, fonty a obrázky ve složce. Tokeny jsou W3C Design Tokens (DTCG) v JSON. Flow je soubor qawalk.scenario.v1 v YAML.
• Exporty se otevřou z disku. kaloko export --design zapíše verzi jako takovou složku se snímky a úvodní stránkou; odkazy mezi kroky fungují ze složky i ze zipu, bez serveru.
• Běhy si plachtu nesou s sebou. kaloko export --run <id> stáhne běh jako zip: run.json, všechny snímky a HTML, živé HTML designových kroků, komentáře a verdikty a index.html, tedy samotnou plachtu, která funguje offline.
• Nejste na nás závislí. Pravidla přenosného HTML (kaloko design lint) drží návrhy bez CDN, úložišť a absolutních adres, takže tytéž soubory běží v Kaloku, z disku i v jiném nástroji.

Jak to funguje

1. Držte návrhy přenosné.

   Spusťte v projektu kaloko design lint; spouští ho i kaloko sync a zastaví se na všem, co by se rozbilo.

2. Vyexportujte verzi designu.

   kaloko export --design --version 4 --out checkout-v4.zip (nebo --draft, výchozí je reference designu).

3. Otevřete ji.

   Rozbalte a otevřete index.html: kroky v pořadí flow, stránka každého jazyka, snímky, tokens.json a scenario.yml.

4. Vyexportujte běh.

   kaloko export --run 2026-10-02-checkout-1a2b stáhne zip; index.html v něm otevře celou plachtu offline.

5. Použijte soubory dál.

   Dejte složku do gitu, tokens.json předejte Style Dictionary nebo jinému nástroji pro DTCG, scenario.yml ověřte příkazem kaloko validate nebo z něj začněte nový koncept.

Skilly a prompty

Vyexportuj přijatý design checkoutu jako zip přes kaloko export --design a přilož ho k issue s vydáním.

Zkontroluj složku s designem přes kaloko design lint a oprav všechny chyby a varování, než ji synchronizuješ.

Jak to vypadá

Export verze v4 je složka: cart/index.html, cart/cs/index.html, _shared/app.css, tokens.json, scenario.yml, screenshots/cart/en/desktop.webp, kaloko.json a index.html. Dvakrát klikněte na index.html, otevřete krok, klikněte na *Zaplatit*: další krok se otevře rovnou z disku.

Co získáte

• návrhy a důkazy ve formátech, které přečte každý nástroj dnes i za pár let
• offline kopii každého běhu dřív, než vyprší
• prototypy, které fungují v Kaloku, ze zipu i v jiných nástrojích

Otázky

Další průvodci