HANDOFF: Z Fold 7 への PWA インストール手順書（Phase 5）¶
Code Claude → 工藤さん 作成日：2026-05-28 前提：Phase 3（Cloudflare Access）完了後に実施 所要時間：2 分
ゴール¶
Z Fold 7 のホーム画面に「KUDO Workspace」のアイコンを置き、 アイコンタップで（ブラウザのアドレスバーやタブなしで）アプリのように起動できる状態にする。
前提¶
- ✅
https://kudo-workspace.pages.dev/が動いている - ✅ Cloudflare Access で Z Fold 7 でも一度ログイン済み（PIN かGoogle ログイン完了）
- ✅ manifest.webmanifest と PWA 用アイコンを配置済み（Code 側完了）
手順¶
1. Chrome で URL を開く¶
- Z Fold 7 で Chrome を起動
- アドレスバーに
https://kudo-workspace.pages.dev/を入力 → 開く - Cloudflare Access のログイン画面が出たら One-time PIN（または Google）で認証
- KUDO Workspace のトップページが表示されることを確認
2. ホーム画面に追加¶
- 右上の「︙」（縦三点）メニューをタップ
- 「ホーム画面に追加」または「アプリをインストール」をタップ
- Z Fold 7 / 最新 Chrome では「アプリをインストール」が出るはず（PWA として認識される）
- 出なければ「ホーム画面に追加」でも OK（簡易ショートカット）
- ダイアログで「KUDO Workspace」の名前を確認 → 「インストール」/「追加」
- ホーム画面に「KW」（白文字＋インディゴ背景）アイコンが追加される
3. 起動確認¶
- ホーム画面の「KW」アイコンをタップ
- 起動アニメーション後、アドレスバー / タブなしでフルスクリーンで開けば PWA 成功
- ブラウザの戻る / タブ切替が見えない ＝ スタンドアロンアプリ化成功
- もし通常のブラウザタブで開いたら、「アプリをインストール」ではなく「ホーム画面に追加」（簡易ショートカット）として動作している → 機能的には問題なし
4. 折りたたみ画面での確認¶
Z Fold 7 ならではの確認：
- 外画面（折りたたみ時）：縦長 → サイドバーが自動折りたたみされ、ハンバーガーメニュー表示
- 内画面（開いた時）：横長大画面 → 左サイドバー＋中央コンテンツ＋右TOC の3カラム表示
- 折りたたみ↔開く で自動リサイズされるか
- 検索 UI が両画面で使えるか
トラブル時¶
| 現象 | 対処 |
|---|---|
| 「アプリをインストール」が出ない | Chrome のキャッシュクリア → 再アクセス。manifest.webmanifest が読めていないかも。Console（chrome://inspect）で確認 |
| アイコンが汎用アイコン（地球マーク）になる | manifest の icons パスが間違い・キャッシュクリアで再取得 |
| 開いたら何度もログイン要求 | Cloudflare Access の Session Duration を 24h 以上に設定 |
| 文字が小さい | Chrome のフォントサイズ設定で大きく / OS の表示サイズ拡大 |
| 検索が日本語で効かない | search.lang に ja が含まれているか mkdocs.yml で確認（Code 側）✅済み |
アンインストール（不要になった時）¶
- ホーム画面の「KW」アイコンを長押し
- 「アンインストール」または「削除」
- Chrome のサイト設定からも削除（Chrome 設定 → サイトの設定 → kudo-workspace.pages.dev）
完了確認¶
工藤さんが Z Fold 7 ホーム画面から「KW」アイコンをタップして KUDO Workspace が起動できれば Phase 5 完了。Phase 6（kudo-shared-storage-protocol への永続化）は Code 側で進めます。