> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Importer votre projet GitHub

> Importez votre projet depuis GitHub et continuez à le développer dans Base44.

Importez votre projet GitHub dans Base44 et continuez à le développer. Toute votre équipe peut apporter de vraies modifications, et votre dépôt reste la source de vérité.

<CardGroup cols={2}>
  <Card title="Développez de partout" icon="globe">
    Travaillez sur votre projet depuis un ordinateur ou un mobile. Base44 l'exécute dans le cloud, donc rien à installer.
  </Card>

  <Card title="Amenez votre équipe" icon="users">
    Vos coéquipiers peuvent modifier le code via le chat IA, même sans exécuter le code localement.
  </Card>

  <Card title="Gardez votre flux GitHub" icon="code-branch">
    Chaque modification est enregistrée sur une branche de votre dépôt. Vous ouvrez une pull request quand le travail est prêt.
  </Card>

  <Card title="Plusieurs modèles IA" icon="layer-group">
    Utilisez n'importe quel modèle IA disponible dans Base44, sans gérer d'abonnements séparés.
  </Card>
</CardGroup>

***

## Importer votre projet

Importez un dépôt depuis votre compte GitHub connecté ou collez l'URL d'un dépôt. Base44 le vérifie, crée le projet, clone le code, le configure et lance l'aperçu. Connectez votre compte GitHub pour sauvegarder votre travail.

<Frame caption="Importer votre projet GitHub dans Base44">
  <img src="https://mintcdn.com/base44/OfiMCIK-cHLBT7ER/images/import-home.png?fit=max&auto=format&n=OfiMCIK-cHLBT7ER&q=85&s=efa34a4db3d71210f127fdf482e2f9a6" alt="Le menu plus ouvert sur la page d'accueil Base44, avec Bring your own project sous GitHub project" width="921" height="714" data-path="images/import-home.png" />
</Frame>

<Check>
  **Avant de commencer :**

  * Vous devez être propriétaire, admin ou éditeur dans le workspace Base44 où vous voulez importer le projet.
  * Votre projet s'exécute comme service web sur Base44. Votre dépôt doit donc être une application web ou full-stack qui peut être construite et exécutée depuis les sources dans Docker, comme un frontend avec une API ou un site rendu côté serveur.
  * Pour les dépôts privés, installez l'application GitHub Base44 pour lui donner accès au dépôt.
  * Votre workspace peut limiter les Éditeurs à l'import de dépôts depuis des organisations GitHub approuvées. Si un dépôt n'est pas dans une organisation approuvée, demandez à un propriétaire ou admin du workspace de l'ajouter dans **Settings** > **Governance** > **GitHub organizations**. Les propriétaires et admins du workspace peuvent importer depuis n'importe quelle organisation GitHub.
</Check>

### Depuis votre compte GitHub

Importez directement depuis un dépôt de votre compte GitHub connecté. Si vous n'êtes pas propriétaire du projet, [collez un lien](#depuis-lurl-dun-depot) à la place et Base44 crée une copie dont vous êtes propriétaire.

**Pour importer depuis votre compte GitHub :**

