Skip to main content

Začínáme

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.
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í.
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.
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.
Ano. Vizuální úpravy 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.
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.

Publikování

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.
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.
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í.
Ano. Přejděte na Nastavení v projektu a použijte možnost exportu ke stažení ZIP se zdrojovým kódem.
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.
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.

Domény a hosting

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.
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.
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.
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.
Macaly neposkytuje e-mailový hosting. Pro e-mail na vlastní doméně (např. 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í.

E-mail a notifikace

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

Práce s agentem

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

Technické problémy a chyby

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

Duplikování 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.
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.
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.
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.

Databáze

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.
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í.
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.
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ě.

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.
Audit kontroluje váš web až po publikování. Pokud jste projekt ještě nepublikovali, publikujte ho a audit se spustí sám.
Audit odpovídá poslední publikované verzi. Pokud jste od té doby něco změnili, publikujte projekt znovu a výsledky auditu se obnoví.
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.
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.
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.
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.

Správa účtu

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

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.
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í.
Ano, na webu status.macaly.com můžete najít informace o aktivních i nedávných výpadcích.