Konfigurační soubor
kaloko.config.yml leží v kořeni repozitáře a říká CLI, kde vaše flow běží. kaloko init ho vytvoří i s komentáři, kaloko doctor ho zkontroluje. Jeho formát je qawalk.config.v1 a povinné jsou schema, org a environments.
schema: qawalk.config.v1
org: acme
project: shop
scenarios: [qa/flows/*.yml]
environments:
local:
base_url: http://localhost:3000
staging:
base_url: https://staging.acme.test
access:
basic: { user_env: STAGING_USER, password_env: STAGING_PASSWORD }
accounts:
member: { user: qa@acme.test, password_env: MEMBER_PASSWORD }
production:
base_url: https://acme.com
readonly: true
blocked_paths: ["/account/**"]
walk:
browsers: [chromium]
share:
expires_days: 30Klíče nejvyšší úrovně
| Klíč | Co obsahuje |
|---|---|
schema | vždy qawalk.config.v1 |
org | zkratka (slug) organizace na kaloko.app |
project | projekt v Kaloku pro běhy; výchozí je název repozitáře |
scenarios | masky souborů se scénáři |
output | složka běhů (výchozí tmp/kaloko) |
environments | kde flow běží (níže) |
browser | channel (kanál Playwrightu, třeba chrome; prázdný = přibalené Chromium) a port sdíleného prohlížeče (výchozí 9333) |
walk | výchozí hodnoty pro každý běh: concurrency (jazyky najednou, 1–16), browsers, color_schemes, reduced_motion, forced_colors, display_modes |
capture | výchozí hodnoty pro každý scénář: record, trace |
evaluators | sémantický evaluátor jev a evaluátor obrázků vision (níže) |
share | url (výchozí https://kaloko.app), token_env (výchozí KALOKO_TOKEN), expires_days (výchozí 30) |
docs | nastavení changelogu a dokumentace (níže) |
products | co vydáváte a verzujete jako celek (níže) |
Prostředí
Každý klíč pod environments je název, který použijete v kaloko start --env.
| Klíč | Co obsahuje |
|---|---|
kind | app (výchozí), nebo design (složka živých HTML kroků) |
base_url | adresa, nebo jedna pro každý jazyk se záložní default; ${VAR} se doplní z proměnných prostředí (review aplikace) |
readonly | true pro produkci: CLI jen čte, nikdy se nepřihlašuje do administrací a nevytváří data |
blocked_paths | masky cest, které běh jen pro čtení nikdy neotevře |
allowed_post_paths | masky cest, kam běh jen pro čtení smí poslat POST (košík) |
may_create_data | false zakáže vytváření dat (výchozí true) |
access | ochrana před celým prostředím: basic (user_env, password_env), headers (servisní tokeny), client_certificate a origins, které je dostanou |
accounts | lidé, kteří se přihlašují, pod stejnými klíči jako account ve scénáři: user nebo user_env, password_env, totp_env, storage_state (přihlášení uložené přes kaloko auth save) |
mail | schránka: provider (mailpit, script, none), url, user_env, password_env, address, script, options, auth |
app | testovaná aplikace pro každou platformu: android, ios, electron, desktop, windows |
serve, fixtures, tokens_mode | designová prostředí: složka kroků, JSON fixtures, režim tokenů |
html_view | experimentální: ke každému snímku statický HTML pohled |
Evaluátory
| Klíč | Co obsahuje |
|---|---|
evaluators.jev.api_key_env | proměnná s vaším vlastním klíčem k evaluátoru (výchozí TYPESAFE_API_KEY) |
evaluators.jev.hosted | bez místního klíče vyhodnocuje z měsíčního limitu vašeho plánu (výchozí true); false použije jen váš klíč |
evaluators.jev.thresholds | skóre pro pass a fail |
evaluators.jev.model, base_url, max_state_chars, signals, concurrency | jemnější nastavení, potřeba jen výjimečně |
evaluators.vision | druhý evaluátor, který se dívá na screenshot (poskytovatel anthropic, klíč v ANTHROPIC_API_KEY); false ho vypne |
Dokumentace a produkty
| Klíč | Co obsahuje |
|---|---|
docs.dir | zdroje dokumentace (výchozí docs) |
docs.changelog | soubor changelogu (výchozí CHANGELOG.md) |
docs.style | keep-a-changelog nebo release-notes |
docs.version_source | auto, git-tag, package.json, release-please, changesets, semantic-release, pyproject, cargo, gemspec, manual |
docs.languages | jazyky dokumentace; první je jazyk originálů |
docs.framework | auto, docusaurus, vitepress, mkdocs, nextra, plain |
docs.publish | kdo čte: members, domain, nebo public (poslední dvě potřebují admina) |
docs.images | viewport a locale (reader nebo jazyk) obrázků |
products.<slug> | name (text nebo pro každý jazyk), version (source, path, pattern), docs, project nebo projects, modules, reference_env, default_scenario, publish |
Bez products je produktem projekt.
Tajné údaje
Tajné údaje do konfigurace nikdy nepatří. Kde je nějaký potřeba, konfigurace jen pojmenuje proměnnou prostředí (password_env: STAGING_PASSWORD, { env: CF_ACCESS_CLIENT_SECRET }). Kaloko hodnotu hledá:
- v prostředí procesu,
- v
.envvedlekaloko.config.yml, - v
~/.config/kaloko/.env.
Proměnná, která už je nastavená, má přednost před soubory. Hodnoty se odstraní ze zachyceného HTML, z textu stránky i z výstupu konzole. kaloko doctor řekne, které pojmenované proměnné chybí. Token pro sdílení je KALOKO_TOKEN, pokud share.token_env neříká jinak; viz Role a tokeny.
Kaloko · latest · 2026-10-06