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

> Veelgestelde vragen over Macaly

## Aan de slag

<AccordionGroup>
  <Accordion title="Welke soorten projecten kan ik maken met Macaly?">
    Macaly is ontworpen voor het maken van marketingwebsites, landingspagina's, portfolio's, blogs, webapps (contactformulieren, boekingspagina's, registratiesystemen), eenvoudige 3D-apps en games, visuals, en prototypes of MVP's. Het blinkt uit in professioneel ontworpen, snel ladende sites.
  </Accordion>

  <Accordion title="Voor welke soorten projecten is Macaly niet geschikt?">
    Macaly is niet geschikt voor complexe enterprise-applicaties, native iOS- of Android-apps, desktopsoftware of projecten die PHP-, Python-backends, WordPress of Supabase vereisen. Het werkt uitsluitend met Next.js (React) en Convex als database.
  </Accordion>

  <Accordion title="Kan ik mijn project in een andere taal dan Engels maken?">
    Ja, Macaly werkt volledig in elke taal. Geef de agent gewoon instructies in uw voorkeurstaal (Nederlands, Frans, Duits, Spaans, enz.) en het project wordt in die taal gegenereerd. Als u meertalige pagina's nodig hebt, beschrijf dan duidelijk welke secties in welke taal moeten verschijnen.
  </Accordion>

  <Accordion title="Ondersteunt Macaly gebruikersauthenticatie en inloggen?">
    Ja. Macaly kan authenticatie instellen via OTP (eenmalig wachtwoord per e-mail) of een standaard inlogsysteem met e-mail en wachtwoord. Beschrijf gewoon wat u nodig hebt en de agent zal het implementeren.
  </Accordion>

  <Accordion title="Kan ik tekst en kleine designwijzigingen bewerken zonder credits te gebruiken?">
    Ja. Met [visuele bewerkingen](/docs/nl/features/visual-edits) klikt u direct op tekst, afbeeldingen en andere elementen in de voorvertoning en wijzigt u ze zonder een bericht naar de agent te sturen. Die wijzigingen worden bij het opslaan in uw project geschreven en verbruiken geen credits. De uitzondering is Vraag AI op tekst of een afbeelding: dat verbruikt wel credits en toont u vooraf de prijs.
  </Accordion>

  <Accordion title="Kan ik Macaly op mijn telefoon gebruiken, of moet ik een app downloaden?">
    Macaly werkt uitstekend in een mobiele browser, zodat u uw projecten rechtstreeks vanaf uw telefoon kunt maken en beheren. De enige uitzondering is de functie Visuele bewerkingen, die alleen beschikbaar is op apparaten met een groter scherm.
  </Accordion>
</AccordionGroup>

## Publiceren en implementatie

<AccordionGroup>
  <Accordion title="Hoe publiceer ik mijn project?">
    Klik op de knop **Publiceren** in de rechterbovenhoek van de editor. Na publicatie is uw site live op een gratis Macaly-subdomein (bijv. `mijnproject.macaly.app`). Om een eigen domein te koppelen, ga naar **Instellingen → Domeinen**.
  </Accordion>

  <Accordion title="Het publicatieproces staat al lang vast op bouwen. Wat moet ik doen?">
    De publicatie-interface kan soms achterlopen nadat een build is voltooid. Open de gepubliceerde URL en laad deze opnieuw om te controleren of de nieuwe versie al live staat. Als de site niet beschikbaar is of de status vast blijft staan, neem dan contact op met support met de chat-URL, gepubliceerde URL, het geschatte tijdstip en een schermafbeelding of foutdetails.
  </Accordion>

  <Accordion title="Mijn voorvertoning toont wijzigingen maar mijn live site weerspiegelt ze niet. Waarom?">
    De preview-URL en de gepubliceerde URL (uw Macaly-subdomein of eigen domein) zijn aparte omgevingen. Klik op **Publiceren** om wijzigingen naar de live site te sturen en vernieuw daarna de gepubliceerde URL volledig. Als er nog steeds een oudere versie wordt weergegeven, neem dan contact op met support met beide URL's en het geschatte publicatietijdstip.
  </Accordion>

  <Accordion title="Kan ik de broncode van mijn project downloaden?">
    Ja. Ga naar **Instellingen** in uw project en gebruik de exportoptie om een ZIP van uw broncode te downloaden.
  </Accordion>

  <Accordion title="Moet ik mijn bezoekers vertellen dat mijn site met AI is gemaakt?">
    Elke gepubliceerde site draagt een machineleesbare `ai-generated`-tag, maar dat is geen zichtbare vermelding voor uw lezers. Of u daarnaast iets moet vermelden over uw content of uw eigen AI-functies, hangt af van de toepasselijke wetgeving en de specifieke situatie. [AI verantwoord gebruiken](/docs/nl/security/using-ai-responsibly) behandelt de meest voorkomende gevallen.
  </Accordion>

  <Accordion title="Mijn app heeft een eigen AI-chatbot. Dekt de melding van het platform die ook?">
    Nee. De melding die u tijdens het bouwen ziet, geldt voor het platform. Als uw project een chatbot of een andere AI-functie heeft, is het informeren van uw eindgebruikers onderdeel van uw applicatie. Vraag de agent om een melding boven het chatvenster of aan het begin van het gesprek toe te voegen.
  </Accordion>
</AccordionGroup>

## Domeinen en hosting

<AccordionGroup>
  <Accordion title="Hoe koppel ik mijn eigen domein?">
    Ga in uw project naar **Instellingen → Domeinen**, typ uw domeinnaam en klik op **Koppelen**. Volg daarna de getoonde status. Sommige white-labelconfiguraties stellen DNS automatisch in of activeren het domein via een partnerproxy. Als het platform DNS-records toont, voeg dan exact die waarden toe bij uw registrar en keer terug om op **Vernieuwen** te klikken.
  </Accordion>

  <Accordion title="Welke DNS-records moet ik toevoegen voor mijn eigen domein?">
    Voeg alleen records toe wanneer **Instellingen → Domeinen** daarom vraagt. Voor een handmatige configuratie zijn doorgaans twee records nodig:

    * Een **A-record** voor het hoofddomein dat verwijst naar het IP-adres van Macaly
    * Een **CNAME-record** voor `www` dat verwijst naar de hostnaam van Macaly

    De exacte waarden worden getoond in **Instellingen → Domeinen** wanneer u uw domein toevoegt.
  </Accordion>

  <Accordion title="Mijn site werkt op www maar toont een SSL-fout op het kale domein. Hoe los ik dit op?">
    Controleer eerst **Instellingen → Domeinen**. Als daar een ontbrekend apex-record wordt getoond, voeg dan exact het aangegeven A-record toe en verwijder conflicterende A- of AAAA-records voor het hoofddomein. Als uw white-labelprovider DNS automatisch beheert of een partnerproxy gebruikt, vernieuw dan de status en neem contact op met de ondersteuning van uw merk in plaats van records op goed geluk te wijzigen.
  </Accordion>

  <Accordion title="Mijn domein toont nog steeds In behandeling of Niet verbonden. Wat moet ik doen?">
    Als de pagina aangeeft dat DNS automatisch wordt ingesteld, wacht dan enkele minuten en klik op **Vernieuwen**. Controleer bij een handmatige configuratie of de records bij uw registrar exact overeenkomen met de getoonde waarden en verwijder conflicterende records. DNS-propagatie kan tot 24 uur duren. Neem bij een partnerproxyconfiguratie contact op met de ondersteuning van uw merk als het domein niet wordt geactiveerd.
  </Accordion>

  <Accordion title="Kan ik e-mail instellen voor mijn eigen domein?">
    Macaly biedt geen e-mailhosting. Voor e-mail op uw eigen domein (bijv. [info@uwsite.com](mailto:info@uwsite.com)) kunt u zich aanmelden bij een externe provider zoals Google Workspace, Zoho of Microsoft 365 en hun MX-records configureren bij uw registrar. Zodra u een e-mailadres hebt, kan de Macaly-agent contactformulieren instellen die notificaties naar dat adres sturen.
  </Accordion>
</AccordionGroup>

## E-mail en notificaties

<AccordionGroup>
  <Accordion title="Kan Macaly e-mails verzenden vanuit mijn project?">
    Ja. Macaly heeft een ingebouwde e-mail-API aangedreven door Resend. Standaard worden uitgaande e-mails verzonden vanaf `no-reply@macaly.dev`. Om te verzenden vanaf uw eigen domeinadres hebt u uw eigen Resend-account en API-sleutel nodig. Vraag de agent om e-mailfunctionaliteit in te stellen en geef het gewenste afzender- en ontvangstadres op.
  </Accordion>

  <Accordion title="Wat zijn de limieten voor het verzenden van e-mails?">
    De standaardlimiet is maximaal 10 e-mails per minuut per applicatie. Macaly kan alleen e-mails verzenden, niet ontvangen. Het is niet geschikt voor nieuwsbrieven of bulk-marketinge-mails.
  </Accordion>

  <Accordion title="Mijn OTP-inlog-e-mails komen niet aan. Wat moet ik doen?">
    Controleer eerst uw spam- of ongewenste-e-mailmap. Als e-mails echt niet aankomen, neem dan contact op met support met de link naar uw project en het betreffende e-mailadres. Het team kan de e-mailbezorging aan de serverkant onderzoeken.
  </Accordion>
</AccordionGroup>

## Werken met de agent

<AccordionGroup>
  <Accordion title="De agent loopt vast of doet er te lang over. Wat kan ik doen?">
    Als de agent meer dan 10 tot 15 minuten geen voortgang toont, laad dan eerst de pagina opnieuw. Als de preview is vastgelopen, open dan het previewmenu en kies **Rebuild Preview** voor nieuwere projecten of **Restart App** voor oudere projecten.

    Als de laatste wijziging het project heeft gebroken, gebruik dan **Versiegeschiedenis** waar beschikbaar of **Deze versie herstellen** bij de laatste goede reactie van de agent. Blijft het probleem bestaan, meld het dan vanuit de getroffen reactie en voeg de chatlink, het geschatte tijdstip en een schermafbeelding of foutdetails toe.
  </Accordion>

  <Accordion title="De agent maakt steeds dezelfde fout. Hoe voorkom ik onnodig creditverbruik?">
    Wees bij het melden van een fout zo specifiek mogelijk. Beschrijf wat u deed voor de fout, wat u nu ziet, wat niet werkt en wat het juiste gedrag zou moeten zijn. Hoe meer detail u geeft, hoe beter de agent het in één keer kan oplossen.
  </Accordion>

  <Accordion title="Moet ik grote verzoeken opsplitsen in kleinere stappen?">
    Ja. Hoeveel werk de agent kan uitvoeren hangt af van de taak en kan parallel werk omvatten, dus één vaste stappenlimiet is niet zinvol. Splits grote of afhankelijke verzoeken op in beheersbare prompts, controleer elk resultaat en ga daarna verder.
  </Accordion>

  <Accordion title="Hoe maak ik een back-up van mijn project?">
    Gebruik **Versiegeschiedenis** waar beschikbaar of **Deze versie herstellen** om terug te gaan naar een werkende versie. Dupliceer het project als u een aparte experimentele tak wilt, niet als primair herstelmechanisme. Normale duplicaten beginnen zonder gespreksgeschiedenis. Bij projecten met een database kiest u of u een nieuwe database maakt of dezelfde blijft gebruiken.
  </Accordion>

  <Accordion title="Kan ik een eerdere versie van mijn project herstellen?">
    Ja. Open **Versiegeschiedenis** waar beschikbaar om eerdere previews te bekijken, de nieuwste en gepubliceerde versies te herkennen, ze afzonderlijk te openen of te herstellen. U kunt ook **Deze versie herstellen** onder een agentreactie gebruiken om de projectcode naar dat punt terug te brengen.
  </Accordion>

  <Accordion title="Wanneer moet ik /compact gebruiken?">
    Gebruik `/compact` wanneer een lange chat de focus begint te verliezen of vóór een nieuwe maar gerelateerde taak. De opdracht vat het gesprek samen en behoudt hetzelfde project en dezelfde code. Het maken van de samenvatting kost credits en vereist een minimumsaldo, maar de kortere context kan latere berichten goedkoper maken. Gebruik het niet na elk bericht, omdat herhaalde samenvattingen details kunnen verliezen.
  </Accordion>
</AccordionGroup>

## Technische problemen en fouten

<AccordionGroup>
  <Accordion title="Wat betekent foutcode 524 of een timeout?">
    Fout 524 is een timeout, wat betekent dat de server niet op tijd reageerde. Probeer de pagina na een minuut of twee te vernieuwen. Als het aanhoudt, neem dan contact op met support met uw chatlink. U kunt lopende incidenten controleren op status.macaly.com.
  </Accordion>

  <Accordion title="De voorvertoning zegt Kan niet starten of de ontwikkelserver is gecrasht. Wat moet ik doen?">
    Laad eerst de pagina opnieuw. Als de preview nog steeds niet start, open dan het previewmenu en kies **Rebuild Preview** voor nieuwere projecten of **Restart App** voor oudere projecten. Blijft het mislukken, neem dan contact op met support met de chatlink, het geschatte tijdstip en de foutdetails.
  </Accordion>

  <Accordion title="Ik krijg 'Application error: a client-side exception has occurred'. Wat is er mis?">
    Automatische browservertaling kan de editor soms verstoren. Schakel deze voor het platformdomein uit en laad de pagina opnieuw als eerste controle. Als de fout blijft bestaan of op de gepubliceerde site verschijnt, meld deze dan met de chat-URL, gepubliceerde URL, het geschatte tijdstip en een schermafbeelding of foutdetails.
  </Accordion>

  <Accordion title="Waarom kan iemand anders de gekopieerde previewlink niet openen?">
    Een privépreview kan een geautoriseerde platformsessie vereisen. Gebruik een rechtstreeks gekopieerde privépreview-URL niet als openbare deellink. Stel het project via **Delen** in op **Iedereen met de link** en stuur daarna de gegenereerde deellink. Als een geautoriseerde collega nog steeds een onbevoegde of lege preview ziet, laad het project opnieuw en neem contact op met support als het probleem aanhoudt.
  </Accordion>

  <Accordion title="Het uploaden van afbeeldingen mislukt. Wat zijn de limieten?">
    Individuele afbeeldingen mogen niet groter zijn dan 8000x8000 pixels. Bij het uploaden van meer dan 20 afbeeldingen in één verzoek moet elke afbeelding kleiner zijn dan 2000x2000 pixels. Bestanden moeten kleiner zijn dan 5 MB. Als u een SVG-uploadfout tegenkomt, neem dan contact op met support.
  </Accordion>
</AccordionGroup>

## Projecten dupliceren

<AccordionGroup>
  <Accordion title="Hoe dupliceer ik een project?">
    Open het chatmenu en selecteer **Dupliceren**. Een normaal duplicaat kopieert projectcode, inhoud en bestanden zonder de gespreksgeschiedenis. Heeft het project een database, kies dan **Nieuwe database maken** om de huidige gegevens naar een onafhankelijke database te kopiëren, of **Dezelfde database gebruiken** zodat beide projecten dezelfde gegevens lezen en schrijven. De tweede optie is alleen beschikbaar binnen dezelfde workspace.

    Secrets worden automatisch gekopieerd wanneer u uw eigen project dupliceert. Kopieën van een gedeeld project of sjabloon nemen geen gevoelige omgevingsgegevens over. Publiceer het duplicaat opnieuw en koppel elk eigen domein dat het moet gebruiken opnieuw.
  </Accordion>

  <Accordion title="Delen duplicaten dezelfde database?">
    Dat hangt af van de keuze tijdens het dupliceren. **Nieuwe database maken** kopieert de huidige gegevens naar een onafhankelijke database, zodat latere schema- of gegevenswijzigingen niet tussen projecten worden gedeeld. **Dezelfde database gebruiken** houdt beide projecten verbonden met één database, waardoor wijzigingen uit het ene project ook in het andere zichtbaar zijn.
  </Accordion>

  <Accordion title="Kan ik mijn project delen zodat iemand anders het kan dupliceren naar hun account?">
    Ja. Klik op **Delen** naast de knop **Publiceren** en stel de zichtbaarheid in op **Iedereen met de link**. Deel de link. Iedereen die deze opent kan het project bekijken en dupliceren naar hun eigen Macaly-account.
  </Accordion>

  <Accordion title="Ik bouw websites voor klanten. Kunnen zij de site overnemen in hun eigen Macaly-account?">
    Ja. Elk project kan worden gedupliceerd en gedeeld met uw klant. Zij kunnen de site vervolgens zelfstandig verder ontwikkelen en beheren in hun eigen Macaly-account.
  </Accordion>
</AccordionGroup>

## Databases

<AccordionGroup>
  <Accordion title="Welke database gebruikt Macaly?">
    Macaly-projecten gebruiken Convex als backenddatabase. U kunt uw data bekijken en beheren via het tabblad **Database** in de Macaly-editor.
  </Accordion>

  <Accordion title="Kan ik de database van mijn project exporteren of importeren?">
    Ja, rechtstreeks via het tabblad **Database**. **Exporteren** downloadt een volledige snapshot van uw data als ZIP-bestand, handig als back-up of om te migreren naar uw eigen Convex-account. **Importeren** zet een snapshot terug in uw project; daarbij worden alle bestaande gegevens vervangen, dus Macaly vraagt eerst om een expliciete bevestiging.
  </Accordion>

  <Accordion title="Kan ik de database van mijn project migreren naar mijn eigen Convex-account?">
    Ja. Exporteer een databasesnapshot (ZIP) via het tabblad **Database**, maak uw eigen Convex-account aan, importeer de snapshot volgens de handleiding op docs.convex.dev en werk vervolgens de Convex-secrets bij in uw Macaly-projectinstellingen. Er is een korte onderbreking tijdens de overstap.
  </Accordion>

  <Accordion title="Kan ik Macaly nog steeds gebruiken om te bouwen als ik overstap naar mijn eigen Convex-database?">
    Ja. U kunt blijven ontwikkelen met Macaly nadat u naar uw eigen Convex-database bent gemigreerd. Het tabblad **Database** in Macaly werkt niet meer, maar alle andere functionaliteit blijft normaal werken.
  </Accordion>
</AccordionGroup>

## SEO

<AccordionGroup>
  <Accordion title="Hoe gaat Macaly om met SEO?">
    Macaly maakt sites die vriendelijk zijn voor zoekmachines. Rendering op de server, schone HTML en meta-tags regelt Macaly voor u. Zodra u uw project publiceert, geeft de SEO-audit uw site een score en vertelt wat u kunt verbeteren. U kunt meta-tags, paginatitels en beschrijvingen ook bewerken in **Instellingen → SEO**.
  </Accordion>

  <Accordion title="Waarom kan ik de SEO-audit niet uitvoeren?">
    De audit controleert uw site pas na publicatie. Heeft u uw project nog niet gepubliceerd, publiceer het dan en de audit wordt automatisch uitgevoerd.
  </Accordion>

  <Accordion title="Mijn SEO-audit lijkt verouderd. Hoe komt dat?">
    De audit weerspiegelt uw laatst gepubliceerde versie. Heeft u sindsdien iets gewijzigd, publiceer uw project dan opnieuw en de auditresultaten worden vernieuwd.
  </Accordion>

  <Accordion title="Wat is AI-gereedheid?">
    AI-gereedheid meet hoe goed AI-crawlers, bijvoorbeeld die van ChatGPT, Claude of Perplexity, bij uw site kunnen en die begrijpen. Er wordt gecontroleerd of uw inhoud direct op de pagina staat en niet pas via JavaScript wordt geladen, of AI-crawlers niet worden geblokkeerd en of er een llms.txt-bestand beschikbaar is om ze te sturen. Macaly rendert uw pagina's automatisch op de server.
  </Accordion>

  <Accordion title="Hoe verbeter ik mijn SEO-score?">
    Werk de lijst met problemen door, eerst de fouten en daarna de waarschuwingen. Gebruik de knop Alles herstellen met AI om alle problemen in één keer aan de agent te geven, of pak ze een voor een aan. Publiceer daarna uw wijzigingen en de score wordt bij de volgende audit bijgewerkt.
  </Accordion>

  <Accordion title="Mijn site verschijnt niet in Google-zoekresultaten. Wat kan ik doen?">
    Google-indexering kost tijd, vaak dagen tot weken. Om dit te versnellen, dient u uw site-URL in bij Google Search Console op search.google.com/search-console. U kunt uw URL ook op social media delen, aangezien Google links crawlt die het elders op het web vindt.
  </Accordion>

  <Accordion title="Kan ik een Macaly-site insluiten in een andere website via een iframe?">
    Technisch gezien ja, door uw gepubliceerde Macaly-URL in een iframe te gebruiken. De inhoud van iframes wordt echter slecht geïndexeerd door zoekmachines, wat een negatief effect heeft op uw SEO. Een betere aanpak is om Macaly als zelfstandige site te gebruiken met een eigen domein.
  </Accordion>
</AccordionGroup>

## Accountbeheer

<AccordionGroup>
  <Accordion title="Hoe wijzig ik mijn e-mailadres?">
    Neem contact op met support en geef het nieuwe e-mailadres door. Zij zullen het aan de serverkant bijwerken. Let op: u kunt geen e-mailadres gebruiken dat al bij een ander Macaly-account is geregistreerd.
  </Accordion>

  <Accordion title="Ik kan niet inloggen en ontvang geen OTP-e-mails.">
    Controleer eerst uw spam- of ongewenste-e-mailmap. Als de e-mail helemaal niet aankomt, neem dan contact op met support. Zij kunnen uw accountstatus verifiëren en helpen met authenticatie.
  </Accordion>

  <Accordion title="Hoe verwijder ik mijn account permanent?">
    Neem contact op met support en vraag om accountverwijdering. Zij zullen uw account en alle bijbehorende data verwijderen. Let op: deze actie is onomkeerbaar. Alle projecten, credits en data worden permanent verwijderd.
  </Accordion>
</AccordionGroup>

## Support

<AccordionGroup>
  <Accordion title="Hoe snel reageert Macaly-support?">
    Het team streeft ernaar binnen één werkdag te reageren. Support is gevestigd in Europa (CET-tijdzone) en is in het weekend gesloten. Tijdens vakantieperiodes kunnen reacties iets langer duren.
  </Accordion>

  <Accordion title="Hoe vraag ik een beoordeling aan van credits die door een mislukte reactie zijn gebruikt?">
    Kies bij de getroffen agentreactie **Probleem melden** en selecteer, als de optie voor uw workspace beschikbaar is, **Creditbeoordeling aanvragen**. De automatische beoordeling duurt meestal ongeveer een minuut en kan credits herstellen bij duidelijke fouten van de agent of het platform. Als de optie niet beschikbaar is of de uitkomst opnieuw moet worden bekeken, neem dan contact op met support met de chatlink en details van de melding.
  </Accordion>

  <Accordion title="Is er een statuspagina waar ik storingen kan controleren?">
    Ja. [status.macaly.com](https://status.macaly.com) toont informatie over actieve incidenten en recente storingen.
  </Accordion>
</AccordionGroup>


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