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

> Questions fréquentes sur Macaly

## Premiers pas

<AccordionGroup>
  <Accordion title="Quels types de projets puis-je créer avec Macaly ?">
    Macaly est conçu pour créer des sites marketing, des pages d'atterrissage, des portfolios, des blogs, des applications web (formulaires de contact, pages de réservation, systèmes de suivi), des applications et jeux 3D simples, des visuels, ainsi que des prototypes ou MVP. Il excelle dans la création de sites au design professionnel et au chargement rapide.
  </Accordion>

  <Accordion title="Pour quels types de projets Macaly n'est-il pas adapté ?">
    Macaly n'est pas l'outil adapté pour les applications d'entreprise complexes, les applications mobiles natives iOS ou Android, les logiciels de bureau, ou les projets nécessitant des backends PHP, Python, WordPress ou Supabase. Il fonctionne exclusivement avec Next.js (React) et Convex comme base de données.
  </Accordion>

  <Accordion title="Puis-je créer mon projet dans une langue autre que l'anglais ?">
    Oui, Macaly fonctionne pleinement dans n'importe quelle langue. Donnez simplement vos instructions à l'agent dans la langue de votre choix (français, allemand, espagnol, etc.) et il générera le contenu du projet dans cette langue. Si vous avez besoin de pages multilingues, décrivez clairement quelles sections doivent apparaître dans quelle langue.
  </Accordion>

  <Accordion title="Macaly prend-il en charge l'authentification et la connexion utilisateur ?">
    Oui. Macaly peut configurer l'authentification via OTP (mot de passe à usage unique envoyé par e-mail) ou un système de connexion standard par e-mail et mot de passe. Décrivez simplement ce dont vous avez besoin et l'agent le mettra en place.
  </Accordion>

  <Accordion title="Puis-je modifier du texte et de petits changements de design sans utiliser de crédits ?">
    Oui. Les [modifications visuelles](/docs/fr/features/visual-edits) vous permettent de cliquer directement sur le texte, les images et d'autres éléments dans l'aperçu pour les modifier sans envoyer de message à l'agent. Ces modifications sont écrites dans votre projet au moment de l'enregistrement et n'utilisent aucun crédit. L'exception est Demander à l'IA sur un texte ou une image, qui consomme des crédits et vous affiche le prix avant l'exécution.
  </Accordion>

  <Accordion title="Puis-je utiliser Macaly sur mon téléphone, ou dois-je télécharger une application ?">
    Macaly fonctionne parfaitement dans un navigateur mobile, vous pouvez donc créer et gérer vos projets directement depuis votre téléphone. La seule exception est la fonctionnalité Modifications visuelles, disponible uniquement sur les appareils à plus grand écran.
  </Accordion>
</AccordionGroup>

## Publication et déploiement

