This is a custom build system for creating lightweight Android apps from HTML/JS/CSS projects. It wraps your web content in a native Android WebView and builds a signed APK without using Gradle or Android Studio.
- Minimal Android WebView wrapper
- No need for Java/Kotlin code (template included)
- Uses local HTML, CSS, JS (offline)
- Fully customizable layout and assets
- Generates signed APKs
- Works via simple CLI:
create,compile,clean - Ideal for prototyping or wrapping web UIs as native Android apps
builder/
├── builder.py # Main build script
├── template/
│ ├── assets/ # HTML/CSS/JS template
│ ├── icons/ # Default launcher icons
│ └── src/ # Java source for MainActivity
└── samples/
└── myapp/ # Example project
- Python 3
- Android SDK (build-tools, platform-tools, etc.)
- Java JDK 8+ (tested with JDK 24)
- ADB for installing the app
python3 builder.py create --path samples/myapp --package com.example.myapp This generates a new Android project with the default HTML/JS layout.
python3 builder.py compile --path samples/myapp --run- Compiles Java code
- Converts classes to DEX
- Builds unsigned APK
- Signs the APK
- Installs and runs it on a connected device
python3 builder.py clean --path samples/myappRemoves temporary build files.
- Modify the HTML, CSS, and JavaScript under
assets/ - Java code can be found in
src/com/example/myapp/MainActivity.java - AndroidManifest is auto-generated from project.json
- Final APK is saved as
samples/myapp/myapp.signed.apk
MIT License. Build system by DjokerSoft.