App ビューアー
ライブアプリをプレビューし、インタラクションをテストし、公開前チェックを実行できます。さらに、ツールバーの完全ガイドと、ビジュアル編集を行うすべての方法も確認できます。
ライブアプリをプレビューし、インタラクションをテストし、公開前チェックを実行できます。さらに、ツールバーの完全ガイドと、ビジュアル編集を行うすべての方法も確認できます。
App ビューアーとは?
AI エージェントがタスクを完了すると、ページ上部に App ビューアーが開きます。作成したものの見た目を確認するだけでなく、完全に動作するアプリとして操作できます。ページをクリックして移動し、機能をテストし、コードを書かずにビジュアル変更を加えられます。また、公開前の最終チェックポイントとしても機能します。見た目がおかしい箇所や予期しない動作があれば、ユーザーに表示される前に見つけて修正できます。
始める前に: エージェントの処理には少し時間がかかる場合があります。タスクの実行中は、右側のターミナルパネルに、ファイル作成、コード生成、途中で発生したエラーなどのリアルタイムのアクティビティが表示されます。また、いつでも Refresh アイコンを使ってプレビューの最新バージョンを再読み込みできます。
App ビューアーのツールバー
プレビューウィンドウの上には細いツールバーがあります。左から右へ、各コントロールの役割は次のとおりです。
- Design: ビジュアル編集モードを切り替えます。有効にすると、プレビュー内の任意の要素をクリックして、その要素を編集対象として選択できます。詳しくは以下の「アプリを変更する」を参照してください。
- Device toggle: 表示アイコンでプレビューをモバイル表示に切り替えたり元に戻したりできるため、ページを離れずにレスポンシブ対応を確認できます。
- Refresh: プレビューウィンドウを再読み込みします。プレビューが古いままに見える、または固まっているように見えるときに最初に試す操作です。
- Home: どこまで移動していても、プレビューをアプリのホームページに戻します。
- Page selector: 中央のドロップダウンにはアプリのページ一覧が表示されます。そこまでクリックして移動しなくても、選択したページを直接プレビューできます。
- Open in new tab: 矢印アイコンでプレビューを別のブラウザタブで開きます。埋め込みプレビューが固まっている、または反応しない場合に特に便利です。
- Console: 右端にあり、システムログとエラーメッセージを表示するパネルを開きます。何か壊れているように見えるときに最初に確認する場所です。

プレビュー上部のツールバー: 左側に Design、その次にデバイス切り替え(「モバイルプレビューを表示」)、refresh、home、ページセレクター、別タブで開く、そして右側に Console があります。

