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

# Lier un projet backend existant

> Configurez et exécutez du code de projet backend Base44 existant, comme des exemples d'applications

Vous pouvez lier du code de projet backend Base44 existant, par exemple à partir d'un [exemple d'application](https://github.com/base44/apps-examples), à un backend sur Base44. Utilisez ceci lorsque vous avez déjà des fichiers de projet backend Base44 localement.

Si vous n'avez pas encore de fichiers de projet, utilisez [`base44 create`](/developers/references/cli/commands/create) pour générer un nouveau projet à la place.

<Note>
  * Ce guide est destiné à lier du code de projet backend Base44 existant, comme des exemples d'applications ou des projets partagés par des membres de l'équipe. Si vous avez créé une application avec l'[éditeur d'applications Base44](https://base44.com) et que vous souhaitez la développer localement, utilisez [`base44 eject`](/developers/backend/overview/start-from-existing-app) à la place.
  * La CLI nécessite Node.js 20.19.0 ou supérieur.
</Note>

## Comprendre code local vs projets backend

Lorsque vous travaillez avec Base44, il existe deux composants distincts :

* **Code local :** les fichiers de projet sur votre ordinateur, tels que votre code frontend, vos schémas d'entités et vos fonctions backend.
* **Projet backend Base44 :** l'infrastructure backend sur les serveurs de Base44, y compris la base de données, les endpoints, l'hébergement, etc.

La liaison connecte votre code local à un projet backend afin que votre application puisse utiliser l'infrastructure de Base44. Pendant le processus de liaison, vous choisirez l'une des deux options :

* **Créer un nouveau projet :** crée un nouveau backend sur Base44 pour votre code. Choisissez ceci si vous configurez ce code pour la première fois.
* **Lier à un existant :** se connecte à un backend qui existe déjà sur Base44. Choisissez ceci si vous vous reconnectez à un backend que vous avez configuré plus tôt, ou si vous rejoignez un projet d'équipe où le backend a déjà été créé.

## Lier un projet

<Steps>
  <Step title="Obtenir le code du projet">
    Clonez un exemple d'application ou téléchargez le code de projet existant, puis naviguez vers le répertoire du projet.

    Le projet doit déjà contenir un dossier `base44/` avec un fichier `config.jsonc`.
  </Step>

  <Step title="Installer les dépendances">
    Installez les dépendances du projet :

    ```bash theme={null}
    npm install
    ```
  </Step>

  <Step title="Installer la CLI Base44">
    Installez la CLI Base44 globalement :

    ```bash theme={null}
    npm install -g base44@latest
    ```
  </Step>

  <Step title="S'authentifier">
    Connectez-vous à votre compte Base44 :

    ```bash theme={null}
    base44 login
    ```

    La CLI génère un code de l'appareil. Ouvrez l'URL fournie, entrez le code et terminez l'authentification dans votre navigateur.
  </Step>

  <Step title="Lier le projet">
    Liez votre projet local à un backend Base44 :

    ```bash theme={null}
    base44 link
    ```

    La CLI vous demandera de créer un nouveau projet backend ou de lier à un existant. Cela crée un fichier `.app.jsonc` dans votre répertoire `base44/` avec votre ID d'application :

    ```jsonc theme={null}
    {
      "id": "your-app-id"
    }
    ```

    <Warning>
      Le fichier `.app.jsonc` ne doit jamais être validé dans le contrôle de version. Il est automatiquement ajouté à `.gitignore` et est spécifique à chaque développeur et environnement de déploiement.
    </Warning>
  </Step>

  <Step title="Configurer les variables d'environnement (si nécessaire)">
    Votre ID d'application est requis lors de la configuration d'un client SDK. Les projets stockent généralement leur ID d'application dans une variable d'environnement et le récupèrent pour créer un client. Consultez la documentation du projet ou les fichiers de configuration pour les instructions sur la définition des variables d'environnement requises.
  </Step>

  <Step title="Construire le frontend si le projet en a un">
    Si votre projet inclut un frontend, construisez-le pour qu'il soit prêt à être déployé à l'étape suivante.
  </Step>

  <Step title="Pousser les ressources">
    Synchronisez les ressources de votre projet avec votre backend Base44 :

    ```bash theme={null}
    base44 deploy
    ```

    Cela pousse les entités, les fonctions et le site si votre projet en a un.

    Si votre projet a des agents, poussez-les également :

    ```bash theme={null}
    base44 agents push
    ```
  </Step>
</Steps>

## Étapes suivantes

Maintenant que votre projet est configuré et fonctionne, vous pouvez :

* Utiliser le [SDK](/developers/references/sdk/getting-started/overview) pour ajouter plus de fonctionnalités à votre frontend, si le projet en a un.
* Ajouter des [entités](/developers/backend/resources/entities/overview), des [fonctions backend](/developers/backend/resources/backend-functions/overview) et des [agents](/developers/backend/resources/agents-config).
* Continuer à créer et à déployer les mises à jour avec [`base44 deploy`](/developers/references/cli/commands/deploy).

## Voir aussi

* [Référence des commandes CLI](/developers/references/cli/commands/introduction) : toutes les commandes CLI disponibles
* [Structure du projet](/developers/backend/overview/project-structure) : comment les fichiers de projet sont organisés
* [Documentation du SDK JavaScript](/developers/references/sdk/getting-started/overview) : connectez votre application au backend
* [Skills Base44](/developers/backend/overview/base44-skills) : apprenez aux assistants IA à travailler avec Base44
* [Dépôt d'exemples d'applications](https://github.com/base44/apps-examples) : exemples de projets pour apprendre

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