1. Depuis la [page d'accueil Base44](https://app.base44.com), cliquez sur l'icône **+** dans la boîte de prompt.
2. Cliquez sur **Bring your own project**.
3. Connectez votre compte GitHub s'il ne l'est pas encore.
4. Choisissez le dépôt à importer.
5. Cliquez sur la liste déroulante **Branch** pour sélectionner une branche de départ. Base44 utilise votre branche par défaut si vous n'en choisissez pas.
6. Cliquez sur **Import**.

<Frame caption="Importer un projet depuis votre compte GitHub">
  <img src="https://mintcdn.com/base44/rjuHkGr4TVwiXdjq/images/importexistingrepo.png?fit=max&auto=format&n=rjuHkGr4TVwiXdjq&q=85&s=dfbde6a9e935a88dc7029089a9684968" alt="La boîte de dialogue Import an existing project avec un dépôt sélectionné et la liste déroulante Branch réglée sur main" width="734" height="724" data-path="images/importexistingrepo.png" />
</Frame>

### Depuis l'URL d'un dépôt

Collez l'URL d'un dépôt GitHub pour importer un dépôt, public ou privé. Base44 vérifie votre accès, puis l'importe directement ou crée d'abord une copie dans votre compte GitHub. Quand l'original est privé, votre copie est privée aussi.

**Pour importer depuis l'URL d'un dépôt :**

1. Depuis la [page d'accueil Base44](https://app.base44.com), cliquez sur l'icône **+** dans la boîte de prompt.
2. Cliquez sur **Bring your own project**.
3. Cliquez sur **Paste a link**.
4. Collez le lien du dépôt GitHub.
5. Choisissez selon votre accès :
   * **Branch :** Sélectionnez une branche de départ si vous pouvez pousser vers le dépôt.
   * **Your copy on GitHub :** Entrez un nom pour la copie que Base44 crée si vous ne pouvez pas pousser vers le dépôt, puis choisissez sa visibilité :
     * **Fork (public) :** Lié à l'original, pour renvoyer vos modifications.
     * **Private copy :** Vous seul pouvez la voir et l'éditer. Elle n'est pas liée à l'original.
6. Cliquez sur **Import**. Si vous créez une copie, cliquez sur **Fork and Import** ou **Copy and Import**.

<Frame caption="Importer un projet depuis l'URL d'un dépôt">
  <img src="https://mintcdn.com/base44/tO7P5YqCK4DKnUwH/images/pasterepolink.png?fit=max&auto=format&n=tO7P5YqCK4DKnUwH&q=85&s=d38b2ffd636ac618ed036042ddde19a9" alt="L'onglet Paste a link de la boîte de dialogue Import an existing project, avec une URL de dépôt collée, un nom pour la copie, et Fork (public) sélectionné" width="737" height="625" data-path="images/pasterepolink.png" />
</Frame>

***

## Travailler sur votre projet

Une fois l'import terminé, continuez à développer avec le chat IA et voyez vos modifications dans **Preview**. Passez au **Dashboard** pour parcourir vos fichiers dans **Code** et gérer les valeurs dont votre projet a besoin dans **Secrets**.

<Frame caption="Un projet importé s'exécutant dans l'éditeur d'app">
  <img src="https://mintcdn.com/base44/To3xQZ0gv9AwxKbi/images/imported-project.png?fit=max&auto=format&n=To3xQZ0gv9AwxKbi&q=85&s=341eecfff1b52eb60a614a671edf3691" alt="L'éditeur d'app pour un projet importé avec le chat IA Base44 et l'app en cours d'exécution dans Preview à droite" width="1024" height="736" data-path="images/imported-project.png" />
</Frame>

### Sauvegarder votre travail

Base44 sauvegarde votre travail au fur et à mesure. À l'import, il crée sa propre branche de configuration nommée `base44/setup-` suivie d'un ID court, et y exécute la configuration. Ensuite, il commit et pousse vers la branche sur laquelle vous travaillez chaque fois que le chat IA termine une modification. Les branches créées plus tard reçoivent des noms courts et descriptifs, comme `dark-mode-toggle`. Votre branche par défaut n'est jamais touchée.

Si vous avez importé un dépôt public sans connecter GitHub, votre app s'exécute en mode local. Rien n'est commité ni poussé, et **Create PR** est désactivé. Les modifications que vous faites vous-même dans **Code** sont commitées la prochaine fois que le chat IA termine une modification.

Un projet importé utilise les branches git de votre dépôt directement, donc git reste la source de vérité. Les branches fonctionnent comme dans n'importe quelle app Base44, avec quelques différences. Il n'y a pas de merge ou de mise à jour depuis votre branche par défaut dans Base44, toutes les branches partagent un seul sandbox, et supprimer une branche dans Base44 laisse la branche sur GitHub. Voir [travailler avec les branches](/Building-your-app/Working-with-branches).

### Ajouter des secrets

Quand votre projet a besoin d'une clé d'API ou d'un autre secret pour s'exécuter, le chat IA vous le demande. Donnez-lui la valeur, et Base44 la stocke chiffrée et l'applique chaque fois que votre projet démarre, y compris après une reconstruction. Elle n'est jamais commitée dans votre dépôt, et elle est partagée entre toutes les branches, donc vous ne la saisissez qu'une seule fois.

Vous pouvez aussi ajouter et gérer des secrets dans le dashboard de votre app.

**Pour ajouter un secret :**

1. Allez dans le dashboard de votre app.
2. Cliquez sur **Secrets**.
3. Cliquez sur **Add Secret**.
4. Entrez le **Secret Name** et la **Secret Value**, puis cliquez sur **Add Secret**.

<Tip>
  Pour ajouter des secrets en masse, cliquez sur **Import .env**, puis téléversez ou collez votre fichier. Chaque ligne `KEY=VALUE` devient un secret, et tout secret existant portant le même nom est écrasé.
</Tip>

***

## Livrer votre travail

Chaque modification est commitée par `base44-builder[bot]`. Une branche partagée produit une seule pull request pour toute l'équipe, et les branches séparées ont chacune la leur. Les coéquipiers avec accès éditeur partagent le projet et ses secrets.

### Ouvrir une pull request

La pull request va de votre branche de travail vers la branche à partir de laquelle elle a été créée, avec une note créditant Base44 et un lien vers votre projet. La pull request de configuration va toujours vers la branche que vous avez importée.

Une fois la pull request ouverte, vos modifications continuent d'être sauvegardées sur la même branche. Les relecteurs voient donc toujours votre dernier travail, et les vérifications s'exécutent à chaque push.

**Pour ouvrir une pull request :**

1. Cliquez sur **Create PR** en haut de l'éditeur.
2. Entrez un **Title** et une **Description (optional)**.
3. Cliquez sur **Create PR**.

<Tip>
  Vous pouvez aussi demander une pull request au chat IA, et il rédige le titre et la description pour vous.
</Tip>

<Note>
  Si vous n'avez pas encore accordé les permissions, cliquez sur **Review permissions on GitHub** et faites approuver par un propriétaire de compte.
</Note>

### Répondre aux commentaires de relecture

Gérez les retours des relecteurs depuis le chat IA, sans quitter Base44.

Demandez au chat IA les commentaires de relecture sur votre pull request. Il liste chaque fil non résolu avec le fichier et la ligne concernés. Dites-lui quoi changer, et il rédige une modification et une réponse pour chacun. Rien n'est publié sur GitHub tant que vous n'approuvez pas ce brouillon spécifique. Résoudre le fil est une étape séparée que vous demandez. Vous pouvez aussi lui demander de commenter la pull request elle-même.

Tout ce qu'il publie apparaît comme `base44-builder[bot]`. Le merge se fait sur GitHub, exactement comme aujourd'hui.

***

## FAQ

<AccordionGroup>
  <Accordion title="Base44 change-t-il ma branche par défaut ?">
    Non. Base44 pousse vers la branche sur laquelle vous travaillez, jamais vers votre branche par défaut. Ouvrir une pull request est la seule façon dont vos modifications atteignent votre branche par défaut.
  </Accordion>

  <Accordion title="Que se passe-t-il si je ferme Base44 et reviens plus tard ?">
    Votre projet se met en pause quand vous arrêtez de travailler, et reprend là où vous l'avez laissé quand vous revenez. S'il a besoin d'être reconstruit, Base44 clone à nouveau votre dépôt et redémarre depuis votre dernier commit.
  </Accordion>

  <Accordion title="Puis-je importer un dépôt sur lequel je n'ai que l'accès en lecture ?">
    Oui, sauf si votre workspace limite les imports à des organisations GitHub approuvées. Quand vous n'avez qu'un accès en lecture, Base44 crée une copie dans votre compte GitHub personnel. Les workspaces restreints bloquent cette copie car elle appartient à votre compte personnel plutôt qu'à une organisation approuvée. Demandez plutôt un accès en écriture au dépôt d'origine.
  </Accordion>

  <Accordion title="Pourquoi Base44 dit-il que mon dépôt n'est pas dans une organisation GitHub approuvée ?">
    Votre workspace n'autorise pas les imports depuis l'organisation GitHub de ce dépôt. Demandez à un propriétaire ou admin du workspace d'ajouter l'organisation dans **Settings** > **Governance** > **GitHub organizations**, puis réessayez.
  </Accordion>

  <Accordion title="Mon dépôt est un monorepo. Puis-je l'importer ?">
    Oui, si l'app à la racine du dépôt est une app web ou full-stack. Base44 regarde la racine pour décider ce qu'est votre projet.
  </Accordion>

  <Accordion title="Puis-je importer un projet mobile ou desktop ?">
    Non. Base44 exécute uniquement des projets web et full-stack. Vous recevez un message dès l'import, et rien n'est créé dans votre compte. Un dépôt avec une app web à sa racine fonctionne quand même s'il contient une app mobile dans un sous-dossier.
  </Accordion>

  <Accordion title="Puis-je importer une app Base44 exportée vers GitHub ?">
    Non. Importer une app Base44 n'est pas pris en charge, et elle ne s'exécutera pas correctement. Votre app fonctionne déjà dans Base44, et l'[intégration GitHub](/developers/app-code/local-development/github) la synchronise avec votre dépôt dans les deux sens.
  </Accordion>

  <Accordion title="Puis-je utiliser les entités Base44, la connexion, ou le SDK dans un projet importé ?">
    Non. Un projet importé n'a pas de pages Base44, d'entités, de connexion intégrée ou de SDK. Il garde sa propre base de données, son authentification et son routage, et Base44 ne les remplace pas.
  </Accordion>

  <Accordion title="Puis-je ajouter une base de données, une authentification ou une CI/CD à mon projet ?">
    Oui. Demandez au chat IA et Base44 écrit le code dans votre dépôt, comme pour n'importe quelle autre modification. Vous développez sur votre propre stack, pas sur les pages, entités ou connexion Base44. Pointez donc votre projet vers votre propre base de données ou service, et ajoutez la chaîne de connexion ou la clé d'API comme secret. Tout ce que vous ajoutez est livré via votre dépôt comme le reste de votre travail.
  </Accordion>

  <Accordion title="Puis-je cliquer sur un élément de l'aperçu pour l'éditer ?">
    Non. Sélectionner un élément dans l'aperçu pour l'éditer n'est pas disponible sur les projets importés. Dites plutôt au chat IA ce que vous voulez changer. Il peut voir la page que vous regardez.
  </Accordion>

  <Accordion title="En quoi est-ce différent de connecter mon app Base44 à GitHub ?">
    L'[intégration GitHub](/developers/app-code/local-development/github) synchronise une app que vous avez construite dans Base44 avec un dépôt. L'import fonctionne dans l'autre sens, en partant d'un dépôt qui existe déjà. Pour déplacer un projet depuis une autre plateforme comme Shopify ou Lovable, voir [migrer un projet vers Base44](/Getting-Started/migrating-an-existing-app). Pour lier un projet backend Base44 local avec la CLI à la place, voir [lier un projet existant](/developers/backend/overview/link-existing-project).
  </Accordion>
</AccordionGroup>

<Note>Cette page a été traduite par IA. Pour les informations les plus précises et à jour, consultez la [version anglaise](/). </Note>