urltoapp.dev
Learn

Updating a URL app: when you need a rebuild

The best thing about URL apps is that most updates skip the app store entirely. Here's the exact line between “just edit the site” and “ship a new version”.

Updated Oct 20262 min readurltoapp.dev

Short answer

Anything served by your website — pages, prices, design, menus, new features written in HTML, CSS and JavaScript — updates in the app the next time it loads, with no rebuild and no store review. You need a new build (same package name and key, higher version code) only to change the app itself: name, icon, splash, start URL, link scope, permissions, push or other native features, and the yearly target API level.

The line, in one table

ChangeRebuild?
Text, images, products, postsNo
Site design, menus, new pagesNo
New web features (forms, chat, maps)No — unless they need a new permission
App name, icon, splash, theme colourYes
Start URL or in-app domainsYes
Camera, location, notification permissionsYes
Push SDK, App Links hostsYes
Google Play's target API deadlineYes, about once a year

How to ship a new version

  1. Build with the same package name and same signing key (or upload key for Play).
  2. Raise versionCode (a whole number Android compares) and set a readable versionName like 1.1.
  3. Upload the AAB to Play; users get it through normal updates. Sideloaded users install the new APK over the old one.

Caching can make “instant” look slow

The WebView caches like a browser. If users still see old CSS after a deploy, version your asset URLs (style.css?v=42) or send sensible cache headers. Pull-to-refresh helps users, but don't rely on it.

Feature-flag the app

Because your site can detect the app (app mode snippet), you can ship app-only tweaks — a different footer, a bigger tap target, hidden banners — on your website, instantly, without touching the app.

FAQ

Do users need to update the app when I change my website?

No. They see changes the next time a page loads.

What if I lost the signing key?

Without it you can't update a sideloaded app. On Play with Play App Signing, you can ask Google to reset the upload key.

Read next