矢印アイコンを使うと、実行中のアプリを専用のブラウザタブで開けます。埋め込みプレビューの動作がおかしい場合の確実な回避手段です。
App ビューアーの使い方
ステップ 1: プレビューの読み込みを待つ
エージェントの完了後、App ビューアーはメインウィンドウにプレビューを読み込みます。通常は数秒から 1 分ほどかかります。
2 分以上かかる場合は? ツールバーの Refresh をクリックしてください。それでも固まっている場合は、Console でエラーを確認してください(ステップ 3 を参照)。
ステップ 2: プレビューしてインタラクションをテストする
読み込みが完了したら、表示されているのは実際のアプリです。
- レスポンシブ対応を確認: デバイス切り替えを使ってデスクトップ表示とモバイル表示を切り替え、小さい画面でもレイアウトが崩れないことを確認します。
- インタラクションを一通り試す: すべてのナビゲーションリンクを開き、ボタンを押し、フォームを送信し、ホバー状態を発生させてください。表示されるページと、実際に機能するページは同じではありません。
- 重要な導線をたどる: 最も重要な導線を、ランディングページから探索、そして主要な行動喚起の完了まで、最初から最後まで確認してください。
- 実際のタブでテストする: 新しいブラウザタブでプレビューを開き、ユーザーが実際に使う環境で最終確認を行ってください。
ステップ 3: エラーを確認する(何かおかしい場合)
アプリが読み込まれない、または壊れて見える場合は、App ビューアーのツールバーで Console を選択してください。Console パネルはプレビューの下に開きます。一方、ターミナルは別のタスクアクティビティ領域です。Console にはビルド中に生成されたシステムログとエラーメッセージが集約されます。赤いエラーメッセージには、何が問題だったのかの説明や追加の診断情報が含まれる場合があります。
エラーを修正するには:
- 問題の報告通知内の Resolve をクリックすると、AI が特定されたすべてのバグを自動で分析・修正し、修正が反映されるとプレビューが再読み込みされます。進行状況はターミナルパネルでリアルタイムに確認できます。
- Resolve ボタンがない場合は? エージェントの最新メッセージの横にある「…」(その他のオプション)をクリックし、Feedback を選択してサポートチームに連絡してください。その際、Chat Link とエラーのスクリーンショットを含めてください。
エラー処理の完全な流れについては、問題の報告を参照してください。
ステップ 4: アプリを変更する
方法 1 — クリックして編集する(ビジュアル変更に最適)
まず、App ビューアーのツールバーで Design を選択してビジュアル編集モードを有効にします。Design は、編集者アクセス権を持つユーザー向けの対象デスクトッププロジェクト状態でのみ利用できます。表示されない場合は、チャットで方法 2 を使ってください。次に、プレビュー内の任意の要素を直接クリックします。要素はアウトラインで選択され、選択したものとそのサイズを示すバッジが表示されます。たとえば h1、ボタン、カードなどです。要素のすぐ近くにはインラインの「Ask the Atoms to change…」バーが表示されるため、その場所に限定した変更内容を説明できます。また、左側にはビジュアルエディターが開き、手動で調整できます。
- Colors: カラーピッカーを使って、テキスト、背景、境界線の色を変更します。
- Spacing: padding、margin、要素間の間隔を調整します。
- Typography: フォントサイズ、太さ、フォントファミリーを変更します。
- Layout: 配置、flexbox、grid のプロパティを調整します。
- Text content: その場でテキストを編集します。
すべての変更は即座にプレビューに反映されるため、結果をリアルタイムで確認できます。ビジュアルエディターには、事前構築済みアセットを参照して追加できる Library タブもあります。アイコン、画像、UI コンポーネントをそのままプロジェクトに追加できます。

