🚀 Overview

WebApp is a production-ready Android WebView wrapper that turns any responsive website, PWA, or dashboard into a
publishable Android application in minutes. It includes splash screen, file uploads, camera/gallery access, push notifications,
deep links, and offline fallbacks—ideal for SaaS dashboards, blogs, eCommerce, booking systems, and documentation portals.

Experience (E): Built from real client conversions (stores, schools, clinics), this template focuses on smooth navigation,
correct back-button behavior, safe permissions, and Play-Store-compliant features to reduce review rejections.

✨ Key Features

• 🌐 Instant Web-to-App: Point to your site/PWA URL and ship an APK/AAB quickly.
• 🔁 Smart Navigation: Handles in-app links vs. external intents (tel:, mailto:, maps, WhatsApp, etc.).
• 📁 Uploads & Media: File chooser, camera/gallery capture, and download manager support.
• 🔔 Push Notifications: Firebase Cloud Messaging (topic/user) with deep-link routing.
• 📡 Offline Fallback: Detects no-network state and shows a custom offline page with retry.
• 🖼️ Splash & Loader: Branded splash screen and progress indicators with timeout guard.
• 🔒 Security: HTTPS enforcement, mixed-content guard, Safe Browsing, and domain allow-list.
• 📱 PWA Friendly: Respects service worker caches and web manifest when your site is a PWA.
• 🎛️ UI Controls: Optional bottom nav/toolbar, pull-to-refresh, swipe back, and full-screen video.
• 🧭 Back Button Logic: History-aware back navigation with “double-tap to exit” on root.
• 💰 Monetization: AdMob banners/interstitials (optional) and in-app review flow.
• 🌍 i18n/RTL: Locale detection, right-to-left support, and dynamic fonts.

⚙️ Technical Stack (Expertise)

• Language & Framework: Kotlin (AndroidX, Material 3), WebView (androidx.webkit)
• Min/Target SDK: Min 21 (Android 5.0) • Target 34 (Android 14)
• Architecture: Single-Activity + WebView, lifecycle-aware, custom WebViewClient/WebChromeClient
• Notifications: Firebase Cloud Messaging (FCM)
• Downloads: DownloadManager + scoped storage
• Build Tools: Android Studio (Iguana+), Gradle 8+, Play App Signing/AAB
• Server Requirements: HTTPS site (TLS 1.2+); CORS and file-upload endpoints as provided by your web app

🧩 Installation Guide

1. Open the project in Android Studio → let Gradle sync.
2. In app/src/main/res/values/strings.xml, set app_base_url to your website (use HTTPS).
3. Configure options in AppConfig.kt (allow-list domains, file uploads, pull-to-refresh, toolbar).
4. (Optional) Add FCM: place google-services.json, enable notifications/deep links in AndroidManifest.xml.
5. Replace icons/splash in mipmap-* and drawable; update app name & package id.
6. Run on device (Run ▶) → verify login, uploads, external intents, and back navigation.
7. Generate release AAB: Build → Generate Signed Bundle/APK and upload to Google Play.

📦 Deliverables

• ✅ Complete Android Studio project (Kotlin + WebView)
• ✅ Configurable WebViewClient/WebChromeClient with file-upload & download support
• ✅ Offline page, error handlers, splash & loader components
• ✅ FCM push/deep-link templates and AdMob hooks (optional)
• ✅ ProGuard/R8 rules and Play-ready build settings
• ✅ Documentation & GPL v3 license file

📱 Supported Platforms

• Android: 5.0 (API 21) to Android 14+ (phones & tablets)
• Architectures: ARMv7, ARM64, x86_64
• Web App Types: Responsive sites, PWAs, dashboards, blogs, shops, LMS

👨‍💻 Original Developer Credit (Authoritativeness)

This listing credits the original commercial author. Please support them on their marketplace profile:
CodeCanyon – Original Author.

🔒 Disclaimer (Trustworthiness)

Redistributed under the GPL v3 for educational and lawful commercial use. We are not affiliated with Google or the original vendor.
Ensure you own the website you wrap, comply with third-party terms (payments, maps, chat widgets), and remove any demo keys before publishing.
Always enable HTTPS, configure CSP on your site, and test uploads/downloads across Android versions.