Skip to main content

Premiers pas

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.
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.
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.
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.
Oui. Les modifications visuelles 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.
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.

Publication et déploiement

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.
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.
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.
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.
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 passe en revue les cas courants.
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.

Domaines et hébergement

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.
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.
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.
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.
Macaly ne fournit pas d’hébergement e-mail. Pour un e-mail sur votre domaine personnalisé (par ex. 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.

E-mail et notifications

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

Travailler avec l’agent

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

Problèmes techniques et erreurs

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

Duplication de projets

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

Bases de données

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

SEO

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

Gestion du compte

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

Support

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.
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.
Oui. status.macaly.com affiche des informations sur les incidents actifs et les pannes récentes.