pwa-to-android-app

Package single-file HTML apps as installable PWAs and Android APKs with auto-updates.

5|Updated Jun 13, 2026
One-click install
npx skills add https://github.com/PatriotAi/ai-lab --skill pwa-to-android-app-patriotai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pwa-to-android-app
Source: https://github.com/PatriotAi/ai-lab/tree/main/melania-skills-ecosystem/skills/pwa-to-android-app
Command: npx skills add https://github.com/PatriotAi/ai-lab --skill pwa-to-android-app-patriotai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Turning a web app into something installable on a phone is full of hidden traps: microphones fail on content:// URLs, service workers cannot be inlined into a single file, and there is no Android Studio for Android. This Skill guides you from a single-file HTML app to an installable PWA and a real APK, including cloud builds when no PC is available. ## Core Features & Use Cases - Self-contained packaging: Inline the manifest as a data URI and icons as base64 for one-file distribution, with honest guidance that true offline requires a separate same-origin sw.js. - One-button auto-update: Implement a version.json check with an update banner and a single button that clears caches and reloads. - APK paths for any setup: Choose between Capacitor with a PC, GitHub Actions cloud builds from a phone only, Termux local builds, or PWABuilder/TWA. - Use Case: You built an HTML/JS tool and your microphone does not work when opened via content://. The Skill explains the secure-context requirement, gets you onto Netlify Drop for instant HTTPS, and later sets up a GitHub Actions workflow that builds your APK entirely from your phone. ## Quick Start Ask the assistant to package your HTML file as an installable PWA with auto-updates and explain the path to an Android APK.

Frequently Asked Questions about pwa-to-android-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make a single-file HTML app installable on Android?▼

Inline the manifest as a data URI and icons as base64 so the app ships as one HTML file, then host it on HTTPS such as Netlify Drop. Users open it in Chrome and choose Add to Home Screen to install it as a PWA.

How to build an Android APK without a PC?▼

Use GitHub Actions cloud builds: push your code to a repository from the phone browser and a workflow compiles the APK for download. Termux with JDK and Android SDK is the harder fully local alternative, since Android Studio does not exist for Android.

Why does my microphone not work in my web app on Android?▼

Microphone, camera, and WebGPU require a secure context, meaning HTTPS or localhost. URLs like content:// or file:// are blocked by the browser, so hosting the app on an HTTPS service such as Netlify Drop fixes it.

Can a service worker be inlined into a single HTML file?▼

No. Browsers reject service worker registration from blob: or data: URLs, so true offline caching requires a separate same-origin sw.js file next to the HTML. A single file works but without an offline cache.

What is the difference between TWA, PWABuilder, and Capacitor for APKs?▼

PWABuilder and Bubblewrap wrap a PWA as a Trusted Web Activity, which is the easiest APK path but depends on Chrome. Capacitor gives reliable native API access like camera and files but requires a build step with Android Studio or cloud CI.

How do I add one-button auto-updates to a PWA?▼

Host a version.json file and check it on startup against the embedded APP_VERSION. When a newer version exists, show a banner whose button clears the service worker caches and hard-reloads the page.