publish

ビルドとデプロイのワークフロー

前提条件

• Node.js がインストールされていること
• Domo CLI がインストールされていること（npm install -g @domoinc/ryuu）

ローカル開発

npm install          # Install dependencies
npm run dev          # Start dev server (usually Vite)

API 呼び出しをローカルで機能させるには、ryuu-proxy を設定し、domo login で認証する必要があります。

本番用ビルド

npm run build        # Outputs to dist/ (Vite) or build/ (CRA)

Domo CLI の認証

domo login           # Authenticate with your Domo instance

Domo インスタンスの URL と認証情報の入力を求められます。

公開

cd dist              # Change to build output directory
domo publish         # Publish to Domo

公開に新規または更新された Code Engine パッケージが含まれる場合は、まず次の手順でパッケージのライフサイクルを実行してください。

• ~/.agents/skills/code-engine-create/SKILL.md
• ~/.agents/skills/code-engine-update/SKILL.md

重要 — 初回公開時：

• 初回公開時に、Domo はアプリに新しい id を生成します
• この ID は、dist フォルダー内の公開済み manifest.json に表示されます
• この ID をソースの manifest.json（例：public/manifest.json）にコピーする必要があります
• コピーしないと、既存のアプリが更新されず、公開のたびに新しいアプリが作成されます

# After first publish, copy the generated ID:
# dist/manifest.json → public/manifest.json (just the "id" field)

2 回目以降の公開

ソースのマニフェストに ID を設定したら：

npm run build && cd dist && domo publish

ビルドチェックリスト

公開する前に、次の項目を確認してください。

• データセットの manifest.json で、id ではなく正しい dataSetId が設定されている
• 各データセットのマッピングで、fields: [] が設定されている
• thumbnail.png が存在し、サイズが 300x300 ピクセルである
• すべてのクエリで、特定の列を指定した .select() が使われている（すべての列を取得しない）
• 各ビジュアライゼーションで、最適化された専用のクエリが使われている
• .aggregate() の呼び出しがない（.groupBy() またはクライアント側の集計を使用する）
• .groupBy() の呼び出しで、グループ化する列が指定されている（集計だけにしない）