> ## 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 クイックスタート

> Hono プロジェクトに Base44 を追加します

このクイックスタートに従って、Hono プロジェクトに Base44 を追加してください。Base44 バックエンドを作成し、エンティティを定義して、SDK を API ルートに統合します。

<Note>CLI には Node.js 20.19.0 以上が必要です。</Note>

## セットアップ

<Steps>
  <Step title="Base44 CLI をインストール">
    Base44 CLI をグローバルにインストールします:

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

  <Step title="Base44 バックエンドを作成">
    Hono プロジェクトディレクトリに移動して、次を実行します:

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

    まだログインしていない場合、コマンドは認証を促します。

    プロンプトが表示されたら **Create a basic project** を選択してください。これにより、Hono プロジェクトディレクトリ内にバックエンドファイルが作成されます。その後、プロジェクトを構成するためのプロンプトに従ってください。

    プロジェクトを作成する際、[Base44 skills](/developers/backend/overview/base44-skills) が自動的に含まれ、AI エージェントに Base44 タスクの指示とコンテキストを提供します。
  </Step>

  <Step title="出力ディレクトリを構成 (オプション)">
    Hono で静的ファイルを配信している場合は、[config.jsonc](/developers/backend/overview/project-structure) を更新してビルド出力を指すように設定してください。`site.outputDirectory` フィールドを追加または変更します:

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

    <Note>
      Hono で純粋な API を構築しフロントエンドを配信しない場合、`outputDirectory` の構成をスキップするか、このステップを省略できます。
    </Note>
  </Step>

  <Step title="エンティティを定義">
    データ構造を定義する[エンティティスキーマ](/developers/references/entities/introduction)を作成します。エンティティファイルは `base44/entities/` ディレクトリに配置する必要があります。

    例えば、`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="エンティティを Base44 にプッシュ">
    エンティティスキーマを Base44 にプッシュします:

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

    このコマンドは、ローカルのエンティティ定義を Base44 バックエンドと同期し、アプリケーションで使用できるようにします。詳細は [`entities push`](/developers/references/cli/commands/entities-push) を参照してください。
  </Step>

  <Step title="Base44 SDK をインストール">
    Base44 JavaScript SDK をインストールします:

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

  <Step title="Base44 クライアントを作成">
    プロジェクトで Base44 SDK [クライアント](/developers/references/sdk/getting-started/client)を作成します。`appId` は `base44/.app.jsonc` ファイルで確認できます。

    例えば、`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="API ルートで SDK を使用">
    Base44 SDK を使用して、Hono ルートハンドラ内で[エンティティ](/developers/references/sdk/docs/type-aliases/entities)と対話します。例:

    ```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>
      SDK を呼び出すときは、大文字小文字を含むスキーマの正確なエンティティ名を使用してください。慣例上、エンティティ名は大文字で始まります。例えば、スキーマに `"name": "Task"` がある場合、`base44.entities.Task.list()` としてアクセスします。
    </Note>
  </Step>

  <Step title="API をローカルで実行">
    Hono 開発サーバーを起動して、インテグレーションをテストします。プロジェクトルートから次を実行します:

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

    Hono API は SDK クライアントを介して Base44 バックエンドに接続し、デプロイされたエンティティをリアルタイムで操作できます。
  </Step>
</Steps>

## 次のステップ

これでプロジェクトに Base44 バックエンドが統合されたので、次のことができます:

* [SDK](/developers/references/sdk/getting-started/overview) を使用して API により多くの機能を追加します。
* [エンティティ](/developers/backend/resources/entities/overview)、[バックエンド関数](/developers/backend/resources/functions)、[エージェント](/developers/backend/resources/agents-config)を追加します。TypeScript で作業している場合は、オートコンプリートと型安全性を得るために[型を生成](/developers/references/sdk/getting-started/dynamic-types)してください。
* Hono 開発サーバーと並行して Base44 バックエンドに対して [`base44 dev`](/developers/references/cli/commands/dev) を実行してローカルでテストします。セットアップ手順については、[ローカル開発](/developers/backend/overview/local-dev/local-development-overview)を参照してください。
* API の構築を続け、選択したランタイムに従ってデプロイします。

## 関連項目

* [CLI Command Reference](/developers/references/cli/commands/introduction): 利用可能なすべての CLI コマンド
* [Project Structure](/developers/backend/overview/project-structure): プロジェクトファイルの構成方法
* [JavaScript SDK Documentation](/developers/references/sdk/getting-started/overview): アプリをバックエンドに接続
* [Base44 Skills](/developers/backend/overview/base44-skills): AI アシスタントに Base44 での作業を教える

<Note>このページは AI を使用して翻訳されました。最も正確で最新の情報については、[英語版](/) を参照してください。 </Note>