A service that converts web URLs into Android applications using GitHub Actions automation. This project allows you to quickly create a WebView-based Android app from any web URL with a custom package name
Work in progress
Frontend is hosted in: https://prudhvir3ddy.github.io/wtm
- Convert any website into an Android app
- Customize package name
- Automated build process via GitHub Actions
- REST API for app generation
Prerequisites
- Docker (recommended) or JDK 17+
- Kotlin 1.8+
Environment Variables
GITHUB_TOKEN=your_github_personal_access_token
APP_SECRET=your_app_secretRunning Locally
Using Docker
- Build the Docker image:
docker build -t wtm-backend .
- Run the container:
docker run -p 8080:8080 --env-file .env wtm-backend
Without Docker
Set environment variables:
export GITHUB_TOKEN=your_github_personal_access_token
export APP_SECRET=your_app_secret
Run the application:
./gradlew run
Generate Android App
Endpoint: POST /generate
Request Body:
{
"url": "https://example.com",
"package_name": "com.example.app",
"secret": "your_app_secret"
}Response:
- 200 OK: App generation started successfully
- 401 Unauthorized: Invalid secret
- 417 Expectation Failed: GitHub API error
- The API receives a request with a URL and package name
- It triggers a GitHub repository dispatch event
- GitHub Actions workflow clones the Android template project
- The workflow customizes the template with your URL and package name
- The app is built and made available as a downloadable APK
The API allows requests from:
- localhost (any port, HTTP)
- prudhvir3ddy.github.io (HTTPS)
- Authentication is handled via an app secret
- GitHub token is stored as an environment variable
- No sensitive information is stored in the codebase
MIT