> ## Documentation Index
> Fetch the complete documentation index at: https://wl.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Nejčastější otázky o Macaly

## Začínáme

<AccordionGroup>
  <Accordion title="Jaké projekty mohu v Macaly vytvářet?">
    Macaly je navrženo pro tvorbu marketingových webů, landing pages, portfolií, blogů, webových aplikací (kontaktní formuláře, rezervační stránky, evidenční systémy), jednoduchých 3D aplikací a her, vizuálů a prototypů nebo MVP. Vyniká v profesionálně navržených, rychle načítaných webech.
  </Accordion>

  <Accordion title="Pro jaké typy projektů není Macaly vhodné?">
    Macaly není vhodný nástroj pro složité aplikace, nativní iOS nebo Android mobilní aplikace, desktopový software ani projekty vyžadující PHP, Python backendy, WordPress nebo Supabase. Pracuje výhradně s Next.js (React) a Convexem jako databází.
  </Accordion>

  <Accordion title="Mohu projekt stavět v jiném jazyce než angličtině?">
    Ano. Macaly plně funguje v jakémkoli jazyce. Jednoduše dejte agentovi instrukce ve vašem preferovaném jazyce (čeština, francouzština, němčina, španělština atd.) a obsah projektu se v tomto jazyce vygeneruje. Pokud potřebujete vícejazyčné stránky, jednoduše popište, které sekce mají být v kterém jazyce.
  </Accordion>

  <Accordion title="Podporuje Macaly přihlašování uživatelů?">
    Ano. Macaly umí nastavit autentizaci pomocí OTP (jednorázové heslo zaslané e-mailem) nebo standardního přihlášení e-mailem a heslem. Stačí popsat, co potřebujete, a agent to implementuje.
  </Accordion>

  <Accordion title="Mohu upravovat text a drobné změny designu bez využití kreditů?">
    Ano. [Vizuální úpravy](/docs/cs/features/visual-edits) vám umožňují vybrat konkrétní texty, obrázky a další prvky v náhledu a měnit je bez odesílání zpráv agentovi. Tyto změny se při uložení zapíšou přímo do projektu a nespotřebovávají žádné kredity. Výjimkou je funkce Zeptat se AI u textu nebo obrázku, která kredity spotřebovává a cenu vám ukáže předem.
  </Accordion>

  <Accordion title="Mohu používat Macaly na telefonu, nebo si musím stáhnout aplikaci?">
    Macaly perfektně funguje v mobilním prohlížeči, takže své projekty můžete vytvářet a spravovat přímo z telefonu. Jedinou výjimkou je funkce Vizuální úpravy, která je dostupná pouze na zařízeních s větším displejem.
  </Accordion>
</AccordionGroup>

## Publikování

<AccordionGroup>
  <Accordion title="Jak publikuji projekt?">
    Klikněte na tlačítko **Publikovat** v pravém horním rohu editoru. Po publikování bude váš web dostupný na bezplatné subdoméně Macaly (např. `mujprojekt.macaly.app`). Pro připojení vlastní domény přejděte na **Nastavení** > **Domény**.
  </Accordion>

  <Accordion title="Publikování se zaseklo. Co mám dělat?">
    Rozhraní publikování se po dokončení sestavení může občas aktualizovat se zpožděním. Otevřete publikovanou URL a znovu ji načtěte, abyste ověřili, zda už je nová verze živá. Pokud web není dostupný nebo stav zůstává zaseknutý, kontaktujte podporu s URL chatu, publikovanou URL, přibližným časem a snímkem obrazovky nebo podrobnostmi chyby.
  </Accordion>

  <Accordion title="Proč náhled ukazuje změny, ale na veřejném webu nejsou vidět?">
    URL náhledu a publikovaná URL (vaše subdoména Macaly nebo vlastní doména) jsou dvě samostatná prostředí. Změny odešlete kliknutím na **Publikovat** a poté publikovanou URL tvrdě obnovte. Pokud stále zobrazuje starší verzi, kontaktujte podporu s oběma URL a přibližným časem publikování.
  </Accordion>

  <Accordion title="Mohu si stáhnout zdrojový kód projektu?">
    Ano. Přejděte na **Nastavení** v projektu a použijte možnost exportu ke stažení ZIP se zdrojovým kódem.
  </Accordion>

  <Accordion title="Musím návštěvníkům říkat, že můj web vznikl pomocí AI?">
    Každý publikovaný web nese strojově čitelnou značku `ai-generated`, ale to není viditelné upozornění pro vaše čtenáře. Jestli musíte uvádět něco dalšího o svém obsahu nebo o vlastních AI funkcích, závisí na platných zákonech a konkrétním případu použití. Běžné situace rozebírá [Odpovědné používání AI](/docs/cs/security/using-ai-responsibly).
  </Accordion>

  <Accordion title="Moje aplikace má vlastního AI chatbota. Pokrývá ho upozornění platformy?">
    Ne. Upozornění, které vidíte při stavění projektu, se týká platformy. Pokud má váš projekt chatbota nebo jinou AI funkci, informovat o ní koncové uživatele je součástí vaší aplikace. Řekněte agentovi, ať přidá upozornění nad chatovací okno nebo na začátek konverzace.
  </Accordion>
