asc-app-shots

asc-app-shots：App Store スクリーンショットデザイナー

3 つのワークフロー：

	A：テンプレート	B：ギャラリー	C：テーマ適用
フロー	閲覧 → 適用 → 生成	ギャラリーテンプレート → すべての画面	テンプレート → ThemeDesign → 適用
画面	単一	複数（ヒーロー＋機能紹介）	スライドごと
AI	オプション（Gemini による強化）	オプション	デザインに AI を 1 回使用し、残りは決定論的に処理

---

ワークフロー A — 単一テンプレート

テンプレートを閲覧してスクリーンショットに適用し、必要に応じて Gemini AI で強化します。

ステップ 1 — 閲覧して適用

asc app-shots templates list --output table
asc app-shots templates get --id top-hero --preview > preview.html && open preview.html

# Apply to screenshot → HTML preview
asc app-shots templates apply \
  --id top-hero --screenshot screen.png --headline "Ship Faster" \
  --preview html > composed.html && open composed.html

# Apply to screenshot → PNG export
asc app-shots templates apply \
  --id top-hero --screenshot screen.png --headline "Ship Faster" \
  --preview image --image-output marketing.png

ステップ 2 — Gemini AI で強化（オプション）

asc app-shots generate --file marketing.png
asc app-shots generate --file marketing.png --device-type APP_IPHONE_67
asc app-shots generate --file marketing.png --style-reference inspiration.png
asc app-shots generate --file marketing.png --prompt "warmer colors, deeper shadows"

---

ワークフロー B — ギャラリーテンプレート

統一感のある複数画面のセット（ヒーロー＋機能紹介画面）です。

# Browse gallery templates
asc app-shots gallery-templates list --output table

# Preview all screens in horizontal strip
asc app-shots gallery-templates get --id neon-pop --preview > gallery.html && open gallery.html

# Get gallery details (JSON with shots, template, palette)
asc app-shots gallery-templates get --id neon-pop --pretty

ギャラリーテンプレートには、カスタマイズしてすぐに使えるサンプルコンテンツ（見出し、バッジ、信頼マーク）が含まれています。

---

ワークフロー C — テーマ適用スクリーンショット

テンプレートにビジュアルテーマを適用します。2 段階のフローです。ThemeDesign を 1 回生成（AI 呼び出し 1 回）した後、任意の数のスクリーンショットに決定論的に適用します。

ステップ 1 — テーマを閲覧

asc app-shots themes list --output table
# → Cartoon, Joyful, Holiday, Zen, Neon, Nature, Retro, Space, Luxury

asc app-shots themes get --id luxury --pretty
asc app-shots themes get --id luxury --context   # AI prompt string

ステップ 2 — ThemeDesign を生成（AI 呼び出し 1 回、再利用可能）

asc app-shots themes design --id luxury > design.json

palette（背景＋textColor）と decorations（アニメーション付きの浮遊要素）を含む JSON を返します。

ステップ 3 — ThemeDesign を適用（決定論的、AI 不使用）

# HTML preview
asc app-shots themes apply-design \
  --design design.json --template top-hero \
  --screenshot screen.png --headline "Ship Faster" \
  --preview html > themed.html

# PNG export
asc app-shots themes apply-design \
  --design design.json --template top-hero \
  --screenshot screen.png --headline "Ship Faster" \
  --preview image --image-output themed.png

代替方法：AI による全面的なスタイル変更（フォールバック）

asc app-shots themes apply \
  --theme luxury --template top-hero \
  --screenshot screen.png --headline "Ship Faster"

スライドごとに AI でスタイルを変更します。処理は遅くなりますが、より創造的な結果が得られます。design が利用できない場合は、この方法にフォールバックします。

---

コマンドリファレンス

すべてのフラグ表については、references/commands.md を参照してください。

テンプレート

asc app-shots templates list [--size portrait] [--preview] [--output table]
asc app-shots templates get --id <ID> [--preview]
asc app-shots templates apply --id <ID> --screenshot <FILE> --headline <TEXT> [--preview html|image]

ギャラリーテンプレート

asc app-shots gallery-templates list [--output table]
asc app-shots gallery-templates get --id <ID> [--preview]

テーマ

asc app-shots themes list [--output table]
asc app-shots themes get --id <ID> [--context]
asc app-shots themes design --id <ID>
asc app-shots themes apply-design --design <FILE> --template <ID> --screenshot <FILE> --headline <TEXT>
asc app-shots themes apply --theme <ID> --template <ID> --screenshot <FILE> --headline <TEXT>

生成（Gemini AI）

asc app-shots generate --file <FILE> [--device-type <TYPE>] [--style-reference <FILE>] [--prompt <TEXT>]

エクスポートと設定

asc app-shots export --html <FILE> --output <PNG>
asc app-shots config --gemini-api-key <KEY>

---

利用可能なテンプレート

カテゴリ	テンプレート
大胆	トップヒーロー、太字 CTA、傾斜ヒーロー
ミニマル	ミニマルライト、デバイスのみ
エレガント	ダークプレミアム、セージエディトリアル、クリームセリフ、オーシャンカーム、ブラッシュエディトリアル
プロフェッショナル	上下配置、左揃え、下部テキスト
遊び心のあるデザイン	暖かな夕焼け、ソフトスカイ、カートゥーンピーチ、カートゥーンミント、カートゥーンラベンダー
ショーケース	デュオデバイス（2 台）、トリプルファン（3 台）、横並び（2 台）

利用可能なテーマ

テーマ	スタイル
カートゥーン	太い輪郭線、明るい単色、遊び心のある形
ジョイフル	紙吹雪、きらめき、暖かなグラデーション
ホリデー	華やかな装飾、雪の結晶
禅	穏やかでミニマル、漂う葉
ネオン	暗い背景、光るネオンのアクセント
ネイチャー	自然な形、花びら、水彩
レトロ	ヴィンテージカラー、幾何学模様、80〜90 年代
宇宙	宇宙をイメージした背景、きらめく星
ラグジュアリー	金色のアクセント、暗い背景、優雅さ

---

Gemini API キー

解決順序：

1. --gemini-api-key フラグ
2. $GEMINI_API_KEY 環境変数
3. ~/.asc/app-shots-config.json（asc app-shots config 経由）

デバイスサイズ

デバイスタイプ	幅 × 高さ	必須
APP_IPHONE_69	1320 × 2868	✅
APP_IPHONE_67	1290 × 2796	✅
APP_IPHONE_65	1260 × 2736	✅
APP_IPAD_PRO_129	2048 × 2732	✅