Skip to content
Android Wrapper to create native Android Apps from offline-capable Progressive Web Apps
Branch: master
Clone or download
Latest commit f1bddca May 15, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea targetSdkVersion 28 May 15, 2019
app #11 fixed webview frozen when clicking external links May 15, 2019
gradle/wrapper Android Studio 3.4 May 15, 2019
.gitignore updated gitignore May 15, 2019
LICENSE Initial commit Oct 4, 2017 updated README May 15, 2019
build.gradle Android Studio 3.4 May 15, 2019 added app Oct 4, 2017
gradlew added app Oct 4, 2017
gradlew.bat added app Oct 4, 2017
settings.gradle added app Oct 4, 2017


An Android Wrapper application to create native Android Apps from an offline-capable Progressive Web App.

Drafted for the Android App of my Leasing Calculator Web App using React, Redux, Materialize.css and a lot of Offline-First love over at

Looking for iOS or Desktop?

Check out my other projects:

Why would I use a wrapper?

I know, using a Wrapper-App to display a Website can feel a bit odd. But there are a few good reasons why you'd package your Web App like this.

  • If you've got a very sophisticated UI already, it might make sense not to rebuild it from scratch for multiple platforms, especally if it's a Single Page Application already, that doesn't "feel" like a Website.
  • There might be as well less competition for a given niche on App Stores, in comparison to Google directly. With, I've got easily into the Top 10 Apps on Google Play for my country, whereas Google Search put me on page 9 as the Site is relatively new.

What it does

  • Sets up a WebView just the way PWAs/SPAs like it (e.g. enables App cache and DOM storage, ...).
  • Shows a loading spinner while fetching the Web App.
  • Provided your Web App is Offline-capable, it only needs an Internet connection on the first startup. If this fails, it shows a native refresh widget.
  • Opens all external URLs in the device's Browser instead.
  • Checks for Internet connection and fetches Updates for your Web App accordingly.
  • Is compatible down to JellyBean, although it's recommended to build for SDK Version >= 19 (KitKat). Building for SDK Version >= 21 (Lollipop) puts you on the safe side without having to worry too much about Browser support.
  • APK-size < 1.4 MB. The latest cat video from WhatsApp weighs heavier ;)

How to build your own

  • Get Android Studio 3.4+
  • Clone/fork repository
  • Put your Web App's URL in WEBAPP_URL in
  • Replace app_name in strings.xml with the name of your App
  • Add your own primary colors to colors.xml (colorPrimary, colorPrimaryDark, colorPrimaryLight)
  • Put your own icons in place:
    • Add your own ic_launcher.png and ic_launcher_round.png in the mipmap folders
    • Add your own ic_appbar.png in the drawables folders. This is displayed in Android's Recent Apps View on your app bar, so it should look nicely when placed on top of your primary color.
    • I recommend using Android Asset Studio to get the icons ready in no time
  • Change the package name in app/build.gradle, applicationId
  • Change AndroidManifest.xml -> aplication -> activity -> intent-filter to your own URLs/schemes/patterns/etc. or remove the intent-filter for android.intent.action.VIEW altogether
  • Check for more options
  • Build App in Android Studio

I don't accept Feature Requests, only Pull Requests :)


GNU General Public License v3.0 - if you use it, we wanna see it! Other licensing options are available on inquiry.

You can’t perform that action at this time.