</AccordionGroup>

## Domény a hosting

<AccordionGroup>
  <Accordion title="Jak připojím vlastní doménu?">
    V projektu přejděte na **Nastavení → Domény**, zadejte název domény a klikněte na **Připojit**. Potom postupujte podle zobrazeného stavu. Některá white-label nastavení nakonfigurují DNS automaticky nebo aktivují doménu přes partnerskou proxy. Pokud platforma zobrazí DNS záznamy, přidejte přesně tyto hodnoty u registrátora a vraťte se kliknout na **Obnovit**.
  </Accordion>

  <Accordion title="Jaké DNS záznamy musím přidat pro vlastní doménu?">
    Záznamy přidávejte jen tehdy, když vás k tomu vyzve **Nastavení → Domény**. Ruční nastavení obvykle vyžaduje dva záznamy:

    * **A záznam** pro kořenovou doménu ukazující na IP adresu Macaly
    * **CNAME záznam** pro `www` ukazující na hostname Macaly

    Přesné hodnoty se zobrazí v **Nastavení → Domény** při přidání vaší domény.
  </Accordion>

  <Accordion title="Web funguje na www, ale na kořenové doméně hlásí chybu SSL. Jak to opravit?">
    Nejdřív zkontrolujte **Nastavení → Domény**. Pokud se tam zobrazuje chybějící apex záznam, přidejte přesně uvedený A záznam a odstraňte konfliktní A nebo AAAA záznamy pro kořenovou doménu. Pokud váš white-label poskytovatel spravuje DNS automaticky nebo používá partnerskou proxy, obnovte stav a místo změn naslepo kontaktujte podporu svého brandu.
  </Accordion>

  <Accordion title="Doména stále ukazuje Pending nebo Not connected. Co mám dělat?">
    Pokud stránka uvádí, že se DNS nastavuje automaticky, počkejte několik minut a klikněte na **Obnovit**. Při ručním nastavení ověřte, že záznamy u registrátora přesně odpovídají zobrazeným hodnotám, a odstraňte konfliktní záznamy. Propagace DNS může trvat až 24 hodin. Při nastavení přes partnerskou proxy kontaktujte podporu svého brandu, pokud se doména neaktivuje.
  </Accordion>

  <Accordion title="Mohu si nastavit e-mail pro vlastní doménu?">
    Macaly neposkytuje e-mailový hosting. Pro e-mail na vlastní doméně (např. [info@vasweb.cz](mailto:info@vasweb.cz)) se zaregistrujte u poskytovatele třetí strany, jako je Google Workspace, Zoho nebo Microsoft 365, a nastavte jejich MX záznamy u registrátora. Jakmile budete mít e-mailovou adresu, agent Macaly může nastavit kontaktní formuláře pro zasílání notifikací.
  </Accordion>
</AccordionGroup>

## E-mail a notifikace

<AccordionGroup>
  <Accordion title="Může Macaly odesílat e-maily z mého projektu?">
    Ano. Macaly má integrované e-mailové API poháněné službou Resend. Ve výchozím nastavení jsou odchozí e-maily odesílány z adresy `no-reply@macaly.dev`. Pro odesílání z vlastní doménové adresy potřebujete vlastní účet Resend a API klíč. Požádejte agenta o nastavení e-mailové funkcionality a uveďte požadovanou odesílací a přijímací adresu.
  </Accordion>

  <Accordion title="Jaké jsou limity odesílání e-mailů?">
    Výchozí limit je maximálně 10 e-mailů za minutu na aplikaci. Macaly umí e-maily pouze odesílat, ne přijímat. Tato funkce také není vhodná pro newslettery ani hromadné marketingové e-maily.
  </Accordion>

  <Accordion title="Uživatelům nepřicházejí OTP přihlašovací e-maily. Co mám dělat?">
    Nejprve zkontrolujte složku spamu nebo nevyžádané pošty. Pokud e-maily skutečně nedocházejí, kontaktujte podporu s odkazem na projekt a dotčenou e-mailovou adresou. Tým může zkontrolovat odesílání e-mailů na backendu.
  </Accordion>
