WP Manifestindependent plugin directory
manifest / utilities / pwa-install-button

PWA Install Button

A lightweight WordPress plugin that provides a customizable "Install App" button for your Progressive Web App (PWA). It includes a built-in browser fallback for platforms that do not support the native beforeinstallprompt event (like iOS Safari).

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/teethyorg/pwa-install-button/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

PWA Install Button for WordPress

A lightweight, zero-configuration WordPress plugin that adds a professional Install App button to your site. It bridges the gap between different browsers by triggering native prompts where supported and providing smart manual instructions for iOS and Safari users.

🔗 Live Demo: teethy.org

🚀 Features

  • Native Prompts: Uses the beforeinstallprompt API for a seamless experience on Chrome, Edge, and Android.
  • Smart Fallback: Automatically detects iOS/Safari and provides step-by-step instructions for manual installation.
  • Simple Shortcode: Place the button anywhere with [pwa_install_button].
  • Highly Styleable: Clean CSS classes for easy branding overrides.

🛠 Installation

  1. Download the repository as a ZIP.
  2. Upload to your WordPress site via Plugins > Add New > Upload Plugin.
  3. Activate the plugin.
  4. (Required) Ensure your site has a valid manifest.json and a registered Service Worker.

📖 Usage

Standard Button

Simply add this to any post or page: [pwa_install_button]

Custom Label

Change the button text directly in the shortcode: [pwa_install_button button_text="Download App"]

📁 Project Structure

  • pwa-install-button.php: Core plugin logic and shortcode registration.
  • pwa-install-button.js: JavaScript for handling installation events and fallbacks.

📄 License

Distributed under the GPL2 License. See LICENSE for more information.


Built with ❤️ by teethy