Communitygithub.com

immersive-web

没入感のある映画のような「未来のウェブサイト」体験を、高速でアクセシブルに構築します。ブラウザでの3Dシーン(Three.js、React Three Fiber、WebGL、WebGPU)、シェーダー(GLSL、TSL)、スクロール駆動のストーリーテリング、映画的なモーションとページ遷移、そしてBlenderからブラウザへのパス(glTF、Draco、meshopt、KTX2、ベイクされたライティング)を扱います。

immersive-web とは?

このスキルは、Web上で没入型・映画的な3D体験を構築するための包括的なガイドです。主要なルールとして、コンテンツを常に最優先し、HTMLとして実際のテキストを提供すること、すべての効果に対してフル状態、動きを抑えた状態(prefers-reduced-motion対応)、GPU非対応状態(WebGL/WebGPUがない場合)の3つの状態を設計すること、パフォーマンス予算を事前に決めて守ること、ページあたりの印象的な瞬間は1つに絞ること、スクロール操作を乗っ取らないこと、アクセシビリティを確保することなどが挙げられます。Three.js、React Three Fiber、CSSアニメーション、GSAPなど様々なツールを、タスクに応じて最も軽量なものを選択します。また、テーマシステムと統合され、UIデザインスキル(ui-craft)と連携し、同じデザイントークンを共有することで、一貫性のあるビジュアル体験を実現します。モバイルファーストで設計し、バンドルサイズや描画コールの制限を含む詳細なパフォーマンス予算が定義されています。最後に、自動チェックツールを使用して品質を担保します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/najeebafridi/ui-craft/tree/HEAD/skills/immersive-web

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

immersive-web は何をしますか?

最高の映画やゲームのように感じられ、普通のページのように読み込まれ、誰も取り残さない、3D、シェーダー、スクロール駆動の体験を構築する方法。

このスキルは一つのレイヤーです。 ui-craftスキル(同じプラグイン)は、通常のインターフェースデザイン(レイアウト、階層、タイポグラフィ、色、コンポーネント、フォーム、状態)を担当します。これらにはそちらを使用し、ここで繰り返さないでください。このスキルは、その上にレイヤー(シーン、ライト、マテリアル、シェーダー、カメラ、スクロール、映画的なモーション)を追加します。両方とも同じテーマトークンを読み取るため、一つのテーマがページとシーンの両方を駆動します(references/theme-bridge.md)。

正直な限界。 あなたはシーンを演出し、照明を当て、カメラを動かし、シェーダーを書き、モデルを組み込むことができます。しかし、何もないところから映画品質の3Dアートを彫刻することはできません。シンプルなジオメトリ、シェーダー、タイポグラフィ、ライトから構成するか、チームが提供するモデルを使用してください。対象を粗く描いたものでごまかしてはいけません。

1. 9つの厳格なルール