</AccordionGroup>

## Práce s agentem

<AccordionGroup>
  <Accordion title="Agent se zasekl nebo pracuje příliš dlouho. Co mám dělat?">
    Pokud agent více než 10 až 15 minut nevykazuje žádný pokrok, nejprve znovu načtěte stránku. Pokud je náhled zamrzlý, otevřete nabídku náhledu a u novějších projektů zvolte **Rebuild Preview**, u starších **Restart App**.

    Jestli poslední změna projekt rozbila, použijte **Historii verzí**, pokud je dostupná, nebo **Obnovit tuto verzi** u poslední funkční odpovědi agenta. Pokud problém přetrvává, nahlaste ho u dotčené odpovědi a přiložte odkaz na chat, přibližný čas a snímek obrazovky nebo podrobnosti chyby.
  </Accordion>

  <Accordion title="Agent opakuje stejnou chybu. Jak se vyhnout zbytečnému spotřebovávání kreditů?">
    Při popisu chyby buďte co nejkonkrétnější. Popište, co jste dělali před chybou, co vidíte nyní, co nefunguje a jaké by mělo být správné chování. Čím více detailů poskytnete, tím lépe agent chybu opraví na první pokus.
  </Accordion>

  <Accordion title="Mám velké požadavky rozdělit na menší kroky?">
    Ano. Množství práce, které agent zvládne, se liší podle úkolu a může zahrnovat paralelní práci, takže jeden pevný limit kroků není užitečný. Velké nebo navazující požadavky rozdělte na zvládnutelné prompty, každý výsledek ověřte a pak pokračujte.
  </Accordion>

  <Accordion title="Jak si vytvořit zálohu projektu?">
    Pro návrat k funkční verzi použijte **Historii verzí**, pokud je dostupná, nebo **Obnovit tuto verzi**. Projekt duplikujte tehdy, když chcete samostatnou větev pro experimentování, ne jako hlavní způsob obnovy. Běžné duplikáty neobsahují historii konverzace a u projektů s databází si zvolíte, zda vytvořit novou databázi, nebo použít stejnou.
  </Accordion>

  <Accordion title="Mohu obnovit předchozí verzi projektu?">
    Ano. V **Historii verzí**, pokud je dostupná, můžete procházet předchozí náhledy, rozeznat nejnovější a publikovanou verzi, otevřít je samostatně nebo obnovit. Také můžete použít **Obnovit tuto verzi** pod odpovědí agenta a vrátit kód projektu do daného bodu.
  </Accordion>

  <Accordion title="Kdy mám použít /compact?">
    `/compact` použijte, když dlouhý chat začíná ztrácet soustředění nebo před novým, ale souvisejícím úkolem. Příkaz shrne konverzaci, ale zachová stejný projekt a kód. Vytvoření shrnutí spotřebuje kredity a vyžaduje minimální zůstatek, kratší kontext ale může zlevnit další zprávy. Nepouštějte ho po každé zprávě, protože opakované shrnování může ztratit detaily.
  </Accordion>
</AccordionGroup>

## Technické problémy a chyby

<AccordionGroup>
  <Accordion title="Co znamená chybový kód 524 nebo timeout?">
    Chyba 524 označuje timeout, což znamená, že server neodpověděl včas. Zkuste po minutě nebo dvou obnovit stránku. Pokud problém přetrvává, kontaktujte podporu s odkazem na chat. Probíhající incidenty můžete sledovat na status.macaly.com.
  </Accordion>

  <Accordion title="Náhled hlásí Failed to Start nebo chybu development serveru. Co mám dělat?">
    Nejprve znovu načtěte stránku. Pokud se náhled stále nespustí, otevřete jeho nabídku a u novějších projektů zvolte **Rebuild Preview**, u starších **Restart App**. Pokud chyba přetrvává, kontaktujte podporu s odkazem na chat, přibližným časem a podrobnostmi chyby.
  </Accordion>

  <Accordion title="Dostávám chybu &#x22;Application error: a client-side exception&#x22;. Co je špatně?">
    Automatický překlad v prohlížeči může někdy narušit editor, proto ho pro doménu platformy vypněte a stránku znovu načtěte. Pokud chyba přetrvává nebo se zobrazuje na publikovaném webu, nahlaste ji s URL chatu, publikovanou URL, přibližným časem a snímkem obrazovky nebo podrobnostmi chyby.
  </Accordion>

  <Accordion title="Proč jiný člověk nemůže otevřít odkaz na náhled, který jsem mu poslal?">
    Soukromý náhled může vyžadovat autorizovanou relaci na platformě. Přímo zkopírovanou URL soukromého náhledu nepoužívejte jako veřejný odkaz. V nabídce **Sdílet** nastavte projekt na **Kdokoli s odkazem** a pošlete vygenerovaný sdílený odkaz. Pokud autorizovaný kolega stále vidí zamítnutý přístup nebo prázdný náhled, znovu načtěte projekt a při přetrvávajícím problému kontaktujte podporu.
  </Accordion>

  <Accordion title="Nahrávání obrázků nefunguje. Jaké jsou limity pro velikosti?">
    Jednotlivé obrázky nesmí přesáhnout 8000×8000 pixelů. Při nahrávání více než 20 obrázků v jednom požadavku musí mít každý rozměry do 2000×2000 pixelů. Soubory by měly být pod 5 MB. Pokud narazíte na chybu při nahrávání SVG, kontaktujte podporu.
  </Accordion>
