# HausaNovels Web To APK
GitHub-ready Android WebView APK project for `
hausanovels.ng`.
## What is included
- Native Android WebView wrapper.
- GitHub Actions APK build workflow.
- PNG app icon resources.
- Splash screen with only the icon on the splash background.
- Camera cutout and notch safe-area padding.
- Back button support.
- File picker support for upload fields.
- Paystack checkout hosts allowed inside the WebView.
- External links open in the user's browser or related app.
## Main settings
Change these when needed:
`app/src/main/res/values/strings.xml`
```xml
HausaNovels
hausanovels.ng
```
Package name:
`app/build.gradle`
```gradle
applicationId "ng.hausanovels.app"
```
If you change the package name, also change the Java folder and the first line in:
`app/src/main/java/ng/hausanovels/app/MainActivity.java`
## Splash screen
The splash screen is handled in:
- `app/src/main/res/drawable/splash_screen.xml`
- `app/src/main/res/drawable/splash_icon.png`
- `app/src/main/res/values/colors.xml`
- `app/src/main/res/values-v31/styles.xml`
The splash background is:
```xml
#050816
```
Only the PNG icon is centered on the splash screen.
## Camera cutout and safe area
The app avoids the top camera cutout by applying Android window insets in:
`app/src/main/java/ng/hausanovels/app/MainActivity.java`
It pads the WebView away from:
- status bar
- navigation bar
- display cutout
- camera notch/hole area
The WordPress theme already has:
```html
viewport-fit=cover
```
So the Android shell and the website are both prepared for safe-area handling.
## Build APK With GitHub
1. Create a new GitHub repository.
2. Upload all files from this folder to the repository root.
3. Go to the repository on GitHub.
4. Open **Actions**.
5. Run **Build APK**.
6. Download the artifact named `hausanovels-apks`.
The debug APK is easiest for direct phone testing:
`app-debug.apk`
The release APK created by this workflow is unsigned. For Play Store upl …