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

# Vue クイックスタート

> Vue プロジェクトに Base44 バックエンドを追加します

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

> [!NOTE]
>
> CLI には Node.js 20.19.0 以上が必要です。

## セットアップ

**1. Base44 CLI をインストール**

Base44 CLI をグローバルにインストールします:

```bash theme={null}
npm install -g base44@latest
```

**2. Base44 バックエンドを作成**

Vue プロジェクトディレクトリに移動して、次を実行します:

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

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

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

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

**3. サイトを構成**

[config.jsonc](https://docs.base44.com/developers/backend/overview/project-structure.md#config-jsonc) を更新して Vue のビルド出力を指すように設定し、ビルドと配信のコマンドを設定します。`site.outputDirectory`、`site.buildCommand`、`site.serveCommand` フィールドを追加します:

```json theme={null}
{
  "site": {
    "outputDirectory": "dist",
    "buildCommand": "npm run build",
    "serveCommand": "npm run dev"
  }
}
```

`serveCommand` を設定すると、[`base44 dev`](https://docs.base44.com/developers/references/cli/commands/dev) が 1 つのターミナルからバックエンドとフロントエンドを一緒に起動します。`buildCommand` を設定すると、[`base44 build`](https://docs.base44.com/developers/references/cli/commands/build) がアプリ ID を注入してフロントエンドをコンパイルします。

**4. エンティティを定義**

データ構造を定義する[エンティティスキーマ](https://docs.base44.com/developers/backend/resources/entities/overview.md)を作成します。エンティティファイルは `base44/entities/` ディレクトリに配置する必要があります。

例えば、`base44/entities/task.jsonc` を作成します:

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

**5. エンティティを Base44 にプッシュ**

エンティティスキーマを Base44 にプッシュします:

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

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

**6. Base44 SDK をインストール**

Base44 JavaScript SDK をインストールします:

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

**7. Base44 クライアントを作成**

プロジェクトで Base44 SDK [クライアント](https://docs.base44.com/developers/references/sdk/getting-started/client.md)を作成します。アプリ ID は `VITE_BASE44_APP_ID` から読み取ります。これは [`base44 build`](https://docs.base44.com/developers/references/cli/commands/build) と [`base44 dev`](https://docs.base44.com/developers/references/cli/commands/dev) が自動的に設定します。

例えば、`src/api/base44Client.js` を作成します:

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

export const base44 = createClient({
  appId: import.meta.env.VITE_BASE44_APP_ID,
});
```

`VITE_BASE44_APP_ID` はリンクされたアプリの ID に解決されます。CLI は `base44/.app.jsonc` からこれを読み取ります。

**8. フロントエンドで SDK を使用**

タスクをリストして追加するシンプルなコンポーネントを作成します。例えば、`src/components/TaskList.vue` を作成します:

```vue theme={null}
<script setup>
import { ref, onMounted } from 'vue';
import { base44 } from '@/api/base44Client';

const tasks = ref([]);
const newTaskTitle = ref('');
const isLoading = ref(false);

onMounted(async () => {
  await loadTasks();
});

const loadTasks = async () => {
  isLoading.value = true;
  try {
    // Get records
    tasks.value = await base44.entities.Task.list();
  } catch (error) {
    console.error('Error loading tasks:', error);
  }
  isLoading.value = false;
};

const addTask = async (e) => {
  e.preventDefault();
  if (!newTaskTitle.value.trim()) return;

  isLoading.value = true;
  try {
    // Create a record
    const newTask = await base44.entities.Task.create({
      title: newTaskTitle.value,
      completed: false
    });
    tasks.value.push(newTask);
    newTaskTitle.value = '';
  } catch (error) {
    console.error('Error creating task:', error);
  }
  isLoading.value = false;
};
</script>

<template>
  <div>
    <h1>Tasks</h1>

    <p v-if="isLoading">Loading...</p>

    <ul>
      <li v-for="task in tasks" :key="task.id">
        {{ task.title }}
      </li>
    </ul>

    <form @submit="addTask">
      <input
        type="text"
        v-model="newTaskTitle"
        placeholder="New task"
        :disabled="isLoading"
      />
      <button type="submit" :disabled="isLoading || !newTaskTitle.trim()">
        Add Task
      </button>
    </form>
  </div>
</template>
```

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

**9. アプリをローカルで実行**

Vue 開発サーバーを起動して、インテグレーションをテストします。プロジェクトルートから次を実行します:

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

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

**10. フロントエンドをビルドしてデプロイ**

アプリ ID を注入して Vue プロジェクトを本番用にビルドし、デプロイします:

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

`base44 build` は、`VITE_BASE44_APP_ID` をリンクされたアプリの ID に設定して `buildCommand` を実行します。`base44 deploy` はコンパイルされたファイルをアップロードし、エンティティスキーマの更新をプッシュします。完了すると、Base44 ダッシュボードへのリンクとライブアプリケーション URL が表示されます。

## 次のステップ

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

* [SDK](https://docs.base44.com/developers/references/sdk/getting-started/overview.md) を使用してフロントエンドにより多くの機能を追加します。
* [エンティティ](https://docs.base44.com/developers/backend/resources/entities/overview.md)、[バックエンド関数](https://docs.base44.com/developers/backend/resources/backend-functions/overview.md)、[エージェント](https://docs.base44.com/developers/backend/resources/agents/overview.md)を追加します。TypeScript で作業している場合は、オートコンプリートと型安全性を得るために[型を生成](https://docs.base44.com/developers/references/sdk/getting-started/dynamic-types.md)してください。
* バックエンドの [`base44 dev`](https://docs.base44.com/developers/references/cli/commands/dev) とフロントエンドの `npm run dev` を実行してローカルでテストします。セットアップ手順については、[ローカル開発](https://docs.base44.com/developers/backend/overview/local-dev/local-development-overview.md)を参照してください。
* フロントエンドの構築を続け、[`base44 deploy`](https://docs.base44.com/developers/references/cli/commands/deploy) で更新をデプロイします。
* [`base44 site open`](https://docs.base44.com/developers/references/cli/commands/site-open) でデプロイされたサイトを開きます。

## 関連項目

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

> [!NOTE]
>
> このページは AI によって翻訳されました。最も正確で最新の情報については、[英語版](https://docs.base44.com/index.md) を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.