</AccordionGroup>

## Duplikování projektů

<AccordionGroup>
  <Accordion title="Jak duplikovat projekt?">
    V nabídce chatu vyberte **Duplikovat**. Běžný duplikát zkopíruje kód, obsah a soubory projektu bez historie konverzace. Pokud má projekt databázi, zvolte **Vytvořit novou databázi** pro zkopírování aktuálních dat do nezávislé databáze, nebo **Použít stejnou databázi**, aby oba projekty četly a zapisovaly stejná data. Druhá možnost je dostupná jen při duplikaci v rámci stejného workspace.

    Tajné klíče se automaticky zkopírují při duplikaci vlastního projektu. Kopie ze sdíleného projektu nebo šablony citlivá data prostředí nepřebírají. Duplikát znovu publikujte a připojte k němu vlastní doménu, kterou má používat.
  </Accordion>

  <Accordion title="Sdílejí kopie stejnou databázi?">
    Záleží na volbě při duplikaci. **Vytvořit novou databázi** zkopíruje aktuální data do nezávislé databáze, takže pozdější změny schématu nebo dat se mezi projekty nepřenášejí. **Použít stejnou databázi** ponechá oba projekty připojené k jedné databázi a změny z kteréhokoli projektu budou viditelné v obou.
  </Accordion>

  <Accordion title="Mohu sdílet svůj projekt, aby si ho někdo jiný mohl duplikovat do svého účtu?">
    Ano. Klikněte na **Sdílet** vedle tlačítka **Publikovat** a nastavte viditelnost na **Kdokoli s odkazem**. Poté odkaz sdílejte – kdokoli ho otevře si může projekt prohlédnout a duplikovat do vlastního účtu Macaly.
  </Accordion>

  <Accordion title="Tvořím weby pro klienty. Mohou si pak web převzít pod svůj účet Macaly?">
    Ano, jakýkoli projekt lze duplikovat a sdílet s klientem. Ten pak může web dále rozvíjet a spravovat ve vlastním účtu Macaly nezávisle na vás.
  </Accordion>
</AccordionGroup>

## Databáze

<AccordionGroup>
  <Accordion title="Jakou databázi Macaly používá?">
    Projekty Macaly používají jako backendovou databázi Convex. Data si můžete prohlížet a spravovat přes záložku **Databáze** v editoru Macaly.
  </Accordion>

  <Accordion title="Mohu databázi projektu exportovat nebo importovat?">
    Ano, přímo ze záložky **Databáze**. **Export** stáhne kompletní snapshot vašich dat jako ZIP soubor, který se hodí jako záloha nebo pro přechod na vlastní účet Convex. **Import** nahraje snapshot zpět do projektu. Přepíše všechna stávající data, takže si Macaly předem vyžádá výslovné potvrzení.
  </Accordion>

  <Accordion title="Mohu migrovat databázi projektu na vlastní účet Convex?">
    Ano. Exportujte snapshot databáze (ZIP) ze záložky **Databáze**, vytvořte si vlastní účet Convex, importujte snapshot podle průvodce na docs.convex.dev a poté aktualizujte tajné klíče Convex v nastavení vašeho projektu Macaly. Během přechodu může dojít ke krátkému výpadku.
  </Accordion>

  <Accordion title="Mohu po přechodu na vlastní databázi Convex stále používat Macaly?">
    Ano. Po migraci na vlastní databázi Convex můžete dále používat Macaly, jak jste zvyklí. Záložka **Databáze** v Macaly přestane fungovat, ale všechny ostatní funkce budou dostupné normálně.
  </Accordion>
</AccordionGroup>

## SEO

