Android App Builder Setup Guide
Set up your signing key and private GitHub builder, then turn any HTTPS website into a signed Android APK and Google Play AAB.
Go to App BuilderQuick setup summary
- Create your signing keystore (.jks) and keep the keystore password, key password and alias.
- Convert the .jks to Base64 using the converter on this page.
- Create the private GitHub builder files, including
.github/workflows/build-public.yml. - Add the four GitHub Secrets:
KEYSTORE_BASE64,KEYSTORE_PASSWORD,KEY_PASSWORDandKEY_ALIAS. - Create a fine-grained GitHub token for only the private builder repository with Actions: Read and write, Contents: Read and write and Workflows: Read and write.
- Open the App Builder, enter any HTTPS website and build the app.
That’s it. The builder automatically uses Bubblewrap when it finds a working service worker, otherwise it uses WebView.
1. Create your signing keystore
Create your upload keystore (.jks) using Android Studio or Java keytool. Save these four things safely:
- The
.jksfile - Keystore password
- Key password
- Key alias, such as
Upload
Any HTTPS website can be built
Enter your website and the builder chooses automatically:
- Service worker found: Bubblewrap.
- No service worker: WebView.
Both produce a signed APK and Google Play AAB.
2. Convert your .jks to Base64
🔒
Private and offline: the selected file is processed only inside your browser. It is not uploaded anywhere.
No file selected.
3. Create the private builder repository
Create your private private-android-builder repository. Then choose Create new file and enter this as the file name:
.github/workflows/build-public.ymlLeave the file empty and save it. The App Builder will add the workflow for you when you build.
4. Add the GitHub secrets
Go to Repository Settings → Secrets and variables → Actions and add:
KEYSTORE_BASE64— the Base64 text from this page.KEYSTORE_PASSWORDKEY_PASSWORDKEY_ALIAS
5. Create the fine-grained GitHub token
- GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens.
Open Fine-grained personal access tokens - Set the token to No expiration so you do not have to create it again later.
- Select Only select repositories → your private builder repository.
- Set Actions → Read and write.
- Set Contents → Read and write.
- Set Workflows → Read and write.
- Generate the token and paste it into the App Builder when building. This is the only thing from your GitHub you need to keep safe.
Keep these private
Never publish your .jks, Base64 text, passwords or GitHub token. Keep the builder repository private.