Un domaine personnalisé donne à votre app Coderblock une adresse de production facilement reconnaissable, sans vous obliger à utiliser l’URL Coderblock automatiquement attribuée au projet.

Vous pouvez :

• connecter un domaine que vous possédez déjà en configurant les enregistrements DNS à l’aide de l’assistant ;
• acheter un nouveau domaine directement dans Coderblock et laisser la plateforme gérer DNS et SSL.

Dans ce tutoriel, nous allons examiner les deux options et voir comment vérifier que tout fonctionne correctement après la publication.

Avant de connecter un domaine

Avant de configurer le domaine, assurez-vous que l’app est prête à être publiée.

Ouvrez l’aperçu de développement en direct à l’adresse <app>.coderblock.dev et testez les principaux parcours de l’app, notamment :

• la navigation et la mise en page sur mobile ;
• l’inscription et la connexion, si vous utilisez des comptes ;
• les formulaires et les fonctionnalités liées à la base de données ;
• le paiement Stripe, si vous avez activé les paiements ;
• l’espace d’administration et les autres sections protégées.

Si vous trouvez quelque chose à corriger, il vous suffit de le demander à l’agent Coderblock en langage naturel. Par exemple :

Rends la navigation responsive et vérifie que le formulaire d’inscription affiche des messages d’erreur de validation clairs.

L’app sera mise à jour dans l’aperçu en direct en quelques secondes. Le domaine personnalisé ne remplace pas l’URL de développement : il ajoute simplement une nouvelle adresse à la version de production publiée de l’app.

À ce stade, choisissez la configuration à utiliser :

1. Connecter un domaine que vous possédez déjà : vous devrez modifier ses enregistrements DNS auprès du registrar ou du fournisseur DNS qui gère le domaine.
2. Acheter un domaine dans Coderblock : vous effectuerez le paiement directement sur la plateforme, puis Coderblock configurera automatiquement DNS et SSL.

---

Option A : connectez un domaine que vous possédez déjà

Cette option convient si vous avez déjà acheté un domaine auprès d’un autre fournisseur et que vous pouvez modifier ses paramètres DNS.

Étape 1 : ouvrez les paramètres des domaines

Ouvrez le projet Coderblock et accédez à Paramètres → Domaines. Sélectionnez l’option permettant de connecter un domaine existant. Saisissez le domaine que vous souhaitez utiliser pour votre app et vérifiez attentivement son orthographe avant de continuer.

---

Étape 2 : vérifiez les enregistrements DNS

Coderblock affichera les enregistrements DNS nécessaires pour connecter le domaine au projet. Gardez cette page ouverte : vous en aurez besoin pour copier les noms, les types et les valeurs indiqués dans l’interface de votre fournisseur DNS. Utilisez exactement les enregistrements affichés pour votre projet. Ne les remplacez pas par des valeurs trouvées dans d’autres tutoriels ou dans des configurations destinées à d’autres services : la destination dépend de l’app précise que vous connectez.

---

Étape 3 : ouvrez l’interface du fournisseur DNS

Ouvrez un nouvel onglet dans votre navigateur et connectez-vous au service qui gère les DNS de votre domaine. Il peut s’agir du registrar auprès duquel vous avez acheté le domaine ou d’un fournisseur DNS distinct. Recherchez la section consacrée à la gestion des DNS. Selon le service, elle peut s’appeler :

• DNS
• Enregistrements DNS
• Éditeur de zone
• Gérer les DNS

---

Étape 4 : ajoutez les enregistrements indiqués par Coderblock

Créez ou mettez à jour les enregistrements DNS afin qu’ils correspondent aux valeurs affichées par Coderblock. Copiez soigneusement chaque champ, puis enregistrez les modifications. Avant de supprimer un enregistrement existant, vérifiez toujours à quoi il sert. Un domaine peut utiliser d’autres enregistrements, par exemple pour la messagerie ou pour des services autres que l’app web. Modifiez uniquement les enregistrements qui entrent en conflit avec l’adresse que vous souhaitez connecter et ne touchez pas aux autres. Si le fournisseur ajoute automatiquement le nom de domaine au champ de l’hôte, suivez ses consignes de formatage. L’objectif est que l’enregistrement sauvegardé représente le même hôte et la même destination que ceux indiqués par Coderblock.

---

Étape 5 : revenez dans Coderblock

