公開アセット

アプリのルートにある public/ フォルダーには、実行時に必要な画像、アイコン、フォントなどの静的ファイルが格納されます。これらのファイルはビルドに自動的に含まれ、開発モード中に同期され、サーバーにアップロードされます。 public/ に配置されたファイルは次のとおりです：

公開アクセス可能 — サーバーに同期されると、アセットはパブリック URL で配信されます。アクセスには認証は不要です。
フロントコンポーネントで利用可能 — アセットの URL を使用して、React コンポーネント内に画像、アイコン、その他のメディアを表示します。
ロジック関数で利用可能 — メール、API レスポンス、その他のサーバーサイドロジックでアセットの URL を参照します。
マーケットプレイスのメタデータに使用 — logoとgalleryImagesフィールドのdefineApplication()参照ファイルのこのフォルダ（例：public/logo.png）。アプリを公開すると、これらがマーケットプレイスに表示されます。外部の絶対URLはこれらのフィールドでは無視されます — 代わりにpublic/で画像をバンドルします。各画像のサイズは10 MBを超えてはいけません。
開発モードで自動同期 — public/ のファイルを追加、更新、削除すると、自動的にサーバーへ同期されます。再起動は不要です。
ビルドに含まれる — yarn twenty dev:build はすべての公開アセットを配布物にバンドルします。

`getPublicAssetUrl` で公開アセットにアクセスする

twenty-sdk の getPublicAssetUrl ヘルパーを使用して、public/ ディレクトリ内のファイルのフル URL を取得します。これはロジック関数とフロントコンポーネントの両方で機能します。 ロジック関数内：

src/logic-functions/send-invoice.ts

import { defineLogicFunction } from 'twenty-sdk/define';
import { getPublicAssetUrl } from 'twenty-sdk/utils';

const handler = async (): Promise<any> => {
  const logoUrl = getPublicAssetUrl('logo.png');
  const invoiceUrl = getPublicAssetUrl('templates/invoice.png');

  // Fetch the file content (no auth required — public endpoint)
  const response = await fetch(invoiceUrl);
  const buffer = await response.arrayBuffer();

  return { logoUrl, size: buffer.byteLength };
};

export default defineLogicFunction({
  universalIdentifier: 'a1b2c3d4-...',
  name: 'send-invoice',
  description: 'Sends an invoice with the app logo',
  timeoutSeconds: 10,
  handler,
});

フロントコンポーネント内：

src/front-components/company-card.tsx

import { defineFrontComponent } from 'twenty-sdk/define';
import { getPublicAssetUrl } from 'twenty-sdk/utils';

const CompanyCard = () => {
  const logoUrl = getPublicAssetUrl('logo.png');

  return <img src={logoUrl} alt="App logo" />;
};

export default defineFrontComponent({
  universalIdentifier: '...',
  name: 'company-card',
  component: CompanyCard,
});

path 引数はアプリの public/ フォルダーからの相対パスです。 getPublicAssetUrl('logo.png') と getPublicAssetUrl('public/logo.png') のどちらも同じ URL に解決されます—public/ プレフィックスが付いている場合は自動的に取り除かれます。

概要

アプリ

API

セルフホスト

貢献

`getPublicAssetUrl` で公開アセットにアクセスする

​getPublicAssetUrl で公開アセットにアクセスする

`getPublicAssetUrl` で公開アセットにアクセスする