一つでも破れば、どんなに見栄えが良くても、その作業は完了したとは言えません。

  1. コンテンツファースト。 見出し、コピー、リンク、ボタンは実際のHTMLであり、スクリプトが実行される前に読める状態でなければなりません。シーンはその上に追加され、なくなっても損失はありません。ページの単語をキャンバスに描き込まないでください。CSSでopacity: 0にしてスクリプトが表示するのを待つ状態にコンテンツを隠さないでください。
  2. すべてのエフェクトに3つの状態。 フル、動きを抑えた状態(静止フレームまたは短いフェード:prefers-reduced-motion、およびネイティブアプリではOS設定)、GPUなし(WebGLまたはWebGPUがない、失敗した、またはコンテキストが失われた場合に表示するポスター画像またはCSS/SVGアート)。最初に2つのフォールバックを設計してください。これらは最初に読み込まれるものでもあります。フォールバックは同じ絵柄で、より静かなものです:同じ被写体を同じアングルから(シーン自体から作られたポスター)、データシーンの場合は同じデータをフラットに描画したものです。空のボックス、単純なグラデーション、「画像準備中」は失敗です。
  3. スピード予算を構築前に決定する(§4)。 ページのテキストが最初にペイントされ、その後エンジンが読み込まれます。スマートフォンでは、シーンのコストはコンテンツよりも小さくなければなりません。
  4. ページごとに一つの代表的な瞬間を設け、それを印象的にする。 一つのシーン、一つのアイデア、完全にやり遂げること。他のすべては控えめにします。あらゆる場所にエフェクトがあると、テンプレートのように見え、ユーザーを疲れさせます。抑制はエフェクトの数を制限するのであって、強さを制限するわけではありません。その一つの瞬間は、このプロダクトに属するイベントであるべきです(やかんが傾く、目が慣れるにつれて空が星で満たされるなど)、誰かが友人に説明したくなるほど大胆に演出します。スクロールするだけで回転するだけのオブジェクトは瞬間ではありません。
  5. 決してスクロールを奪わない。 ブラウザがスクロールします。あなたは位置を読み取るだけです。速度や方向の変更、ホイールの乗っ取り、偽のスクロールバーは禁止です。position: stickyで固定し、短く保ち、スキップする方法を提供してください。
  6. テキストとシーンが同じ場所を共有してはならない。 どのスクロール位置でも、テキストは被写体の横または独自の表面上にあり、決してその上に重なってはいけません。シーン上に配置されたナビゲーションとボタンには、スリムまたはサーフェスが必要です。最初のスクロール位置だけでなく、すべてのスクロール位置のスクリーンショットを確認してください。
  7. キーボードとスクリーンリーダーは、すべての実際の要素に到達できる。 タブオーダーは読み取り順序に従います。装飾的なキャンバスはaria-hidden="true"とします。意味のあるキャンバスには、その横にテキストによる代替手段が必要です。シーンをドラッグしてできることは、ボタンでもできるようにしてください。
  8. モーションは停止し、サウンドは待機し、何もフラッシュしない。 アンビエントモーションは5秒以内に落ち着くか、表示された一時停止コントロールが必要です。サウンドは要求されるまでオフにします。1秒間に3回以上のフラッシュは絶対に禁止です。画面外や非表示のタブで動作するものはありません。
  9. オリジナルかつライセンス済み。 ジャンルの言語を学びましょう。製品の外観、モデル、キャラクター、ロゴ、サウンドを決してコピーしてはいけません。自分で作成したアセット、または明確なライセンス(Poly HavenやambientCGなどのCC0ライブラリは安全です)を持つアセットのみを使用し、それぞれを記録してください。

