「Jag PWA installer」を入れたら、App Storeに出さずに済んだ

Jag PWA installer
Webアプリをホーム画面に追加する手順を利用者に案内する、組み込み用の部品
GitHub公式サイト
公開
正式公開 2026-10-20(コードはGitHubで入手可能)
作り手
Jag Project(ジャグプロジェクト合同会社)(会社)
対応
Web
言語
日本語
価格
無料(MIT ライセンス)
アカウント・広告
コードは登録不要・手引きはメール登録

どんなアプリか

Jag PWA installer は、Web アプリやホームページを持つ開発者・制作者が、自分のアプリの中に組み込んで使う案内部品です。利用者がアプリを開くと、そのアプリを「ホーム画面に置く」手順を案内します。利用者が自分のスマートフォンに入れるものではありません。

iPhone では、Web アプリをホーム画面に置かないと通知を受け取れません(iOS 16.4 以降)。この部品が案内するのはホーム画面に追加するところまでで、通知を送る仕組み(Web Push)は開発者・制作者がアプリの側で用意します。

案内はウィザードの形で、利用者は案内の写真と自分の画面を見比べながら自分のペースで進めます。時間で勝手に先へ進むことはありません。iPhone では Safari と Chrome で共有のボタンの位置が違うため、案内は押すボタンを隠さない側に出ます(Safari は画面の上、Chrome は画面の下)。

Android の Chrome では、1回押して追加できるボタンを出せる場合はボタンで、出せない場合は文字の手順で案内します。LINE などのアプリの中のブラウザで開いたときは、Safari や Chrome で開き直す案内を出します。

ホーム画面のアイコンから開かれると、部品がそれを見分けて「設定できました」と伝え、通知の許可の案内に進みます。途中で閉じても、利用者は小さな入口から案内に戻れます。

ある町内会アプリで、実機テストと修正を10回以上繰り返して到達した設計をそのまま部品化した。

Jag Yamamoto さん、GitHub の README

GitHub の README には、iPhone のシミュレータと実機で確かめた事実の表や、うまくいかなかった実装の記録も載っています。

コードより、ここに書いた「実測値」と「失敗の記録」のほうが価値がある。

Jag Yamamoto さん、GitHub の README

料金とデータの置き場所

コードは MIT ライセンスで公開されていて、無料で使え、改変や商用での利用もできます。サポートと動作の保証はありません。部品のコードは登録なしで GitHub から入手できます。

自分のアプリに組み込むための手引き(ウィザード)は、メールアドレスを登録すると開けます。7 つの質問に答えると自分のアプリ向けの依頼文ができ、それをコード AI に渡して組み込みます。無料で使う条件として、Jag Project からのお知らせと手引きについての連絡をメールで受け取ることに同意します。お知らせは止められ、止めたあとも手引きは使えます。

iPhone では Safari とホーム画面のアプリで保存の場所が別のため、ブラウザの側では利用者がもう追加したかを確実には見分けられません。README では、ホーム画面から起動したときにアプリのサーバーへ記録し、ブラウザ側がそれを読む方法を示しています。

これまでの更新

README によると、2026-07-30 から 2026-08-05 にかけて iPhone のシミュレータと iPhone 15 Pro Max の実機で検証され、GitHub のリポジトリは 2026-08-05 に作られました。

2026-08-09 には Android の実機で起きた不具合について、案内を出せるかの判定のしかたを改めた記録が README に書かれています。

2026-10-20 に、ジャグプロジェクト合同会社がオープンソースとして無料で公開したことをプレスリリースで発表しました。

入れる前に

部品は React と TypeScript で書かれていて、中身を変えられる Web アプリとその開発の環境が要ります。ほかに、アプリの URL、ホーム画面のアイコン、案内に使う写真の置き場所、manifest とアイコンの設定、利用者がホーム画面に置いたことを記録する仕組みを用意します。

iPhone のホーム画面に置く操作は、アプリの側から自動ではできず、利用者が自分で操作します。パソコンではスマートフォン向けの案内を出しません。すべての端末とブラウザでの動作は保証されておらず、案内の写真は部品に入っている操作の例で、OS や版によって画面が違います。

よくある質問によると、iOS 16.3 以前の iPhone では Safari からしかホーム画面に追加できません。README では、iOS でホーム画面の Web アプリを QR から直接開くことはできないこと、LINE の中から既定のブラウザへ移す動きは実機で確かめられていないことを、まだ解けていないこととして挙げています。