メインコンテンツへスキップ
npx create-twenty-app で生成された新しいアプリは、次のような構成になります。

​
主要ファイル

ファイル構成は自由です。 上記のフォルダーはあくまで慣習であり、SDK はファイルがどこにあっても、export default defineEntity(...) 呼び出しに対する AST 解析によってエンティティを検出します。

​
依存関係

Twenty の両方の SDK パッケージは、dependencies ではなく devDependencies の下に属します。
スキャフォルダーは twenty-sdk と twenty-client-sdk を自身のバージョンに固定します — アップグレードする際はこの 2 つを同期させてください。
  • twenty-sdk は、twenty CLI とビルド／スキャフォールディング用のツールを提供します。 これは開発時とビルド時にのみ実行され、公開済みアプリのランタイムによってインポートされることは決してありません。
  • twenty-client-sdk はアプリのコード（CoreApiClient、MetadataApiClient、RestApiClient）によってインポートされますが、Twenty がランタイムで提供します — ロジック関数は生成された SDK レイヤーからそれを取得し、フロントエンドコンポーネントはサーバー提供のモジュールから解決します。 インストール済みのコピーは型チェックとデプロイ時のビルドにのみ使用されるため、デプロイされたバンドルに同梱される必要はありません。
どちらかのパッケージを dependencies の下に置いたままだと、インストールされたアプリのランタイムバンドルに取り込まれてしまい、不要な重荷になります。 いずれかがまだ dependencies の下にリストされている場合、twenty dev:build は警告を出力します。 アプリ独自のランタイム依存関係（ロジック関数が実際にランタイムでインポートするライブラリ）は、通常どおり dependencies の下に追加してください。