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

# Hono Quickstart

> Füge Base44 zu deinem Hono-Projekt hinzu

Folge diesem Quickstart, um Base44 zu deinem Hono-Projekt hinzuzufügen. Du erstellst ein Base44-Backend, definierst Entitäten und integrierst das SDK in deine API-Routen.

<Note>Die CLI erfordert Node.js 20.19.0 oder höher.</Note>

## Einrichtung

<Steps>
  <Step title="Base44 CLI installieren">
    Installiere die Base44 CLI global:

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

  <Step title="Ein Base44-Backend erstellen">
    Navigiere in dein Hono-Projektverzeichnis und führe aus:

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

    Wenn du noch nicht eingeloggt bist, fordert dich der Befehl auf, dich zu authentifizieren.

    Wähle **Create a basic project**, wenn du dazu aufgefordert wirst. Dies erstellt die Backend-Dateien in deinem Hono-Projektverzeichnis. Folge dann den Eingabeaufforderungen, um dein Projekt zu konfigurieren.

    Wenn du ein Projekt erstellst, werden [Base44 skills](/developers/backend/overview/base44-skills) automatisch eingebunden und liefern deinem KI-Agenten Anweisungen und Kontext für Base44-Aufgaben.
  </Step>

  <Step title="Ausgabeverzeichnis konfigurieren (optional)">
    Wenn du mit Hono statische Dateien ausspielst, aktualisiere [config.jsonc](/developers/backend/overview/project-structure), um auf deine Build-Ausgabe zu verweisen. Füge das Feld `site.outputDirectory` hinzu oder ändere es:

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

    <Note>
      Wenn du mit Hono eine reine API baust und kein Frontend ausspielst, kannst du die `outputDirectory`-Konfiguration überspringen oder diesen Schritt weglassen.
    </Note>
  </Step>

  <Step title="Entitäten definieren">
    Erstelle [Entity-Schemas](/developers/references/entities/introduction), um deine Datenstrukturen zu definieren. Entity-Dateien müssen im Verzeichnis `base44/entities/` abgelegt werden.

    Erstelle zum Beispiel `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="Entitäten zu Base44 pushen">
    Pushe deine Entity-Schemas zu Base44:

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

    Dieser Befehl synchronisiert deine lokalen Entity-Definitionen mit deinem Base44-Backend, sodass sie in deiner Anwendung verfügbar werden. Siehe [`entities push`](/developers/references/cli/commands/entities-push) für weitere Informationen.
  </Step>

  <Step title="Base44 SDK installieren">
    Installiere das Base44 JavaScript-SDK:

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

  <Step title="Einen Base44-Client erstellen">
    Erstelle einen Base44-SDK-[Client](/developers/references/sdk/getting-started/client) in deinem Projekt. Die `appId` findest du in deiner Datei `base44/.app.jsonc`.

    Erstelle zum Beispiel `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="Das SDK in deinen API-Routen verwenden">
    Verwende das Base44-SDK, um in Hono-Route-Handlern mit deinen [Entitäten](/developers/references/sdk/docs/type-aliases/entities) zu interagieren. Zum Beispiel:

    ```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>
      Verwende beim Aufruf des SDK den exakten Entity-Namen aus deinem Schema, einschließlich Groß- und Kleinschreibung. Konventionell beginnen Entity-Namen mit einem Großbuchstaben. Wenn dein Schema z. B. `"name": "Task"` hat, greifst du als `base44.entities.Task.list()` darauf zu.
    </Note>
  </Step>

  <Step title="Deine API lokal ausführen">
    Starte deinen Hono-Entwicklungsserver, um deine Integration zu testen. Führe aus dem Projekt-Stammverzeichnis aus:

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

    Deine Hono-API verbindet sich über den SDK-Client mit deinem Base44-Backend, sodass du in Echtzeit mit deinen veröffentlichten Entitäten arbeiten kannst.
  </Step>
</Steps>

## Nächste Schritte

Nun, da dein Base44-Backend in dein Projekt integriert ist, kannst du:

* Das [SDK](/developers/references/sdk/getting-started/overview) verwenden, um deiner API weitere Funktionalität hinzuzufügen.
* [Entitäten](/developers/backend/resources/entities/overview), [Backend-Funktionen](/developers/backend/resources/functions) und [Agenten](/developers/backend/resources/agents-config) hinzufügen. Wenn du in TypeScript arbeitest, [generiere Typen](/developers/references/sdk/getting-started/dynamic-types), um Autovervollständigung und Typsicherheit zu erhalten.
* Lokal testen, indem du [`base44 dev`](/developers/references/cli/commands/dev) für das Base44-Backend zusammen mit deinem Hono-Dev-Server ausführst. Siehe [Lokale Entwicklung](/developers/backend/overview/local-dev/local-development-overview) für Einrichtungsanweisungen.
* Deine API weiterentwickeln und sie gemäß der von dir gewählten Laufzeit veröffentlichen.

## Siehe auch

* [CLI-Befehlsreferenz](/developers/references/cli/commands/introduction): Alle verfügbaren CLI-Befehle
* [Projektstruktur](/developers/backend/overview/project-structure): Wie Projektdateien organisiert sind
* [JavaScript-SDK-Dokumentation](/developers/references/sdk/getting-started/overview): Verbinde deine App mit dem Backend
* [Base44 Skills](/developers/backend/overview/base44-skills): Bring KI-Assistenten bei, mit Base44 zu arbeiten

<Note>Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die [englische Version](/). </Note>