2. ワークフロー(毎回これを行う)

  1. 構築する前に確認する。 テーマを見つけてください:theme.css、DESIGN.md(ui-craft Studioから)、トークン、Tailwind設定、ブランドカラー。--immersiveと、もしあれば概要の「Immersive and motion」セクションを読んでください。それらはオーナーが選択した強度を示しています。スタック(プレーンなHTML、React、Vue、アプリシェル)と、すでに提供されている3Dアセットを確認してください。テーマがまったくない場合は、最初にui-craftを使用して方向性を選択してください。

  2. §3のはしごからレベルを選択する。 テーマに記載されていればそれに従い、そうでなければアイデアを実現できる最低のレベルを選んでください。レベル3は稀です。

  3. それを実行できる最も軽量なツールを選ぶ。

    ニーズ使用するものコスト
    リビール、パララックスフリーのスクロールエフェクト、ページトランジションCSSのみ:スクロール駆動アニメーション、position: sticky、View Transitions0 KB
    フラットな生きているテクスチャ、線、フィールド、2DフィギュアCanvas 2D、SVG、または単一の三角形上の1つのフラグメントシェーダー(生のWebGL、ライブラリなし)2-5 KB
    ユーザーが回せる1つの3Dモデルを表示<model-viewer>約250 KB、遅延読み込み
    実際のシーン:複数のオブジェクト、ライト、動くカメラthree.js(Reactアプリ:React Three Fiber)を動的なimport()で読み込み150-180 KB gzip、遅延読み込み
    CSSで表現できないスクロールに紐づくタイムラインGSAP ScrollTrigger(フリー、オープンソースではありません:読み込んで、コピーしないこと)またはMotion25-45 KB
    最新のGPU機能WebGPUを、常にWebGLパスの上位互換として、単独では使用しない-

    スムーズスクロールライブラリをデフォルトで追加しないでください。概要で要求された場合、動きを抑えた状態では自動的にオフになる必要があります。

  4. 没入型概要を作成する(ui-craftデザイン概要に追加)、コードの前に:

    レベル: 2 シグネチャー(テーマは --immersive: 2)        スタック: プレーンなHTML + three.js、遅延読み込み
    代表的な瞬間(ターンテーブルではなくイベント):ビート3でやかんが傾き、細い流れが注ぎ出され、その線を維持する
    シーン: ページ背景上の光のプールの中にある1つのつや消しセラミックのやかん、左上からの柔らかいキーライト、暖かいリム
    テキストエリア: デスクトップでは左列のコピー、スマートフォンでは固定シーンの下、やかんがそれを横切ることは決してない
    カメラ: 35mm風、やや上から、決して自分から動かない        テンポ: 穏やか(--dur-slow 400ms)
    ビート(レベル3のみ):1 やかん全体 - 2 注ぎ口、クローズアップ - 3 注ぐ - 4 テーブル上のセット
    動きを抑えた状態:ビートごとに1つの静止レンダリング、クロスフェード        GPUなし:同じシーン、同じアングルのポスター
    予算:テキストが最初にペイント、エンジンはその後、スマートフォンでシーンは1.5 MB未満、タッチデバイスではピクセル比1.5
    
  5. この順序で構築する。 (a) ui-craftを使用して、シーンの場所にポスターまたはCSSフォールバックを配置した、プレーンなHTMLとCSSによるページ全体。これだけで良いページになっている必要があります。(b) シーンシェル:assets/scene-shell.jsは遅延起動、静止フレーム、フォールバック、画面外での一時停止、ピクセル比上限、コンテキスト喪失回復を提供します。(c) テーマブリッジ:assets/theme-bridge.jsにより、色、半径、テンポがトークンから取得されます。(d) シーン自体、最もシンプルな形で。(e) モーションとスクロール。(f) ポリッシュ:ライト、マテリアル、グレイン、タイミング。assets/starter.htmlは(a)-(c)が完了した動作するページです。そのプレースホルダーシーンを置き換えてください。

  6. チェックしてから、見る。 node <skill-dir>/scripts/immersive-check.mjs page.htmlを実行します。これにより、ページが5つの方法(デスクトップ、スマートフォン、動きを抑えた状態、WebGLなし、JavaScriptなし)で読み込まれ、重さ、ドローコール、ピクセル比、ネイティブスクロール、一時停止を測定し、スクリーンショットを保存します。アプリウィンドウ(Electron、Tauri、サインイン済みWebアプリ)の場合は、--appを追加してJavaScriptなしテストをスキップします。すべてのスクリーンショットを開いてください。 失敗したものを修正します。特に注意深く見るべき3つ:スクロールの中間(テキストが被写体を横切っていないか?)、スマートフォンの中間(シーンとテキストが一つの画面に収まり、空の帯がないか?)、そしてWebGLなしのもの(同じ絵か、穴が開いていないか?)。シーン自体からポスターを作成します:--poster hero-poster.pngは、デスクトップパス(--scheme lightまたはdarkでテーマを選択)からシーンのボックスを保存し、フォールバック画像として使用できるようにします。次に、ui-craftのui-audit.mjsを実行して、コントラスト、タップターゲット、タイポグラフィをチェックし、スマートフォンをデスクトップと同様に厳しく評価します。最終パス:references/accessibility-fallbacks.mdのチェックリスト。

