Travailler avec les branches

Les branches vous permettent d’essayer de nouvelles idées, fonctionnalités ou redesigns sans affecter votre application. Chaque branche a son propre chat et son propre aperçu en direct, et vous pouvez travailler sur plusieurs branches en parallèle, puis fusionner chacune dans votre application quand vous êtes satisfait du résultat.

---

​

Comment fonctionnent les branches

La version principale de votre application s’appelle main. Quand vous créez une branche, Base44 démarre une ligne de travail séparée depuis l’état actuel de main. Chaque branche conserve son propre chat, son aperçu en direct et sa copie du design et des pages de votre application, donc les modifications que vous apportez restent sur la branche jusqu’à ce que vous les fusionniez. Une branche se construit aussi indépendamment et conserve son propre historique de versions, donc les branches s’exécutent en parallèle et vous pouvez revenir à n’importe quel point antérieur sans toucher à main. Certaines choses restent partagées entre main et chaque branche. Les données de votre application sont les mêmes enregistrements en direct partout, et les modifications d’enregistrements se produisent sur main. Vos connexions et votre automatisation, y compris les intégrations, secrets, automatisations, workflows et agents in-app, sont partagées aussi, de même que les paramètres de votre application, les domaines et la version publiée.

---

​

Créer une branche

Décrivez ce que vous voulez construire, et Base44 crée la branche, la nomme d’après votre premier message et commence à construire immédiatement. Les noms de branche sont courts, 3 mots ou moins, et toujours en anglais, quelle que soit la langue dans laquelle vous écrivez. Le nom est défini automatiquement, et une branche ne peut pas être renommée.

​

Démarrer une nouvelle branche

Démarrez une branche depuis le menu des branches lorsque vous avez une nouvelle idée à construire. Pour créer une branche :

1. Dans l’éditeur d’application, cliquez sur le logo ou le nom de votre application en haut du panneau de chat.
2. Cliquez sur Create new branch.
3. Choisissez l’une des suggestions, ou tapez ce que vous voulez construire dans la zone de chat.
4. Envoyez le message.

Les branches fonctionnent aussi sur votre téléphone, à la fois dans un navigateur mobile et dans l’application Base44. Le menu des branches apparaît en haut de l’éditeur dès que votre application a une branche, donc créez votre première branche depuis un navigateur de bureau, puis passez d’une branche à l’autre, construisez et fusionnez depuis votre téléphone.

​

Créer une branche à partir d’un message

Créez une branche à partir de n’importe quel message que vous avez envoyé dans le chat principal pour essayer une autre direction à partir de ce point. La nouvelle branche part de votre application telle qu’elle était à ce message, et vous restez sur main pendant sa création. Cette option est disponible sur main dans un navigateur de bureau, mais pas pendant la construction de votre application. Pour créer une branche à partir d’un message :

1. Survolez un message que vous avez envoyé dans le chat principal de votre éditeur d’application.
2. Cliquez sur l’icône Branch from here en dessous.

   

3. Lorsque la branche est prête, ouvrez-la depuis le menu des branches en haut du panneau de chat.

​

Créer une branche à partir d’une invite en file d’attente

Lorsque l’IA est occupée à construire sur main, vous pouvez déplacer une invite en attente de la file d’attente vers sa propre branche, pour qu’elle s’exécute en même temps au lieu d’attendre son tour. La branche part de votre dernière version enregistrée, sans les modifications encore en cours de construction. Cela fonctionne donc mieux pour les modifications qui ne dépendent pas de ce qui est en cours. Cette option est disponible sur main dans un navigateur de bureau, sur les applications que vous construisez seul. Les applications avec des collaborateurs utilisent une file d’attente partagée, qui ne la propose pas. Pour exécuter une invite en file d’attente sur une branche :

1. Cliquez sur l’icône Run in a parallel branch sur l’invite en attente que vous voulez déplacer, dans la file d’attente au-dessus de la zone de saisie du chat de votre éditeur d’application.
2. Cliquez sur Run on a branch, ou cliquez sur Keep in queue pour la laisser où elle est.
3. Cliquez sur Open branch dans le chat pour suivre l’invite sur sa nouvelle branche.

​

Importer depuis GitHub

Quand votre application est connectée à GitHub, vous pouvez construire sur une branche qui existe déjà dans votre dépôt. Base44 travaille sur cette branche elle-même, donc vos modifications et celles de Base44 vont vers la même branche dans votre dépôt. Pour importer une branche depuis GitHub :

1. Dans l’éditeur d’application, cliquez sur le logo ou le nom de votre application en haut du panneau de chat.
2. Cliquez sur Import from GitHub.
3. Recherchez la branche que vous voulez, puis sélectionnez-la.
4. Cliquez sur Import.

