メインコンテンツへスキップ
Base44 CLI の create コマンドは、必要なすべてのファイルと構成を含む新しいプロジェクトを作成します。この記事では、Base44 バックエンドプロジェクトの構造を説明し、各ファイルとディレクトリの役割を解説します。

​
バックエンドプロジェクトの構造

バックエンド専用の Base44 プロジェクトを作成すると、CLI は次の最小構造を生成します:
<your-project-name>
base44
.app.jsonc
config.jsonc
.gitignore
プロジェクトを開発するにつれて、エンティティ、関数、エージェント、コネクター、認証構成などのリソース用のファイルを追加します:
<your-project-name>
base44
.app.jsonc
config.jsonc
.types
types.d.ts
agents
<agent-name>.jsonc
auth
config.jsonc
connectors
<connector-type>.jsonc
entities
<entity-name>.jsonc
functions
<function-name>
entry.ts
function.jsonc
.gitignore
関数には entry.ts または entry.js ファイルのみが必要です。カスタム名や自動化などの高度な構成のためにオプションで function.jsonc を追加できます。詳しくはバックエンド関数を参照してください。

​
base44/

Base44 バックエンドの構成とリソース定義をすべて含みます。

​
config.jsonc

プロジェクト構成を定義します。これには、エンティティ、関数、エージェント、コネクター、認証構成のパス、およびフルスタックプロジェクト用のサイトホスティング設定が含まれます。CLI はプロジェクト名のみでこれを作成し、必要に応じて構成を追加できます。 プロジェクトには base44/ ディレクトリに config.jsonc (または config.json) ファイルが必要です: 
// Base44 Project Configuration
{
  "name": "my-project",
  "description": "My Base44 app",

  // Directory paths (relative to config file)
  "entitiesDir": "./entities",
  "functionsDir": "./functions",
  "agentsDir": "./agents",
  "connectorsDir": "./connectors",
  "authDir": "./auth",

  // Site/hosting configuration (for full-stack projects)
  "site": {
    "outputDirectory": "./dist", // Required - where your built files are located
  },
}
プロパティ説明デフォルト
nameプロジェクト名 (必須)—
descriptionプロジェクトの説明—
entitiesDirエンティティディレクトリのパス./entities
functionsDir関数ディレクトリのパス./functions
agentsDirエージェントディレクトリのパス./agents
connectorsDirコネクターディレクトリのパス./connectors
authDir認証構成ディレクトリのパス./auth
site.outputDirectoryビルドされたサイトファイルの場所 (サイトデプロイに必須)—
site.buildCommand自動デプロイの base44 create 中にのみ使用—
site.installCommand自動デプロイの base44 create 中にのみ使用—
site.serveCommand参照のみ。現在 CLI では使用されません—
buildCommand、installCommand、serveCommand プロパティは、フルスタックテンプレートからプロジェクトを作成するときに自動的に含まれます。これらは自動デプロイのために初回の base44 create フロー中にのみ使用されます。プロジェクト作成後にこれらのプロパティを指定または変更する必要はありません。後で site deploy でサイトをデプロイする際は、outputDirectory のみが使用されます。

​
.app.jsonc

ローカルプロジェクトを Base44 アプリにリンクします。このファイルは、プロジェクトを作成またはリンクするときに CLI によって自動的に作成されます。 
// Base44 App Configuration
// This file links your local project to your Base44 app.
// Do not commit this file to version control.
{
  "id": "your-app-id",
}
.app.jsonc ファイルはバージョン管理にコミットしないでください。CLI は、このファイルを除外する .gitignore ファイルを自動的に作成します。

​
.types/types.d.ts

エンティティ、関数、エージェント、コネクター用に生成された TypeScript 型定義です。base44 types generate を実行すると作成されます。このファイルは、TypeScript プロジェクトで SDK を使用する際にオートコンプリートと型安全性を提供します。詳しくは Dynamic Types を参照してください。

​
agents/

AI エージェント構成を含むディレクトリです。各エージェントは個別の .json または .jsonc ファイルで定義されます。

​
auth/

アプリの認証構成を含むディレクトリです。エンドユーザーに利用可能なログイン方法を定義する単一の config.jsonc ファイルが含まれます。auth pull で Base44 から現在の構成をプルしてください。

​
connectors/

OAuth コネクター構成を含むディレクトリです。各コネクターは、slack.jsonc や googlecalendar.jsonc などのインテグレーションタイプにちなんだ個別の .json または .jsonc ファイルで定義されます。

​
entities/

エンティティスキーマ定義を含むディレクトリです。各エンティティは個別の .json または .jsonc ファイルで定義されます。最初のエンティティを定義する準備ができたらこのディレクトリを作成してください。

​
functions/

サーバーレスのバックエンド関数を含むディレクトリです。各関数には、entry.ts または entry.js コードファイルを持つ独自のサブディレクトリが必要です。CLI は、関数ルートに対する相対ディレクトリパスを関数名として使用します。例えば、functions/sendEmail/entry.ts は sendEmail という名前の関数を作成します。オプションで function.jsonc 構成ファイルを追加して、関数名をカスタマイズしたり自動化を追加したりできます。
functions
<function-name>
entry.ts
function.jsonc

​
.gitignore

ファイルがバージョン管理にコミットされないようにします。プロジェクトは、.app.jsonc がコミットされないようにするためのこのファイルから始まります。

​
AI エージェントスキルフォルダ

base44 create でプロジェクトを作成すると、AI エージェントスキルが自動的にインストールされます。これらは、使用する AI コーディングアシスタントに応じて、.claude/skills/、.cursor/skills/ などのエージェント固有のフォルダに表示されます。これらのフォルダは、コーディングエージェントが Base44 での作業方法を理解するのに役立ち、バージョン管理にコミットしても安全です。

​
関連項目

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