How to convert a ZIP file to APK

To convert a ZIP to APK: make sure the ZIP has an index.html at its root (or in a single top folder), use relative paths for every file, upload it in the builder as the HTML or ZIP source, set the app's name and icon, and build. The whole site goes inside the app and works offline.

How the ZIP should look

my-site.zip
├── index.html        ← the start page
├── about.html
├── css/style.css
├── js/app.js
└── images/logo.png

The builder looks for index.html at the top of the ZIP. If everything sits inside one folder (my-site/index.html), it finds that too and unwraps it. Links between pages work as normal: <a href="about.html">.

Relative paths, always

Paths that start with / point at the root of a web server, and inside an app there is no server. Write css/style.css, not /css/style.css. This is the cause of almost every "my ZIP app shows a blank page" problem.

React, Vue, Vite and other frameworks

• Vite: set base: './' in vite.config.js, run npm run build, ZIP the dist folder.
• Create React App: set "homepage": "." in package.json, build, ZIP the build folder.
• Vue CLI: set publicPath: './', build, ZIP dist.
• Routers: use hash routing (/#/page); history-mode routes need a server to rewrite them.

Build it

1. Open the builder, choose HTML or ZIP, and upload the ZIP.
2. Check the preview: the start page should appear on the phone.
3. Set the name, icon, colour, package name and version.
4. Build. A demo APK runs once; Builder Pro builds the full app and the AAB.

Size limits

Up to 18 MB zipped. Compress images (WebP, sensible sizes) and leave out source maps and unused assets to stay well under.