Revenez dans Paramètres → Domaines et poursuivez la procédure de connexion. Gardez à l’esprit que les mises à jour DNS ne deviennent pas nécessairement visibles partout au même moment. Le domaine peut donc ne pas être disponible immédiatement après l’enregistrement des modifications. Si la validation échoue, comparez de nouveau chaque champ avec les valeurs affichées par Coderblock. Vérifiez en particulier :

• les éventuelles fautes de saisie ;
• les enregistrements en double ;
• les anciens enregistrements qui redirigent le même hôte vers une autre destination.

Publiez et testez l’app en production

Une fois le domaine connecté, cliquez sur Publier pour déployer la version de production. Coderblock publiera l’app à l’adresse <app>.coderblock.app ou sur le domaine personnalisé connecté, avec SSL inclus.

Ouvrez le domaine personnalisé dans un nouvel onglet et vérifiez que :

• la page se charge via https:// ;
• le navigateur affiche le bon domaine ;
• les liens de navigation restent sur l’adresse de production ;
• l’authentification et les pages protégées fonctionnent ;
• les formulaires lisent et enregistrent correctement les données dans la base de données Postgres ;
• les paiements utilisent le mode Stripe prévu ;
• les images et les fichiers se chargent correctement depuis le stockage.

Si l’app est destinée au public, effectuez quelques tests sur ordinateur comme sur mobile. Et le travail ne s’arrête pas au domaine : vous pouvez continuer à modifier l’app par chat, vérifier les mises à jour dans l’aperçu en direct, puis la republier lorsque vous êtes prêt à les mettre en production.

Option B : achetez un domaine directement dans Coderblock

Si vous ne possédez pas encore de domaine adapté, vous pouvez en acheter un directement sur la plateforme. Ouvrez Paramètres → Domaines et sélectionnez l’option permettant d’acheter un nouveau domaine. Choisissez le domaine qui vous convient et effectuez le paiement dans Coderblock.

Dans ce cas, DNS et SSL sont configurés automatiquement : vous n’avez donc aucun enregistrement à copier ni aucune modification manuelle à effectuer dans l’interface DNS d’un service externe. Une fois l’achat et la configuration terminés, publiez l’app et procédez aux mêmes vérifications que dans la section précédente.

Vérifiez notamment :

• l’adresse HTTPS ;
• la connexion et l’inscription ;
• les formulaires ;
• les fichiers et les images ;
• les éventuels parcours de paiement.

Si le domaine ne se charge pas

Si le domaine connecté ne fonctionne pas comme prévu, commencez par cette checklist :

1. Vérifiez le domaine. Assurez-vous que le domaine saisi dans Coderblock correspond exactement à celui dont vous avez modifié les DNS.
2. Revérifiez les enregistrements DNS. Un seul caractère incorrect peut empêcher la connexion de fonctionner.
3. Recherchez d’éventuels conflits. Un ancien enregistrement peut encore rediriger le même hôte vers un autre service.
4. Attendez la mise à jour des DNS. La propagation des modifications peut prendre un certain temps.
5. Vérifiez que vous avez publié l’app. L’aperçu de développement et la version de production sont des environnements distincts.
6. Testez l’adresse HTTPS complète. Saisissez directement l’URL avec https://.
7. Essayez une fenêtre de navigation privée. Cela permet d’écarter les problèmes liés au cache, aux redirections ou aux anciennes versions enregistrées par le navigateur.

Point important : ne modifiez pas continuellement les enregistrements DNS pendant la mise à jour de la configuration. Si les valeurs correspondent à celles indiquées par Coderblock, des modifications inutiles risquent de compliquer davantage le processus.

Checklist finale

Le domaine est correctement configuré lorsque :

• le domaine apparaît dans Paramètres → Domaines du projet ;
• les enregistrements DNS correspondent à la configuration indiquée par Coderblock, ou ont été configurés automatiquement après un achat effectué sur la plateforme ;
• l’app a été publiée ;
• le domaine personnalisé s’ouvre via HTTPS ;
• les principaux parcours de l’app fonctionnent correctement en production.

Votre domaine est prêt

Votre app Coderblock dispose désormais d’une adresse de production personnalisée et peut être partagée avec vos clients, vos utilisateurs et les parties prenantes. Vous pouvez maintenant poursuivre son développement normalement : chat → modification → aperçu → publication, tout en conservant le domaine personnalisé comme point d’accès à la version en ligne.