Publishly

In-app

How to show update prompts and What's new inside your Android app

Publishly gets your app into the store; Publishly Kit, a free Android library, keeps it alive after install. It adds in-app updates, a review prompt that asks first, a More apps screen, a What's new screen and open source licences, in Compose and in Views. This page writes the files it reads from what Publishly already knows about your app.

Step by step

  1. See whether your build has it

    Check your APK or AAB in Check app first. The In-app page then says whether Publishly Kit is in the last build you checked; the check finds it by its classes and by the screens it adds to your manifest.

  2. Add the library

    Under Add it, copy the two blocks: JitPack in settings.gradle.kts, and the kit dependency (plus kit-compose for a Compose app) in your app module. Read the README has a quick start for each kind of app.

  3. Fill in your in-app files

    Your in-app files starts from the current app: its package, version name and version code from the build, its short description and release notes from Listing. Change any field and the files change with it.

  4. Copy or download each file

    Each file has Copy and Download. update.json goes on your server for the update check, release-notes.json at the top of your What's new list, and apps-entry.json into the More apps list your other apps read.

  5. Or take them with the release

    Export all in the screenshot editor and Download everything on the release checklist put the same files in the zip's extras folder, with README_in-app.txt saying where each one goes.

What each file needs

  • update.json: a version name, a version code and a store link (made from the package when there's no other).
  • release-notes.json: a version name and release notes; with the version code, the dialog after an update shows exactly the versions a user skipped.
  • apps-entry.json: a package name and an app name. Add an icon link yourself: the library can't show a picture from inside a zip.

fastlane

When the version code is known, the Listing tool's fastlane download names the release notes changelogs/<versionCode>.txt, the file supply uploads for that build, instead of default.txt.

Questions

Does Publishly Kit collect anything?

No. It has no ad SDK and no analytics; the update and What's new files come from your own server, or from the app itself.

Does it need Google Play?

No. Play's own update flow is used when the app came from Play, and update.json works for side loads and other stores.

Is anything uploaded to make the files?

No. They're written in this browser from what the other tools saved here.

Other guides

Last checked against the app on 2026-10-20.