Skip to main content

​
Aan de slag

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.
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.
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.
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.
Ja. Met visuele bewerkingen 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.
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.

​
Publiceren en implementatie

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.
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.
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.
Ja. Ga naar Instellingen in uw project en gebruik de exportoptie om een ZIP van uw broncode te downloaden.
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 behandelt de meest voorkomende gevallen.
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.

​
Domeinen en hosting

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.
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.
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.
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.
Macaly biedt geen e-mailhosting. Voor e-mail op uw eigen domein (bijv. 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.

​
E-mail en notificaties

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

​
Werken met de agent

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

​
Technische problemen en fouten

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

​
Projecten dupliceren

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

​
Databases

Macaly-projecten gebruiken Convex als backenddatabase. U kunt uw data bekijken en beheren via het tabblad Database in de Macaly-editor.
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.
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.
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.

​
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.
De audit controleert uw site pas na publicatie. Heeft u uw project nog niet gepubliceerd, publiceer het dan en de audit wordt automatisch uitgevoerd.
De audit weerspiegelt uw laatst gepubliceerde versie. Heeft u sindsdien iets gewijzigd, publiceer uw project dan opnieuw en de auditresultaten worden vernieuwd.
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.
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.
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.
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.

​
Accountbeheer

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

​
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.
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.
Ja. status.macaly.com toont informatie over actieve incidenten en recente storingen.