Skip to content

mrepol742/web-appp

Repository files navigation

Build your web app for Android faster with this base template.

Your Web-to-APK Base Template

Web-Appp is a ready-to-use Android template designed to help developers quickly convert a website into a fully functional APK, while adding mobile-specific features and customizations.

  • Free & MIT Licensed

  • WebView Metrics Opt-Out Enabled

  • Custom Error Pages

  • External Links Open in Chrome Custom Tabs

  • Supports Special URL Schemes

  • Automatic Footer Hiding

  • Built-in Analytics (Optional)

  • Google GCM / Push Notifications (Planned)

    and more

  • Easy theming with Material 3 design support for a modern Android look.

  • Fullscreen video support inside WebView.

  • File download handling for PDFs, images, or other assets directly from your web content.

  • Intent handling & dynamic shortcuts for deep links, so users can launch specific pages directly.

  • Back navigation management using Compose BackHandler for seamless navigation.

  • Modern Android setup using the latest Gradle tooling.

  • Kotlin-based for flexibility, maintainability, and seamless integration with Jetpack Compose.

  • Modular and easy to extend — all features can be enabled or disabled as needed. (Planned)

Prerequisites

  • Android Studio Narwhal 3 or newer

Installation

  1. Clone the repository

    git clone https://github.com/mrepol742/web-appp
  2. Open the Project in Android Studio

  3. Sync Gradle dependencies

  4. Run the app on an emulator or device 🚀


GitHub Secrets

Before running the workflow, set up the following repository secrets else itll fallback to build debug:

Secret Name Description
SIGNING_KEYSTORE Base64-encoded contents of your keystore.jks file.
STORE_PASSWORD The password for your keystore.
KEY_ALIAS The alias name used for the signing key.
KEY_PASSWORD The password for your key alias.
RELEASED_REPO_TOKEN GitHub Personal Access Token (PAT) with write permissions to the released repository (used for pushing the signed APK).

Base64 Keystore

If you already have a keystore.jks file, you must convert it into a Base64 string before storing it as a GitHub secret.

Run the following command:

base64 keystore.jks > keystore.txt

License

Web-Appp is licensed under the MIT License.

About

Build your web app for Android faster with this base template.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published