<AccordionGroup>
  <Accordion title="Comment publier mon projet ?">
    Cliquez sur le bouton **Publier** dans le coin supérieur droit de l'éditeur. Après la publication, votre site est en ligne sur un sous-domaine Macaly gratuit (par ex. `monprojet.macaly.app`). Pour connecter un domaine personnalisé, rendez-vous dans **Paramètres → Domaines**.
  </Accordion>

  <Accordion title="La publication est bloquée sur la compilation depuis longtemps. Que faire ?">
    L'interface de publication peut parfois prendre du retard après la fin d'une compilation. Ouvrez l'URL publiée et rechargez-la pour vérifier si la nouvelle version est déjà en ligne. Si le site est indisponible ou si l'état reste bloqué, contactez le support avec l'URL du chat, l'URL publiée, l'heure approximative et une capture d'écran ou les détails de l'erreur.
  </Accordion>

  <Accordion title="Mon aperçu affiche les modifications mais mon site en ligne ne les reflète pas. Pourquoi ?">
    L'URL d'aperçu et l'URL publiée (votre sous-domaine Macaly ou domaine personnalisé) sont des environnements séparés. Cliquez sur **Publier** pour envoyer les modifications vers le site en ligne, puis forcez l'actualisation de l'URL publiée. Si elle affiche toujours une ancienne version, contactez le support avec les deux URL et l'heure approximative de publication.
  </Accordion>

  <Accordion title="Puis-je télécharger le code source de mon projet ?">
    Oui. Rendez-vous dans les **Paramètres** de votre projet et utilisez l'option d'export pour télécharger un ZIP de votre code source.
  </Accordion>

  <Accordion title="Dois-je indiquer à mes visiteurs que mon site a été créé avec de l'IA ?">
    Chaque site publié porte une balise `ai-generated` lisible par machine, mais ce n'est pas une mention visible pour vos lecteurs. Savoir si vous devez signaler autre chose au sujet de votre contenu ou de vos propres fonctionnalités IA dépend du droit applicable et du cas d'usage précis. [Utiliser l'IA de façon responsable](/docs/fr/security/using-ai-responsibly) passe en revue les cas courants.
  </Accordion>

  <Accordion title="Mon application a son propre chatbot IA. La mention de la plateforme le couvre-t-elle ?">
    Non. Le message que vous voyez pendant la création concerne la plateforme. Si votre projet comporte un chatbot ou une autre fonctionnalité IA, en informer vos utilisateurs finaux fait partie de votre application. Demandez à l'agent d'ajouter une mention au-dessus de la fenêtre de chat ou au début de la conversation.
  </Accordion>
</AccordionGroup>

## Domaines et hébergement

<AccordionGroup>
  <Accordion title="Comment connecter mon propre domaine personnalisé ?">
    Dans votre projet, rendez-vous dans **Paramètres → Domaines**, saisissez votre nom de domaine et cliquez sur **Connecter**. Suivez ensuite le statut affiché. Certaines configurations en marque blanche configurent le DNS automatiquement ou activent le domaine via un proxy partenaire. Si la plateforme affiche des enregistrements DNS, ajoutez exactement ces valeurs chez votre registraire, puis revenez cliquer sur **Actualiser**.
  </Accordion>

  <Accordion title="Quels enregistrements DNS dois-je ajouter pour mon domaine personnalisé ?">
    Ajoutez des enregistrements uniquement lorsque **Paramètres → Domaines** vous le demande. Une configuration manuelle nécessite généralement deux enregistrements :

    * Un **enregistrement A** pour le domaine racine pointant vers l'adresse IP de Macaly
    * Un **enregistrement CNAME** pour `www` pointant vers le nom d'hôte de Macaly

    Les valeurs exactes sont affichées dans **Paramètres → Domaines** lorsque vous ajoutez votre domaine.
  </Accordion>

  <Accordion title="Mon site fonctionne avec www mais affiche une erreur SSL sur le domaine nu. Comment corriger ?">
    Vérifiez d'abord **Paramètres → Domaines**. Si un enregistrement apex manquant est affiché, ajoutez exactement l'enregistrement A indiqué et supprimez les enregistrements A ou AAAA conflictuels du domaine racine. Si votre fournisseur en marque blanche gère le DNS automatiquement ou utilise un proxy partenaire, actualisez le statut et contactez le support de votre marque au lieu de modifier les enregistrements à l'aveugle.
  </Accordion>

  <Accordion title="Mon domaine affiche toujours En attente ou Non connecté. Que faire ?">
    Si la page indique que le DNS est configuré automatiquement, attendez quelques minutes puis cliquez sur **Actualiser**. Pour une configuration manuelle, confirmez que les enregistrements chez votre registraire correspondent exactement aux valeurs affichées et supprimez les enregistrements conflictuels. La propagation DNS peut prendre jusqu'à 24 heures. Pour une configuration via proxy partenaire, contactez le support de votre marque si le domaine ne s'active pas.
  </Accordion>

  <Accordion title="Puis-je configurer un e-mail pour mon domaine personnalisé ?">
    Macaly ne fournit pas d'hébergement e-mail. Pour un e-mail sur votre domaine personnalisé (par ex. [info@votresite.com](mailto:info@votresite.com)), inscrivez-vous auprès d'un fournisseur tiers comme Google Workspace, Zoho ou Microsoft 365, et configurez leurs enregistrements MX chez votre registraire. Une fois que vous disposez d'une adresse e-mail, l'agent Macaly peut configurer des formulaires de contact pour envoyer des notifications à cette adresse.
  </Accordion>
</AccordionGroup>

## E-mail et notifications

<AccordionGroup>
  <Accordion title="Macaly peut-il envoyer des e-mails depuis mon projet ?">
    Oui. Macaly dispose d'une API e-mail intégrée propulsée par Resend. Par défaut, les e-mails sortants sont envoyés depuis `no-reply@macaly.dev`. Pour envoyer depuis votre propre adresse de domaine, vous avez besoin de votre propre compte Resend et de votre clé API. Demandez à l'agent de configurer la fonctionnalité e-mail et fournissez l'adresse d'expéditeur et de destinataire souhaitée.
  </Accordion>

  <Accordion title="Quelles sont les limites d'envoi d'e-mails ?">
    La limite par défaut est de 10 e-mails maximum par minute par application. Macaly ne peut qu'envoyer des e-mails, pas en recevoir. Il n'est pas adapté aux newsletters ou aux e-mails marketing en masse.
  </Accordion>

  <Accordion title="Mes e-mails de connexion OTP n'arrivent pas. Que faire ?">
    Vérifiez d'abord votre dossier de spam ou courrier indésirable. Si les e-mails n'arrivent vraiment pas, contactez le support avec le lien de votre projet et l'adresse e-mail concernée. L'équipe peut examiner la livraison des e-mails côté serveur.
  </Accordion>
</AccordionGroup>

## Travailler avec l'agent

<AccordionGroup>
  <Accordion title="L'agent est bloqué ou met trop de temps. Que puis-je faire ?">
    Si l'agent ne montre aucun progrès pendant plus de 10 à 15 minutes, rechargez d'abord la page. Si l'aperçu est figé, ouvrez son menu et choisissez **Rebuild Preview** pour les projets récents ou **Restart App** pour les projets plus anciens.

    Si la dernière modification a cassé le projet, utilisez l'**Historique des versions** lorsqu'il est disponible, ou **Restaurer cette version** sous la dernière bonne réponse de l'agent. Si le problème persiste, signalez-le depuis la réponse concernée et joignez le lien du chat, l'heure approximative et une capture d'écran ou les détails de l'erreur.
  </Accordion>

  <Accordion title="L'agent refait toujours la même erreur. Comment éviter de consommer des crédits inutilement ?">
    Lorsque vous signalez une erreur, soyez aussi précis que possible. Décrivez ce que vous faisiez avant l'erreur, ce que vous voyez maintenant, ce qui ne fonctionne pas et quel devrait être le comportement correct. Plus vous fournissez de détails, mieux l'agent pourra résoudre le problème du premier coup.
  </Accordion>

  <Accordion title="Dois-je diviser une demande importante en étapes plus petites ?">
    Oui. La quantité de travail que l'agent peut accomplir dépend de la tâche et peut inclure du travail en parallèle : il n'existe donc pas de limite d'étapes unique et utile. Divisez les demandes importantes ou dépendantes en prompts gérables, vérifiez chaque résultat, puis continuez.
  </Accordion>

  <Accordion title="Comment créer une sauvegarde de mon projet ?">
    Utilisez l'**Historique des versions** lorsqu'il est disponible ou **Restaurer cette version** pour revenir à une version fonctionnelle. Dupliquez le projet lorsque vous voulez une branche indépendante pour expérimenter, et non comme mécanisme principal de récupération. Les duplicatas ordinaires commencent sans historique de conversation. Pour un projet avec base de données, vous choisissez de créer une nouvelle base ou de conserver la même.
  </Accordion>

  <Accordion title="Puis-je restaurer une version précédente de mon projet ?">
    Oui. Ouvrez l'**Historique des versions** lorsqu'il est disponible pour parcourir les aperçus précédents, identifier les versions la plus récente et publiée, les ouvrir séparément ou les restaurer. Vous pouvez aussi utiliser **Restaurer cette version** sous une réponse de l'agent pour revenir à cet état du code.
  </Accordion>

  <Accordion title="Quand utiliser /compact ?">
    Utilisez `/compact` lorsqu'un long chat commence à perdre le fil ou avant une nouvelle tâche liée à la précédente. La commande résume la conversation tout en conservant le même projet et le même code. La création du résumé utilise des crédits et nécessite un solde minimum, mais le contexte raccourci peut réduire le coût des messages suivants. Évitez de l'utiliser après chaque message, car des résumés répétés peuvent perdre des détails.
  </Accordion>
</AccordionGroup>

## Problèmes techniques et erreurs

<AccordionGroup>
  <Accordion title="Que signifie le code d'erreur 524 ou un timeout ?">
    L'erreur 524 est un timeout, ce qui signifie que le serveur n'a pas répondu à temps. Essayez de rafraîchir la page après une ou deux minutes. Si le problème persiste, contactez le support avec le lien de votre chat. Vous pouvez vérifier les incidents en cours sur status.macaly.com.
  </Accordion>

  <Accordion title="L'aperçu indique Échec du démarrage ou le serveur de développement a planté. Que faire ?">
    Rechargez d'abord la page. Si l'aperçu ne démarre toujours pas, ouvrez son menu et choisissez **Rebuild Preview** pour les projets récents ou **Restart App** pour les projets plus anciens. Si l'échec persiste, contactez le support avec le lien du chat, l'heure approximative et les détails de l'erreur.
  </Accordion>

  <Accordion title="J'obtiens « Application error: a client-side exception has occurred ». Quel est le problème ?">
    La traduction automatique du navigateur peut parfois perturber l'éditeur. Désactivez-la pour le domaine de la plateforme et rechargez la page comme première vérification. Si l'erreur persiste ou apparaît sur le site publié, signalez-la avec l'URL du chat, l'URL publiée, l'heure approximative et une capture d'écran ou les détails de l'erreur.
  </Accordion>

  <Accordion title="Pourquoi une autre personne ne peut-elle pas ouvrir le lien d'aperçu que j'ai copié ?">
    Un aperçu privé peut nécessiter une session autorisée sur la plateforme. N'utilisez pas l'URL copiée directement depuis un aperçu privé comme lien public. Dans **Partager**, définissez le projet sur **Toute personne disposant du lien**, puis envoyez le lien partagé généré. Si un collègue autorisé voit toujours une page non autorisée ou vide, rechargez le projet et contactez le support si le problème continue.
  </Accordion>

  <Accordion title="Le téléchargement d'images échoue. Quelles sont les limites de taille ?">
    Les images individuelles ne doivent pas dépasser 8000x8000 pixels. Si vous téléchargez plus de 20 images en une seule requête, chacune doit être inférieure à 2000x2000 pixels. Les fichiers doivent peser moins de 5 Mo. Si vous rencontrez une erreur de téléchargement SVG, contactez le support.
  </Accordion>
</AccordionGroup>

## Duplication de projets

<AccordionGroup>
  <Accordion title="Comment dupliquer un projet ?">
    Ouvrez le menu du chat et sélectionnez **Dupliquer**. Un duplicata normal copie le code, le contenu et les fichiers du projet sans l'historique de conversation. Si le projet possède une base de données, choisissez **Créer une nouvelle base de données** pour copier les données actuelles dans une base indépendante, ou **Utiliser la même base de données** pour que les deux projets lisent et écrivent les mêmes données. La seconde option n'est disponible que dans le même workspace.

    Les secrets sont copiés automatiquement lorsque vous dupliquez votre propre projet. Les copies d'un projet partagé ou d'un modèle n'héritent pas des données d'environnement sensibles. Republiez le duplicata et reliez tout domaine personnalisé qu'il doit utiliser.
  </Accordion>

  <Accordion title="Les duplicatas partagent-ils la même base de données ?">
    Cela dépend du choix effectué lors de la duplication. **Créer une nouvelle base de données** copie les données actuelles dans une base indépendante : les changements ultérieurs de schéma ou de données ne passent pas d'un projet à l'autre. **Utiliser la même base de données** maintient les deux projets connectés à une seule base, et les changements de l'un sont visibles dans l'autre.
  </Accordion>

  <Accordion title="Puis-je partager mon projet pour que quelqu'un d'autre le duplique dans son compte ?">
    Oui. Cliquez sur **Partager** à côté du bouton **Publier** et définissez la visibilité sur **Toute personne disposant du lien**. Partagez le lien. Toute personne qui l'ouvre peut consulter le projet et le dupliquer dans son propre compte Macaly.
  </Accordion>

  <Accordion title="Je crée des sites web pour mes clients. Peuvent-ils reprendre le site dans leur propre compte Macaly ?">
    Oui. Tout projet peut être dupliqué et partagé avec votre client. Celui-ci peut ensuite continuer à développer et gérer le site dans son propre compte Macaly, indépendamment de vous.
  </Accordion>
</AccordionGroup>

## Bases de données

<AccordionGroup>
  <Accordion title="Quelle base de données utilise Macaly ?">
    Les projets Macaly utilisent Convex comme base de données backend. Vous pouvez consulter et gérer vos données via l'onglet **Base de données** dans l'éditeur Macaly.
  </Accordion>

  <Accordion title="Puis-je exporter ou importer la base de données de mon projet ?">
    Oui, directement depuis l'onglet **Base de données**. **Exporter** télécharge un instantané complet de vos données au format ZIP, utile comme sauvegarde ou pour migrer vers votre propre compte Convex. **Importer** restaure un instantané dans votre projet ; cela remplace toutes les données existantes, Macaly demande donc une confirmation explicite avant de continuer.
  </Accordion>

  <Accordion title="Puis-je migrer la base de données de mon projet vers mon propre compte Convex ?">
    Oui. Exportez un instantané de la base de données (ZIP) depuis l'onglet **Base de données**, créez votre propre compte Convex, importez l'instantané en suivant le guide sur docs.convex.dev, puis mettez à jour les secrets Convex dans les paramètres de votre projet Macaly. Il y aura une brève interruption pendant la transition.
  </Accordion>

  <Accordion title="Si je passe à ma propre base de données Convex, puis-je continuer à utiliser Macaly pour créer ?">
    Oui. Vous pouvez continuer à développer avec Macaly après avoir migré vers votre propre base de données Convex. L'onglet **Base de données** dans Macaly ne fonctionnera plus, mais toutes les autres fonctionnalités continuent normalement.
  </Accordion>
</AccordionGroup>

## SEO

<AccordionGroup>
  <Accordion title="Comment Macaly gère-t-il le référencement ?">
    Macaly crée des sites optimisés pour les moteurs de recherche. Le rendu côté serveur, un HTML propre et les balises meta sont pris en charge par Macaly. Dès que vous publiez votre projet, l'audit SEO évalue votre site et vous indique quoi améliorer. Vous pouvez aussi modifier les balises meta, les titres de page et les descriptions dans **Paramètres → SEO**.
  </Accordion>

  <Accordion title="Pourquoi ne puis-je pas lancer l'audit SEO ?">
    L'audit n'analyse votre site qu'après la publication. Si vous n'avez pas encore publié votre projet, publiez-le et l'audit se lancera automatiquement.
  </Accordion>

  <Accordion title="Mon audit SEO semble obsolète. Pourquoi ?">
    L'audit reflète votre dernière version publiée. Si vous avez modifié quelque chose depuis, publiez à nouveau votre projet et les résultats de l'audit seront actualisés.
  </Accordion>

  <Accordion title="Qu'est-ce que la préparation IA ?">
    La préparation IA mesure la capacité des crawlers IA, comme ceux de ChatGPT, Claude ou Perplexity, à accéder à votre site et à le comprendre. Elle vérifie que votre contenu se trouve directement dans la page plutôt que chargé en JavaScript, que les crawlers IA ne sont pas bloqués et qu'un fichier llms.txt est disponible pour les guider. Macaly effectue automatiquement le rendu de vos pages sur le serveur.
  </Accordion>

  <Accordion title="Comment améliorer mon score SEO ?">
    Parcourez la liste des problèmes, d'abord les erreurs, puis les avertissements. Utilisez le bouton Tout corriger avec l'IA pour transmettre tous les problèmes à l'agent en une fois, ou traitez-les un par un. Publiez ensuite vos modifications et le score sera mis à jour lors du prochain audit.
  </Accordion>

  <Accordion title="Mon site n'apparaît pas dans les résultats Google. Que puis-je faire ?">
    L'indexation par Google prend du temps, souvent plusieurs jours à plusieurs semaines. Pour l'accélérer, soumettez l'URL de votre site à Google Search Console sur search.google.com/search-console. Vous pouvez aussi partager votre URL sur les réseaux sociaux, car Google explore les liens qu'il trouve ailleurs sur le web.
  </Accordion>

  <Accordion title="Puis-je intégrer un site Macaly dans un autre site web via un iframe ?">
    Techniquement oui, en utilisant l'URL publiée de votre site Macaly dans un iframe. Cependant, le contenu à l'intérieur des iframes est mal indexé par les moteurs de recherche, ce qui a un impact négatif sur votre référencement. Une meilleure approche consiste à utiliser Macaly comme un site autonome avec son propre domaine personnalisé.
  </Accordion>
</AccordionGroup>

## Gestion du compte

<AccordionGroup>
  <Accordion title="Comment modifier mon adresse e-mail ?">
    Contactez le support et fournissez la nouvelle adresse e-mail. Ils la mettront à jour côté serveur. Remarque : vous ne pouvez pas utiliser une adresse e-mail déjà associée à un autre compte Macaly.
  </Accordion>

  <Accordion title="Je ne peux pas me connecter et je ne reçois pas les e-mails OTP.">
    Vérifiez d'abord votre dossier de spam ou courrier indésirable. Si l'e-mail n'arrive pas du tout, contactez le support. Ils peuvent vérifier l'état de votre compte et vous aider avec l'authentification.
  </Accordion>

  <Accordion title="Comment supprimer définitivement mon compte ?">
    Contactez le support et demandez la suppression de votre compte. Ils supprimeront votre compte et toutes les données associées. Remarque : cette action est irréversible. Tous les projets, crédits et données seront définitivement supprimés.
  </Accordion>
</AccordionGroup>

## Support

<AccordionGroup>
  <Accordion title="Quel est le délai de réponse du support Macaly ?">
    L'équipe s'efforce de répondre dans un délai d'un jour ouvrable. Le support est basé en Europe (fuseau horaire CET) et est fermé le week-end. Pendant les périodes de vacances, les réponses peuvent prendre un peu plus de temps.
  </Accordion>

  <Accordion title="Comment demander l'examen des crédits utilisés par une réponse défaillante ?">
    Sur la réponse concernée, choisissez **Signaler un problème** puis, si l'option est disponible pour votre workspace, sélectionnez **Demander un examen des crédits**. L'examen automatisé prend généralement environ une minute et peut restaurer les crédits en cas d'échec clair de l'agent ou de la plateforme. Si l'option n'est pas disponible ou si le résultat doit être réexaminé, contactez le support avec le lien du chat et les détails du signalement.
  </Accordion>

  <Accordion title="Existe-t-il une page de statut où je peux vérifier les pannes ?">
    Oui. [status.macaly.com](https://status.macaly.com) affiche des informations sur les incidents actifs et les pannes récentes.
  </Accordion>
</AccordionGroup>


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