<AccordionGroup>
  <Accordion title="Jak Macaly řeší SEO?">
    Macaly vytváří weby přívětivé pro vyhledávače. Renderování na serveru, čisté HTML i meta tagy řeší Macaly za vás. Jakmile projekt publikujete, SEO audit ohodnotí váš web a poradí, co zlepšit. Meta tagy, titulky stránek a popisky můžete upravit i v **Nastavení → SEO**.
  </Accordion>

  <Accordion title="Proč nemůžu spustit SEO audit?">
    Audit kontroluje váš web až po publikování. Pokud jste projekt ještě nepublikovali, publikujte ho a audit se spustí sám.
  </Accordion>

  <Accordion title="Můj SEO audit vypadá zastarale. Proč?">
    Audit odpovídá poslední publikované verzi. Pokud jste od té doby něco změnili, publikujte projekt znovu a výsledky auditu se obnoví.
  </Accordion>

  <Accordion title="Co je připravenost pro AI?">
    Připravenost pro AI měří, jak dobře se AI crawlery, například ty z ChatGPT, Claude nebo Perplexity, dostanou k vašemu webu a porozumí mu. Kontroluje, že je obsah přímo na stránce a ne načítaný pomocí JavaScriptu, že AI crawlery nejsou blokované a že je k dispozici soubor llms.txt, který je navede. Macaly renderuje stránky na serveru automaticky.
  </Accordion>

  <Accordion title="Jak zlepším své SEO skóre?">
    Projděte seznam problémů, nejdřív chyby, potom varování. Buď použijte tlačítko Opravit vše s AI a předejte agentovi všechny problémy najednou, nebo je řešte jeden po druhém. Poté změny publikujte a skóre se aktualizuje při dalším auditu.
  </Accordion>

  <Accordion title="Můj web se nezobrazuje ve vyhledávání Google. Co mám dělat?">
    Indexování Googlem chvíli trvá, často dny až týdny. Pro urychlení zadejte URL svého webu do Google Search Console na search.google.com/search-console. Můžete také sdílet URL na sociálních sítích, protože Google prochází odkazy, které najde jinde na internetu.
  </Accordion>

  <Accordion title="Mohu vložit web Macaly do jiného webu pomocí funkce iframe?">
    Technicky ano, a to pomocí vaší publikované URL adresy. Obsah v iframe je však vyhledávači špatně indexován, což má negativní vliv na vaše SEO. Lepší přístup je používat Macaly jako samostatný web s vlastní doménou.
  </Accordion>
</AccordionGroup>

## Správa účtu

<AccordionGroup>
  <Accordion title="Jak mohu změnit e-mailovou adresu?">
    Kontaktujte podporu a uveďte novou e-mailovou adresu. Ta ji aktualizuje na backendu. Nelze použít e-mailovou adresu, která je již registrována na jiném účtu Macaly.
  </Accordion>

  <Accordion title="Nemohu se přihlásit do svého účtu a nepřicházejí mi OTP e-maily.">
    Nejprve zkontrolujte složku spamu nebo nevyžádané pošty. Pokud vám e-maily vůbec nepřichází, kontaktujte podporu. Ta může ověřit stav vašeho účtu a pomoci s přihlášením.
  </Accordion>

  <Accordion title="Jak trvale smažu účet?">
    Kontaktujte podporu a požádejte o smazání účtu. Ta smaže váš účet a všechna další data. Tato akce je nevratná, všechny vaše projekty, kredity a data budou trvale odstraněny.
  </Accordion>
</AccordionGroup>

## Podpora

<AccordionGroup>
  <Accordion title="Jak rychle reaguje podpora?">
    Tým se snaží odpovídat do jednoho pracovního dne. Podpora sídlí v Evropě (časové pásmo CET) a o víkendech není dostupná. V období svátků může odpověď trvat trochu déle.
  </Accordion>

  <Accordion title="Jak požádám o kontrolu kreditů spotřebovaných chybnou odpovědí?">
    U dotčené odpovědi agenta zvolte **Nahlásit problém** a, pokud je tato možnost pro váš workspace dostupná, vyberte **Požádat o posouzení kreditů**. Automatická kontrola obvykle trvá asi minutu a při jasném selhání agenta nebo platformy může kredity obnovit. Pokud možnost není dostupná nebo výsledek vyžaduje další kontrolu, kontaktujte podporu s odkazem na chat a podrobnostmi hlášení.
  </Accordion>

  <Accordion title="Existuje stránka, kde by byly vidět výpadky služby?">
    Ano, na webu [status.macaly.com](https://status.macaly.com) můžete najít informace o aktivních i nedávných výpadcích.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.