3. 没入度のはしご

すべてのプロダクトは、はしごの一段に位置します。テーマは--immersive: 0-3としてそれを伝えることができます。16のui-craftの方向性はそれぞれデフォルトを設定します(references/theme-bridge.md)。

レベル説明適しているもの適さないもの
0 静的3D、シェーダー、スクロールエフェクトなし。通常のインターフェースモーションのみ金融ツール、管理画面、政府、健康フォーム、高密度ダッシュボード、一日中使用するもの-
1 アクセント一つの静かなリビングディテール:マテリアル、ゆっくりとしたシェーダーテクスチャ、ビュートランジション。数秒で静止します。スクロール駆動シーンなしSaaSアプリ、ドキュメント、ほとんどのプロダクトUI、デスクトップおよびモバイルアプリユーザーが不安または急いでいるタスク
2 シグネチャー一つのヒーローモーメント:ポインターまたは最初のスクロールに応答するオブジェクトまたはシェーダー。その後は通常のページランディングページ、プロダクトページ、ポートフォリオ、オンボーディング、起動画面毎日再訪するページ
3 ストーリー一つの持続的なシーンを持つ、3〜5のビートからなるスクロール駆動シーケンスローンチ、キャンペーン、特集記事、ミュージアムおよびブランドストーリーアプリ、チェックアウト、タスクを伴うものすべて

はしごのルール:レベルは上限であり、目標ではありません。頻度がそれを下げます:人が画面を見る頻度が高いほど、レベルは低くなります。タスクがそれを下げます:人が支払い、サインイン、または問題を修正している場合は、レベル0を使用します。不明な場合は、一つ下のレベルに進み、より良く仕上げてください。

4. 予算

実用的な目標。推測せずに測定してください。*印の付いた数値は、妥当なデフォルトであり、公開された制限ではありません。

項目スマートフォンデスクトップ
Largest Contentful Paint(テキストまたはポスターである必要があり、キャンバスであってはならない)2.5秒以下2.5秒以下
最初のペイント前に要求されるスクリプト圧縮後170 KB未満同左
エンジン(three.js 約180 KB gzip)最初のペイント後、動的なimport()で、シーンがビューポートの近くにある場合のみ同左
最初のシーンペイロード:エンジン + モデル + テクスチャ *1.5 MB未満4 MB未満
ヒーローモデル(GLB、圧縮済み) *2 MB未満、20-60kトライアングル5 MB未満、最大100k
テクスチャ1024 px、ヒーローのみ2048 px、GPUメモリ用にKTX22048 px、クローズアップのみ4096 px
ピクセル比上限1.5、低速時は1に低下上限2
フレームあたりのドローコール *100未満300未満
リアルタイムライト1基のキーライト(+環境)、1024のシャドウマップ1枚、またはベイク/ブラブシャドウ1-3基、シャドウマップは最大2048
ポストプロセッシングパス0-11-3
フレーム時間60 fps安定、30を下回る前に品質を低下60 fps
スクロールストーリー3-5ビート、各100-150vh、固定ランは5画面未満*、スキップリンク同左
プリローダーなし、ページは1-2秒で読めるようになり、シーンは準備ができたときにフェードイン同左

2048 pxのテクスチャは、ファイルサイズに関係なく、KTX2でない限り、展開されると約22 MBのビデオメモリを消費します。詳細と品質低下の順序:references/performance.md。

