WebDroid – Android WebView App

✨ Key Features

• Full-screen WebView integration: Load your website URL, handle navigation, SSL errors, and custom back logic.
• Download & file handler: Handle downloads, save files, open PDF/image with external apps.
• Push notifications: Built-in support for Firebase Cloud Messaging (FCM) integration.
• AdMob ready: Banner and interstitial ad slots integrated for monetization.
• Deep link support: Open specific URLs via intent and route to native/URL inside the WebView.
• Offline fallback page: Display a custom offline message when no internet is available.
• Branding customizable: App name, icons, splash screen, theme colours and fonts are easily changeable.
• Hardware back & share: Override Android back button to navigate WebView history; built-in share sheet for current page.
• Multi-scale & responsive: Ensures your responsive website is optimized for phones & tablets.
• GDPR & consent dialog: Optional consent for EEA users before loading ads or tracking.

⚙️ Technical Stack

• Language: Kotlin (or optionally Java) using AndroidX libraries.
• Minimum SDK: Android 6.0 (API 23)+, targeting latest Android version and 64-bit compliance.
• WebView engine: Android System WebView / Chromium WebView with custom WebChromeClient & WebViewClient.
• Push & Ads SDKs: Firebase Cloud Messaging, Google Mobile Ads (AdMob).
• Permissions: Internet, network state, storage (optional for downloads), notifications.
• Build tools: Gradle (AGP 8+), Android Studio Giraffe/Latest; ProGuard/R8 for release builds.

🧩 Installation Guide

1. Open the project: Import the Android Studio project and sync Gradle.
2. Configure your URL: In Config.kt (or equivalent), set your BASE_URL to load in the WebView.
3. Branding: Replace app name, launcher icons, adaptive icons, splash screen, theme colours.
4. Setup FCM: Add google-services.json, configure FCM in Firebase console, update configuration.
5. AdMob: Replace test ad unit IDs with your production IDs in AdsConfig.kt.
6. Test: Run app on device; verify URL loads, back button works, downloads trigger, notifications arrive.
7. Release: Enable signing config, ProGuard rules, build AAB and upload to Play Store. Fill out Data Safety and Ad disclosure forms.

📦 Deliverables

• Complete Android Studio project source code.
• Config file for URL, theme, icons, splash screen.
• AdMob & FCM integration modules.
• Download handler and offline fallback HTML page.
• Documentation: quick start, customisation, and publishing guide.
• GPL license file & redistribution notice.

📱 Supported Platforms

• Android: Phones & tablets (API 23+).
• Responsive websites: Works with any responsive web content — blogs, news sites, e-commerce sites, PWA sites.

🧠 Notes & Licensing

• License: Distributed under the GPL for learning, auditing and derivative development.
• Customization tips: Use remote config JSON to toggle home banners, ad frequency, or enable native screens for login/ads; implement WebView extension for file uploads/forms if your site uses them.
• Performance: Ensure your website is mobile-optimized and responsive; if heavy, consider implementing splash delay and pre-loader; enable caching of key resources via service-worker or WebView caching.
• Compliance: Add privacy policy page in the WebView or native screen; integrate consent if you show personalised ads; ensure you own license for any content you wrap.
• ASO/SEO: Use keywords like “website to app Android”, “WebView native app”, “blog news app Android”, localize store listing, provide screenshots of app loading website content, show native features (offline, push, download).

👨‍💻 Original Developer Credit

This WebView app template was developed by [Vendor Name] and listed on marketplaces such as
CodeCanyon.
If you intend commercial distribution or extended support, please consider purchasing the official licence from the original author.

🔒 Disclaimer

This source code is provided under the GPL license for education and review purposes.
Third-party services (e.g., FCM, AdMob) require your own API keys/accounts.
You are responsible for legal compliance including content rights, trademark use, and store policies.
All demo content/reference code copyrights remain with their owners.
No demo download links are included.