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

# Quickstart Hono

> Ajoutez Base44 à votre projet Hono

Suivez ce quickstart pour ajouter Base44 à votre projet Hono. Vous allez créer un backend Base44, définir des entités et intégrer le SDK dans vos routes API.

<Note>La CLI nécessite Node.js 20.19.0 ou supérieur.</Note>

## Configuration

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

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

  <Step title="Créer un backend Base44">
    Naviguez vers le répertoire de votre projet Hono, puis exécutez :

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

    Si vous n'êtes pas déjà connecté, la commande vous demandera de vous authentifier.

    Sélectionnez **Create a basic project** lorsque demandé. Cela crée les fichiers backend dans le répertoire de votre projet Hono. Suivez ensuite les invites pour configurer votre projet.

    Lorsque vous créez un projet, les [skills Base44](/developers/backend/overview/base44-skills) sont incluses automatiquement, fournissant à votre agent IA des instructions et du contexte pour les tâches Base44.
  </Step>

  <Step title="Configurer le répertoire de sortie (facultatif)">
    Si vous servez des fichiers statiques avec Hono, mettez à jour [config.jsonc](/developers/backend/overview/project-structure) pour pointer vers votre sortie de build. Ajoutez ou modifiez le champ `site.outputDirectory` :

    ```json theme={null}
    {
      "site": {
        "outputDirectory": "dist"
      }
    }
    ```

    <Note>
      Si vous construisez une API pure avec Hono et ne servez pas de frontend, vous pouvez ignorer la configuration `outputDirectory` ou omettre cette étape.
    </Note>
  </Step>

  <Step title="Définir des entités">
    Créez des [schémas d'entités](/developers/references/entities/introduction) pour définir vos structures de données. Les fichiers d'entités doivent être placés dans le répertoire `base44/entities/`.

    Par exemple, créez `base44/entities/task.jsonc` :

    ```json theme={null}
    {
      "name": "Task",
      "type": "object",
      "properties": {
        "title": {
          "type": "string"
        },
        "completed": {
          "type": "boolean",
          "default": false
        }
      },
      "required": ["title"]
    }
    ```
  </Step>

  <Step title="Pousser les entités vers Base44">
    Poussez vos schémas d'entités vers Base44 :

    ```bash theme={null}
    base44 entities push
    ```

    Cette commande synchronise vos définitions d'entités locales avec votre backend Base44, les rendant disponibles pour une utilisation dans votre application. Consultez [`entities push`](/developers/references/cli/commands/entities-push) pour plus d'informations.
  </Step>

  <Step title="Installer le SDK Base44">
    Installez le SDK JavaScript Base44 :

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

  <Step title="Créer un client Base44">
    Créez un [client](/developers/references/sdk/getting-started/client) SDK Base44 dans votre projet. L'`appId` peut être trouvé dans votre fichier `base44/.app.jsonc`.

    Par exemple, créez `lib/base44.js` :

    ```javascript theme={null}
    import { createClient } from '@base44/sdk';

    export const base44 = createClient({
      appId: 'your-app-id-from-app.jsonc'
    });
    ```
  </Step>

  <Step title="Utiliser le SDK dans vos routes API">
    Utilisez le SDK Base44 pour interagir avec vos [entités](/developers/references/sdk/docs/type-aliases/entities) dans les gestionnaires de route Hono. Par exemple :

    ```javascript theme={null}
    import { Hono } from 'hono';
    import { base44 } from './lib/base44Client';

    const app = new Hono();

    // Get all tasks
    app.get('/api/tasks', async (c) => {
      const tasks = await base44.entities.Task.list();
      return c.json(tasks);
    });

    // Create a new task
    app.post('/api/tasks', async (c) => {
      const body = await c.req.json();
      const newTask = await base44.entities.Task.create({
        title: body.title,
        completed: false
      });
      return c.json(newTask, 201);
    });

    export default app;
    ```

    <Note>
      Utilisez le nom exact de l'entité de votre schéma lors de l'appel du SDK, y compris la capitalisation. Par convention, les noms d'entités commencent par une majuscule. Par exemple, si votre schéma a `"name": "Task"`, vous y accédez avec `base44.entities.Task.list()`.
    </Note>
  </Step>

  <Step title="Exécuter votre API localement">
    Démarrez votre serveur de développement Hono pour tester votre intégration. Depuis la racine de votre projet, exécutez :

    ```bash theme={null}
    npm run dev
    ```

    Votre API Hono se connectera à votre backend Base44 via le client SDK, vous permettant de travailler avec vos entités déployées en temps réel.
  </Step>
</Steps>

## Étapes suivantes

Maintenant que votre backend Base44 est intégré à votre projet, vous pouvez :

* Utiliser le [SDK](/developers/references/sdk/getting-started/overview) pour ajouter plus de fonctionnalités à votre API.
* Ajouter des [entités](/developers/backend/resources/entities/overview), des [fonctions backend](/developers/backend/resources/functions) et des [agents](/developers/backend/resources/agents-config). Si vous travaillez en TypeScript, [générez des types](/developers/references/sdk/getting-started/dynamic-types) pour obtenir l'autocomplétion et la sécurité des types.
* Tester localement en exécutant [`base44 dev`](/developers/references/cli/commands/dev) pour le backend Base44 aux côtés de votre serveur de développement Hono. Consultez [Développement local](/developers/backend/overview/local-dev/local-development-overview) pour les instructions de configuration.
* Continuer à construire votre API et la déployer selon le runtime de votre choix.

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

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