---

​

Travailler sur une branche

Pendant que vous êtes sur une branche, le nom de la branche remplace le nom de votre application en haut du panneau de chat, et une icône tournante s’affiche quand l’IA travaille. Vous construisez sur une branche de la même façon que sur main : décrivez ce que vous voulez dans le chat. Sélectionner un élément et effectuer une modification visuelle s’enregistre aussi sur la branche où vous êtes, comme vos modifications dans le chat. Quelques éléments fonctionnent différemment sur une branche :

• Merge to main remplace le bouton Publish. Vous publiez les modifications depuis main après la fusion.
• L’aperçu montre la version de votre application propre à la branche.
• L’URL de la page inclut la branche, vous pouvez donc partager un lien qui ouvre l’éditeur d’application sur cette branche.

​

Passer d’une branche à l’autre

Vous pouvez passer de main à vos branches à tout moment, et chaque branche conserve ses modifications jusqu’à ce que vous la fusionniez. Sur une branche, vous pouvez aussi cliquer sur le X à côté de Merge to main pour revenir à main. L’icône à côté de chaque branche montre son statut actuel. Survolez l’icône pour voir l’étiquette : Pour passer à une autre branche ou revenir à main :

1. Cliquez sur le nom de la branche en haut du panneau de chat dans votre éditeur d’application.
2. Sélectionnez une branche dans la liste, ou sélectionnez Main chat pour revenir à main.

​

Rejoindre la branche d’un collaborateur

Lorsque vous travaillez sur une application avec d’autres personnes, les avatars en haut de l’éditeur d’application indiquent sur quelle branche se trouve chacun. Vous pouvez accéder directement à la branche d’un collaborateur, et lorsque quelqu’un rejoint votre branche, Base44 affiche un court message l’indiquant. Pour rejoindre la branche d’un collaborateur :

1. Survolez l’avatar d’un collaborateur en haut de l’éditeur d’application pour voir son nom et sa branche.

   

2. Cliquez sur l’avatar pour ouvrir la branche sur laquelle il se trouve.

​

Ce qui reste sur main

Vous faites la majeure partie de votre construction sur une branche, mais certaines actions affectent toute votre application, pas seulement une branche. Celles-ci se produisent toujours sur main, même pendant que vous travaillez sur une branche :

• Publier votre application
• Créer ou modifier des secrets, connecteurs, automatisations, workflows et agents in-app
• Modifier les paramètres de thème de votre application
• Annuler un message dans le chat, ou en modifier et renvoyer un
• Ajouter une page depuis Figma
• Demander à l’IA d’ajouter, modifier, supprimer ou importer des enregistrements

​

Entités

Vous pouvez créer des entités et ajouter des champs aux entités existantes sur une branche, et les deux sont actifs immédiatement dans l’aperçu propre à cette branche. Sur une entité que vous créez, vous définissez tout, y compris ses permissions de données. Sur une entité qui existe déjà, les ajouts s’appliquent, alors gardez un nouveau champ facultatif, car vos enregistrements existants ne l’ont pas encore. Supprimer une entité ou un champ, changer le type d’un champ existant ou son caractère obligatoire, et modifier les permissions de données se font sur main. Effectuez la modification là-bas et votre branche la récupère immédiatement, sans fusion ni mise à jour nécessaire. Les enregistrements sont les données en direct de votre application, partagées avec main, donc demandez à l’IA les modifications d’enregistrements sur main plutôt que sur une branche. Ajouter, modifier ou supprimer des enregistrements vous-même lors de la prévisualisation d’une branche fonctionne comme toujours, et cela modifie les mêmes données que votre application utilise partout.

​

Fonctions backend

Vous pouvez ajouter et modifier des fonctions backend sur une branche. La branche obtient sa propre copie de chaque fonction que vous touchez, ainsi que des fichiers partagés que ces fonctions importent, vous pouvez donc mettre à jour un utilitaire et la fonction qui l’utilise ensemble. L’aperçu de la branche appelle la version de la branche, et fusionner la branche la déploie sur main. La première fonction backend de votre application est créée sur main, et vous pouvez ensuite travailler sur les fonctions depuis une branche. Sur une application importée depuis GitHub, les modifications backend restent sur main.

​

Code