クリックして編集の動作例: 見出しが選択され(タグとサイズも表示)、インラインバーからこの要素だけに対する変更を依頼できます。
方法 2 — チャットで説明する
変更したい内容を自然な言葉でエージェントに伝えると、アプリに適用されます。
背景色をもっと暗くしてください。
ヘッダー周りの padding を減らしてください。
ボタンの色を青に変更してください。
公開前チェック
App ビューアーは Publish 前の最後の確認場所です。このチェックリストは、ユーザーに表示される前によくある問題を見つけるのに役立ちます。
- プレビューが正常に読み込まれ、Console に赤いエラーメッセージが表示されていない。
- レイアウトがデスクトップだけでなくモバイル表示でも崩れていない。
- すべてのインタラクションが機能している: ナビゲーション、ボタン、フォーム、主要な行動喚起。
- プレースホルダーの内容が置き換えられている。[Company name] のような角括弧付きの仮置きテキストは見落としやすく、公開後には非常に目立ちます。
- ページセレクター内の各ページを、ホームページだけでなく少なくとも一度は簡単に確認している。
問題なければ、右上の Publish を押してリンクを共有してください。
クイックリファレンス
- プレビューを再読み込み — App ビューアーのツールバーにある Refresh アイコン。
- デバイス表示を切り替える — 異なる画面サイズをテストするための、ツールバー内のデバイス切り替え。
- ページ間を移動する — ツールバー内のページセレクターのドロップダウン。
- 新しいタブで開く — ツールバー内の矢印アイコン。
- エラーログを表示する — App ビューアーのツールバーで Console を選択します。ログパネルはプレビューの下に開きます。
- エラーを自動修正する — 問題の報告通知内の Resolve ボタン。
- ビジュアル要素を編集する — プレビュー内の任意の要素をクリックして選択し、ビジュアルエディターを開きます。
- 問題を報告する — 任意のエージェントメッセージで「…」→ Feedback。
FAQ
App ビューアーに読み込み画面が表示されるのはなぜですか?
ウェブサイトの読み込み中であり、App ビューアーは正常に動作しています。少しお待ちください。2 分以上かかる場合は、Refresh アイコンをクリックするか、Console パネルでエラーを確認してください。
App ビューアーに赤いエラーメッセージが表示されるのはなぜですか?
エージェントはビルド中に問題に遭遇することがあり、それが原因でウェブページのエラーが発生する場合があります。Resolve をクリックすると、エージェントが修復を行い、修正後はプレビューが通常の状態に戻ります。赤いメッセージは警告であり、深刻な事態ではありません。
公開済みページから Atoms バッジを削除できないのはなぜですか?
バッジの削除には Pro 以上が必要です。右上のアバターをクリックし、Settings を選択してから、Plans & Billing に移動し、Pro または Max プランを選択してください。アップグレード後、公開済みページから Atoms バッジは自動的に削除されます。
Design Mode を使ってページレイアウトやスタイルの問題を修正するにはどうすればよいですか?
- Design Mode を開き、位置ずれしている、またはスタイルが正しくない要素を正確に選択します。
- ページとブレークポイント、現在の問題、望ましい結果、そして変更してはいけない点を明確に伝えます。
- padding、配置、幅、色、折り返し動作など、測定可能な指示を使ってください。見た目を合わせることが重要な場合は、参考画像を添付します。
- 一度に 1 つの変更を適用し、その後デスクトップとモバイルのレイアウトに加え、読み込み中、空状態、hover、エラーなどの重要な状態を確認します。
- 結果として別の箇所が壊れた場合は、最後に正常だったバージョンに戻り、対象をより狭くして再試行します。
App ビューアーに真っ白な画面が表示されるのはなぜですか?
- 問題が App ビューアーのみに影響しているのか、Preview URL にも影響しているのか、公開済みサイトにも影響しているのかを確認します。
- 一度 Refresh し、Preview を新しいタブで開き、Incognito ウィンドウでもテストします。
- 現在のタスクまたはビルドがまだ実行中かどうかを確認します。完了するまで待ってから再試行してください。
- Cloud & AI の残高不足やアプリの停止が明示的なメッセージで表示されている場合は、Settings → Cloud & AI を開いてその残高を確認してください。真っ白な画面だけを理由にチャージしないでください。
- Cookie、トークン、秘密の値を共有しないようにしながら、Console または Network のエラーを記録してください。
画面が真っ白なままの場合は、Chat Link、完全な Viewer URL、時刻とタイムゾーン、影響を受ける環境、スクリーンショット、秘匿情報を除いたエラー詳細を添えてサポートに連絡してください。
Preview または App ビューアーが真っ白な画面を表示したり、読み込みが終わらなかったりするのはなぜですか?
- App ビューアーのみなのか、Preview URL なのか、公開済みサイトなのか、どこに影響しているかを確認します。
- 一度 Refresh し、Preview を新しいタブで開き、Incognito ウィンドウでもテストします。
- 現在のタスクまたはビルドがまだ実行中かどうかを確認し、完了するまで待ちます。
- 最後に正常に動作していたバージョンをテストします。それが動作する場合は、真っ白な画面を引き起こした最近の変更を比較してください。
- 製品側で残高不足またはアプリ停止が明示的に報告された場合にのみ、Settings → Cloud & AI を開いてください。
問題が続く場合は、Chat Link、完全な Viewer URL、バージョン、時刻とタイムゾーン、影響を受ける環境、スクリーンショット、秘匿情報を除いた Console または Network のエラーを添えてサポートに連絡してください。
Design Mode での変更が Preview では正しく見えるのに、公開済みサイトには反映されないのはなぜですか?
Preview と公開済みサイトは独立したチャネルです。保存やプレビューだけでは本番環境に変更は反映されません。
- Publish パネルで Update をクリック — Publish パネルを開いて Update をクリックします。ステータスが Up to date と表示されるまで待ってください。
- ライブサイトをハードリフレッシュ — Cmd+Shift+R(Mac)または Ctrl+F5(Windows)を押すか、Incognito ウィンドウで URL を開いてブラウザキャッシュの影響を除外します。
- 公開済みバージョン番号を確認 — Publish パネルで、バージョンが Preview で見えているものと一致しているか確認します。異なる場合は、再度公開してください。
- プラットフォームの Prod サブドメインをテスト — カスタムドメインを使用している場合は、デフォルトの Prod URL も別途開いてください。Prod サブドメインは更新されているのにカスタムドメインが更新されていない場合、問題は DNS または CDN キャッシュです。
問題が解決しない場合は、Preview URL、Prod URL、比較用の並列スクリーンショット、そして Publish または Update をクリックした時刻を共有してください。
エージェントが変更を加えた後、モバイルでページ表示が崩れるのはなぜですか?
エージェントがレイアウトやスタイルを変更すると、小さい画面でのレスポンシブ動作を意図せず壊してしまうことがあります。
- まずモバイル幅でプレビュー — App ビューアーのツールバーにあるデバイス切り替えを使ってモバイル表示にし、公開前に結果を確認してください。
- モバイル表示で Design Mode を使う — デバイス切り替えをモバイルに設定した状態で Design Mode に切り替えます。崩れている要素をクリックすると、その画面サイズでそのコンポーネントだけを対象にできます。
- 明示的なレスポンシブ制約を伝える — モバイルレイアウトをどうしたいかを正確にエージェントへ伝えてください。例: "画面幅が 768px 未満では、カードを 1 列に積み重ね、padding を 16px にしてください。"
- 既存のメディアクエリを保持するよう依頼する — デスクトップ向けの変更を依頼するときは、"既存のレスポンシブまたはモバイルスタイルは変更しないでください。" を追加してください。
問題が続く場合は、Chat Link、崩れたモバイルレイアウトのスクリーンショット、期待するレイアウトの参考画像を共有してください。
Preview または公開済みサイトで画像が表示されない、または読み込まれないのはなぜですか?
画像が壊れて見える、プレースホルダーアイコンが表示される、または読み込みに失敗する場合:
- 画像ファイルパスを確認 — Files セクションを開き、コード内で参照されているパスに画像ファイルが存在することを確認してください。エージェントが編集中にファイルを移動または名前変更した可能性があります。
- ファイルサイズと形式を確認 — 非常に大きな画像や未対応の形式は読み込みに失敗することがあります。画像を圧縮するか、PNG、JPG、または WebP に変換してください。
- Cloud ストレージを確認 — Settings > Cloud & AI に移動し、利用可能なストレージ容量があることを確認してください。
- ハードリフレッシュ — Cmd+Shift+R(Mac)または Ctrl+F5(Windows)を押して、キャッシュされた画像参照をクリアします。
問題が続く場合は、Chat Link、表示されない画像の URL、壊れた状態のスクリーンショットを共有してください。
エージェントが間違った要素を変更したり、ページの他の部分を壊したりしました。どうすればよいですか?
エージェントが無関係な要素を変更したり、ページの他の部分にリグレッションを発生させたりした場合:
- ロールバック — History に移動し、最後に安定していたバージョンからリミックスします。これによりコードを保持したままチャットコンテキストがリセットされます。
- Design Mode で対象を限定 — Design Mode に切り替え、特定の要素を直接クリックします。これにより、エージェントの編集範囲がそのコンポーネントに固定されます。
- 明示的な制約を追加 — 変更してはいけない内容を明確に伝えてください。例: "ヘッダーの背景色だけを #1A365D に変更してください。ナビゲーションバー、フッター、その他のコンポーネントは変更しないでください。"
- 1 プロンプトにつき 1 変更 — 1 つ変更し、結果を確認してから次に進みます。
エージェントが繰り返し他の要素を壊す場合は、安定版からリミックスし、対象を厳密に絞った指示でやり直してください。
Preview にビルドエラーや依存関係不足が表示されるのはなぜですか?
Preview パネルにビルドエラー、赤いエラーバナー、または不足しているパッケージに関するメッセージが表示される場合:
- Resolve ボタンを使う — App ビューアーに問題の報告通知が表示された場合は、Resolve をクリックすると、AI が特定されたすべてのエラーを自動で分析・修正します。Resolve ボタンが表示されない場合は、Console パネルから正確なエラーメッセージをコピーし、"このビルドエラーを修正してください: [error message]。" としてエージェントに貼り付けてください。
- 最近の変更を確認 — 特定の編集後にエラーが発生した場合は、History に移動し、最後に正常だったバージョンと比較して、どの変更が問題を引き起こしたかを特定します。
- 最後に正常だったバージョンからリミックス — エラーの解決が難しい場合は、最後に成功したチェックポイントからリミックスし、変更を段階的に再適用してください。
- パッケージ互換性を確認 — エラーが特定のパッケージを参照している場合は、エージェントに "[package name] が現在のプロジェクト構成と互換性があるか確認し、バージョン競合があれば修正してください。" と依頼してください。
注: エラーメッセージがプラットフォームコンポーネント(App ビューアー、startup script、Publish、deploy record)やサードパーティパッケージの内部ファイル(例: @vue/compiler-core、vite)を参照している場合、これはエージェントの問題ではなくプラットフォームの問題である可能性があります。完全なエラーメッセージを添えてサポートに連絡してください。
問題が続く場合は、完全なエラーメッセージ、Chat Link、エラーのスクリーンショットを共有してください。
フォント、色、または spacing の変更が反映されないのはなぜですか?
エージェントが変更完了を確認しているのに、見た目が変わっていない場合:
- ハードリフレッシュ — Cmd+Shift+R(Mac)または Ctrl+F5(Windows)を押してください。CSS の変更はブラウザにキャッシュされていることがよくあります。
- CSS の詳細度競合を確認 — エージェントが追加したスタイルが既存ルールに上書きされている可能性があります。エージェントに "依頼したスタイルが別の CSS ルールで上書きされていないか確認し、必要なら詳細度を修正してください。" と依頼してください。
- Design Mode で確認 — Design Mode に切り替えて要素をクリックします。左側のビジュアルエディターには現在適用されている色、spacing、タイポグラフィ、レイアウトプロパティが表示されるため、依頼した変更が適用されているか確認できます。
- 正しいファイルを確認 — グローバルスタイルシートとコンポーネント単位のスタイルの両方があるプロジェクトでは、エージェントが誤ったファイルを編集した可能性があります。"どこに変更を適用しましたか? ファイルパスと行番号を見せてください。" と尋ねてください。
問題が続く場合は、Chat Link、変化していない要素のスクリーンショット、依頼した正確なスタイル値を共有してください。
クリックしたときに Design Mode が間違ったコンポーネントを選択するのはなぜですか?
Design Mode は視覚的なレイアウトを使って対象コンポーネントを判断します。ネストされた要素や重なった要素があると、誤った選択が起こることがあります。
- 拡大する — クリックする前に対象領域を拡大してください。近接してネストされたコンポーネントを区別しやすくなります。
- 補助としてテキストで説明する — 何度クリックしても間違った要素が選ばれる場合は、代わりにチャットで説明してください。例: "右カラムの価格カード内にある 2 番目のボタンを選択してください。"
- ファイルパスで指定する — どのファイルにそのコンポーネントがあるかわかっている場合は、エージェントに直接伝えてください。"src/components/PricingCard.tsx の 42 行目にある要素を編集してください。"
選択の問題が続く場合は、目的の要素を示したスクリーンショットと Chat Link を共有してください。