Remotion デモ動画スキル
このスキルは、以下の場所にある Remotion ビデオデモの構築と保守を支援します。
demos/wallrun-video
以下のための構造を提供します:
- シーン作成
- コンポジション構造
- 再利用可能なモーションコンポーネント
- ビデオのペーシング
- 開発者向け説明
このスキルは、以下に取り組む際に使用します:
- Remotion コンポジション
- シーンコンポーネント
- アニメーション説明セグメント
- ビデオ構造またはシーケンス
- デモで使用されるモーションプリミティブ
プロジェクトコンテキスト
このリポジトリは Nx モノレポ です。
Remotion ビデオは以下にあります:
demos/wallrun-video
このプロジェクトは、WallRun の 開発者向け説明動画 をレンダリングします。
対象視聴者は フロントエンド開発者 であり、マーケターではありません。
視聴者は以下を理解していると想定します:
- React
- TypeScript
- コンポーネントアーキテクチャ
- レイアウトシステム
- 開発者ツール
基本的な JavaScript の概念は説明しないでください。
デザイン意図
ビデオは、製品広告 ではなく 開発者メディア のように感じられるべきです。
良いトーン:
- 編集的
- ミニマル
- モダン
- 自信に満ちている
- 控えめなモーション
悪いトーン:
- 一般的な SaaS プロモ
- 映画のようなトレーラー効果
- 重いパーティクルアニメーション
- 密度の高いマーケティングコピー
優先事項:
- 可読性
- 階層
- ペーシング
- 明瞭さ
プロジェクト構造
すべてのコードは以下に配置します:
demos/wallrun-video/src
構造:
- components/ — 再利用可能なプレゼンテーションプリミティブ
- scenes/ — ビデオの時間指定されたセクション
- data/ — スクリプト、コピー、タイミング定数
- Root.tsx — コンポジションを登録
- index.ts — Remotion CLI のエントリファイル
シーンデザインのルール
各シーンは 1つのアイデアのみ を伝える必要があります。
標準的な長さ: 4~8 秒
シーンは以下のようにします:
- すぐに読めること
- 大きなタイポグラフィを使用すること
- ごちゃごちゃしないこと
- モーションを控えめにすること
推奨されるシーンタイプ:
- タイトルカード
- ステージングされたリポジトリのスクリーンショット
- コンポーネントのクローズアップ
- コールアウトオーバーレイ
- アーキテクチャ図
- 統計パネル
避けるべきもの:
- 小さな UI
- 長い段落
- 複雑すぎるトランジション
アニメーションガイドライン
シンプルで決定論的なアニメーションを推奨します。
例:
- フェードイン
- スライドアップ
- 段階的な表示
- 微妙なスケール
避けるべきもの:
- バウンス効果
- 複雑な物理モーション
- 重いイージングカーブ
目標は 明瞭さ であり、見せかけではありません。
コーディング規約
以下を使用:
- React 関数コンポーネント
- TypeScript
- 名前付きエクスポート
- 明示的な型
- 再利用可能なモーションラッパー
避けるべきもの:
- 重複したアニメーションコード
- マジックナンバー
- ハードコードされたシーンタイミング
タイミング定数は実用的な場合に抽出します。
例:
const TITLE_FADE_IN = 20;
const CALLOUT_DELAY = 15;
新しいシーン作成のデフォルトワークフロー
- シーンのメッセージを定義する
- フレーム単位で長さを定義する
- レイアウトをブロックする
- プライマリモーションを追加する
- 明瞭さが向上する場合のみセカンダリモーションを追加する
- 可読性を確認する
- コードが再利用可能であることを確認する
Nx ターゲット
- preview —
nx preview wallrun-videoで Remotion Studio を開く - render —
nx render wallrun-videoでフルビデオをdist/demos/wallrun-video/にレンダリング - type-check —
nx type-check wallrun-videoで TypeScript コンパイラを実行
完了の定義
シーンは以下の場合に完了とします:
- メッセージが即座に明確である
- タイポグラフィがビデオスケールで読める
- アニメーションが控えめである
- タイミングが編集しやすい
- コードがきれいに構造化されている