L’onglet Code affiche les fichiers de votre application tels qu’ils sont sur la branche où vous êtes, plutôt que tels qu’ils sont sur main. Vous pouvez les modifier là, et ce que vous enregistrez reste dans la branche jusqu’à la fusion. Les fichiers derrière les pages, la mise en page et le style de votre application s’enregistrent directement dans la branche. Vous pouvez donc essayer une modification de code sans toucher à main. Les fichiers de fonctions backend s’enregistrent aussi dans la branche. Consultez les fonctions backend sur une branche pour savoir quand une modification est active dans l’aperçu de la branche et quand elle attend la fusion. Vous n’avez pas besoin de savoir lequel est lequel. Quelques fichiers modifient toute votre application plutôt qu’une seule branche, et Base44 bloque l’enregistrement en vous indiquant où aller à la place :

• Fichiers d’entités : demandez la modification dans le chat de la branche, ou passez sur main. Consultez les entités sur une branche pour savoir ce qu’une branche peut modifier seule.
• Tout ce qui modifierait votre application en direct : effectuez la modification sur main, et votre branche la récupère sans fusion nécessaire.

---

​

Utiliser l’historique de versions

Chaque version enregistrée sur une branche est listée dans l’historique de versions propre à cette branche, vous pouvez donc revoir comment la branche s’est développée, la comparer avec main et revenir à n’importe quel point antérieur.

​

Restaurer une version

Restaurer une version ne modifie que cette branche, et main reste exactement tel quel. La restauration ramène les pages, le design, les entités et les fonctions backend de la branche à cette version, et le chat de la branche revient au message qui l’a créée. Vos enregistrements sont partagés avec main, ils restent donc tels quels. Vos versions ultérieures restent dans la liste, vous pouvez donc avancer à nouveau quand vous voulez. Une branche fusionnée garde son historique de versions lisible, et vous pouvez restaurer tant qu’une branche est encore active. Pour restaurer une version antérieure d’une branche :

1. Cliquez sur l’icône Version History en haut du panneau de chat pendant que vous êtes sur la branche.
2. Cliquez sur une version dans la liste pour la charger dans l’aperçu.
3. Cliquez sur l’icône More options à côté de cette version.
4. Cliquez sur Revert to this version.

​

Comparer avec main

Avant de fusionner, vous pouvez vérifier exactement en quoi le code d’une version diffère de main. Base44 ouvre une fenêtre Changes compared with main qui liste chaque fichier différent et ce qui a changé dans chacun. Pour comparer une version de branche avec main :

1. Cliquez sur l’icône Version History en haut du panneau de chat pendant que vous êtes sur la branche.
2. Cliquez sur l’icône More options à côté de la version à comparer.
3. Cliquez sur Compare code vs main.

   

4. Cliquez sur un fichier dans la liste pour voir ce qui y a changé.

   

---

​

Mettre à jour depuis main

Si main change pendant que votre branche est ouverte, une carte apparaît au-dessus de la zone de chat sur la branche. Elle vous indique l’ampleur des changements sur main et si certains chevauchent votre branche. Lorsque vous mettez à jour, l’IA combine les modifications de main avec votre branche. Si certaines modifications se chevauchent, l’IA les résout pour vous. Si les 2 versions sont réellement en conflit, l’IA vous pose une question dans le chat pour que vous décidiez quoi conserver. Pour intégrer les dernières modifications de main dans votre branche :

1. Sur la branche, trouvez la carte de mise à jour au-dessus de la zone de chat.
2. Cliquez sur Update branch.

Vous pouvez aussi démarrer une mise à jour depuis le menu des branches. Cliquez sur l’icône More actions à côté d’une branche, puis cliquez sur Update from main.

---

​

Fusionner dans main

La fusion apporte tout ce que vous avez construit sur la branche dans main. Vos modifications n’atteignent les utilisateurs de votre application que lorsque vous publiez depuis main, vous décidez donc exactement ce qui sort et quand. Après la fusion, un résumé des modifications de la branche apparaît dans le chat de main, et la branche reste dans votre liste de branches comme fusionnée, vous pouvez donc toujours lire son historique de chat, mais elle devient en lecture seule. Pour fusionner une branche :

1. Sur la branche, cliquez sur Merge to main en haut de l’éditeur.
2. Vérifiez la confirmation, puis cliquez sur Merge to main.

Vous pouvez aussi fusionner depuis le menu des branches. Cliquez sur l’icône More actions à côté d’une branche, puis cliquez sur Merge to main.

---

​

Supprimer une branche

Supprimez une branche quand vous en avez fini avec une idée et voulez la retirer de votre liste. Votre application et vos autres branches restent telles quelles. Pour supprimer une branche :

1. Cliquez sur le nom de la branche en haut du panneau de chat.
2. Cliquez sur l’icône More actions à côté de la branche que vous voulez supprimer.
3. Cliquez sur Delete.
4. Vérifiez la confirmation, puis cliquez sur Delete branch.

---

​

FAQ

Cliquez sur une question ci-dessous pour en savoir plus sur les branches.