PWA導入ガイド
—— ホーム画面に追加するだけで、アプリになる

1. PWAとは何か

PWA（Progressive Web App）とは、Webサイトでありながらネイティブアプリのように動作する技術だ。App StoreやGoogle Playを経由せず、ブラウザから直接インストールできる。

TokiQRはこのPWA技術を採用している。一度ホーム画面に追加すれば、ブラウザのアドレスバーは消え、アプリと同じ見た目で起動する。オフラインでも動作し、アップデートはWebページを更新するだけで自動的に反映される。

アプリストアの審査も、登録料も、年間維持費もない。この仕組みが、ランニングコストゼロで1000年持続する設計を支えている。

ブラウザで開けるなら、
それはすでにアプリだ。

2. Android（Chrome）での導入手順

Androidスマートフォンでは、Google Chromeを使ってTokiQRをホーム画面に追加できる。所要時間は約30秒。

次回からは、ホーム画面のアイコンをタップするだけで起動する。ブラウザのアドレスバーは表示されず、フルスクリーンのアプリとして動作する。

Chromeが自動で促すケース

TokiQRのページを何度か訪問すると、Chromeが画面下部に「ホーム画面にTokiQRを追加」というバナーを自動的に表示することがある。このバナーが表示された場合は、タップするだけでインストールが完了する。

3. iPhone / iPad（Safari）での導入手順

iPhoneやiPadでは、Safari（標準ブラウザ）を使う。ChromeやFirefoxではPWAのインストールができないため、必ずSafariで操作する必要がある。

Safariでしかインストールできない点だけ注意が必要だ。これはAppleの仕様による制約であり、TokiQR側の問題ではない。

iPadの場合

iPadでは、共有ボタンの位置がiPhoneと異なる場合がある。Safari画面上部のアドレスバー付近にある共有ボタン（□に↑）をタップすれば、同じ手順でインストールできる。

4. デスクトップ（Chrome / Edge）での導入手順

パソコンでもPWAとしてインストールできる。Google ChromeまたはMicrosoft Edgeを使用する。

インストール後は、デスクトップのショートカットやタスクバーから直接起動できる。ブラウザとは独立したウィンドウで動作し、タブやアドレスバーは表示されない。

Chromeでインストールアイコンが表示されない場合

アドレスバーの右端にインストールアイコンが見当たらない場合は、Chromeのメニュー（︙）から「TokiQRをインストール」または「その他のツール → ショートカットを作成」を選択する。

5. インストール後にできること

PWAとしてインストールしたTokiQRは、次の特徴を持つ。

• オフライン動作 — 一度読み込んだページは、インターネット接続がなくても動作する。Service Workerがコンテンツをキャッシュしているためだ。
• フルスクリーン表示 — ブラウザのアドレスバーやツールバーが消え、画面全体をアプリが使う。没入感のある体験になる。
• ホーム画面からの起動 — 他のアプリと同様に、アイコンをタップするだけで起動する。ブラウザを開いてURLを入力する必要はない。
• 自動アップデート — TokiQRが更新されると、次回起動時に自動的に最新版が読み込まれる。アプリストアでの手動アップデートは不要だ。

インストールしたのは「アプリ」ではない。
ブラウザの枠を外した、Webそのものだ。

6. アプリストアが不要な理由

「なぜApp StoreやGoogle Playに出さないのか？」——この疑問には、明確な設計思想がある。

Apple App Storeへの登録は年間$99。Google Playは$25の一時金。金額の問題ではない。毎年支払い続けなければ存在し続けられないという構造が、1000年持続するプロジェクトの設計思想と相容れないのだ。

PWAなら、GitHub Pagesにデプロイするだけで全プラットフォームに配信される。審査もなく、登録料もなく、維持費もゼロだ。詳しくは「アプリストアに出さない理由」で論じている。

TokiQRの入口はアプリストアではなく、QRコードそのものだ。墓石に刻まれたQRコード、記念碑のQRコード——そこから直接Webにアクセスする。ストアフロントを介する必要がない配布モデルだからこそ、PWAが最適解になる。

7. よくある質問

ストレージ容量はどれくらい使いますか？

TokiQRのPWAは非常に軽量だ。インストールに必要な容量は数MB程度で、ネイティブアプリの100分の1以下。ストレージ不足を心配する必要はない。

アンインストール（削除）するには？

Android：ホーム画面のアイコンを長押しし、「アンインストール」または「削除」を選択する。
iPhone / iPad：ホーム画面のアイコンを長押しし、「ブックマークを削除」をタップする。
デスクトップ：アプリのウィンドウ上部のメニュー（︙）から「アンインストール」を選択する。

アップデートは必要ですか？

手動でのアップデートは不要だ。TokiQRを起動するたびに、Service Workerがバックグラウンドで最新版をチェックし、自動的に更新する。常に最新の状態で使える。

通知は届きますか？

TokiQRはプッシュ通知を使用していない。QRコードの生成と再生に特化した設計であり、通知機能は意図的に省いている。静かなアプリであることも、設計思想の一部だ。

複数のデバイスにインストールできますか？

制限はない。スマートフォン、タブレット、パソコン——すべてのデバイスに同時にインストールできる。アカウント登録もライセンスも不要だ。ただし、デバイス間でデータが自動的に同期されることはない。各デバイスのデータはそのデバイス内にのみ保存される。