5. すべてのレイヤーを駆動する一つのテーマ

  • トークンから色を読み取ります(--bg、--surface、--accent、--accent-soft、--text、--border...)、シェーダーやマテリアルに16進数をハードコードしないでください。assets/theme-bridge.jsのreadTheme()は、ライティング計算用に線形RGB、フラット描画用にsRGBとしてそれぞれを返し、watchTheme()はライト/ダークの切り替え時に再読み取りします。
  • シーンはページ背景の上に配置されます:透明なキャンバス、または--bgと等しいクリアカラー。目に見える長方形、2つ目の背景色はありません。
  • アクセントカラーは3Dでも稀に使用します:1つのオブジェクト、1つのライト、1つの線。ほとんどはニュートラルです。
  • テーマのシェイプが引き継がれます:角の半径はベベルとエッジ半径になり、奥行きスタイルはシャドウスタイルになります(ヘアライン:細いアウトライン、ほとんど影なし;ソフト:広く柔らかいコンタクトシャドウ;クリスプ:よりタイトで光沢がある;リップ:ハードなオフセットエッジ;フラット:なし)。
  • モーショントークンがテンポを設定します:--dur-*と--ease-outがカメラ移動とスクロールイージングを形成します(ブリッジ内のbezier())、そのため「インスタント」なツールと「スロー」な高級ハウスが同じコードで異なる動きをします。バウンスは、テーマのカーブがオーバーシュートする場合のみ使用します。
  • タイポグラフィはHTMLのまま--font-displayと--font-sansで、キャンバスの上または横に配置されます。

6. クラフト、簡潔に

シーンとカメラ(references/scene-camera.md)

  • 1つの被写体、1つの明確なシルエット、多くの静かなスペース。まずスマートフォンの縦長のフレームに合わせて構成します。
  • 長いレンズ(画角20-35度)はオブジェクトを引き立てます。広角は歪みます。カメラはゆっくりと、そして理由があって動くか、またはまったく動きません。
  • オンデマンドでレンダリングします。変化していないシーンは何も描画しません。

ライトとマテリアル(references/materials-lighting.md)

  • 上部からの1つのキーライト(UIと同じ単一光源)、柔らかなフィル、被写体を背景から分離するリム。ライトは決して純白ではなく、影は決して純黒ではありません。
  • 被写体を地面に設置します:柔らかなコンタクトシャドウ、さもなければ浮いて見えます。
  • 何かを判断する前にカラースペースを設定してください。暗すぎる、または色あせて見えるのは、ライティングの問題ではなく、カラースペースのミスです。
  • シーンが静的な場合は、ライトをテクスチャに焼き付けます。それは最もコストの低いライトです。

シェーダー(references/shaders.md)

  • シェーダーは、仕事を持つマテリアル、ライト、またはテクスチャです。壁紙ではありません。
  • テーマカラーから2〜4色のパレットを、OKLabで混合して中間色をクリーンに保ちます。虹色は禁止です。
  • ソフトグラデーションのバンディングを隠すために2〜4%のグレインを追加します。スマートフォンではフラグメント処理を軽く保ちます(テクスチャ読み取りは少なく、長いループは避ける)。

スクロールストーリーテリング(references/scroll-storytelling.md)

  • 各ビートは、実際のテキストの一行を持つ一つのアイデアです。ビートに言うべきことがなければ、削除してください。
  • テキストは通常にスクロールし、シーンは(スティッキーで)静止し、それに合わせて変化します。時間ではなく位置をスクラブします。
  • 動きを抑えた状態では、フィルムをスライドに変換します:ビートごとに1つの静止フレーム。

映画的なモーション(references/cinematic-motion.md)

  • アイデア間はカットまたはディゾルブ、アイデア内で移動します。重要なものをホールドします。イージングは演技です:装飾ではなく、重みです。
  • インターフェースモーションはui-craftのタイミング(100-300 ms)を維持します。シーンとカメラの移動は600-1200 msかかります。ページトランジションは200-500 ms、URL、戻るボタン、フォーカスは機能し続けます。

Blenderからブラウザへ(references/blender-pipeline.md)

  • Principled BSDFのみを使用し、残りはベイクし、GLB形式でエクスポートし、その後圧縮します:gltf-transform optimize、meshoptまたはDraco、KTX2テクスチャ。ファイルを

…

[翻訳のため一部省略されました]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル