Installing and updating

Installing it the first time

There is nothing inside SaleSprint that installs SaleSprint. No download screen, no QR code, no “send this to another device”. Getting it onto a new till or phone always starts outside the app.

Go to the Downloads page on the SaleSprint website. It lists the current build for Windows, macOS, Linux, Android and iPhone, with the file size and a checksum for each.

There is no card for the web version, because there is nothing to install — the web app is just an address you open in a browser.

On Android and iPhone you may instead be sent to the Play Store or App Store listing.

How updates reach you

Once you are signed in, SaleSprint checks for a new version when the app starts and each time you bring it back to the foreground, at most once every fifteen minutes. There is no background check — the app has to be open.

You will meet an update in one of three ways.

A banner at the top of the page

For an ordinary update, a blue bar appears above whatever you are working on:

Update available — Version 1.4.0 is ready to install.

with an Update button and a ✕.

Update starts the installation. ✕ hides the banner — and it stays hidden for good. It will not come back for that version, on any device restart. Only a newer version brings it back.

If you dismiss one and change your mind, go to Settings → Updates and press Update now there.

A full screen you cannot get past

Some updates are required. Instead of a banner you get a screen reading:

Update required — A required update is available. Please update to keep using SaleSprint.

with an Update now button, the release notes under What’s new if there are any, and your Current version at the bottom.

There is no way past this screen

No Later, no Skip, no Close, and the device’s Back button is switched off. Every page in the app is replaced by it, including Settings. Until the update is installed, the shop cannot sell on that device.

The only things still working are the top bar and the menu drawer, so you can sign out — which does not help you sell.

If the update itself will not start (see below), the device is stuck. Have a way to reach whoever supports your installation before this happens, not after.

Checking yourself

1. Go to Settings → Updates.
2. The first row shows Current version, your version number, and a status — You’re on the latest version, Update available, Update required, Checking… or Couldn’t check for updates.
3. A badge on the right reads Up to date, Available or Offline.
4. At the bottom, Last checked with the date and time, and a Check for updates button.
5. If there is an update, an Update now button appears above.

Pressing Check for updates tells you “You’re up to date” or “Couldn’t check for updates”. If it finds something, it says nothing at all — the panel just changes.

Anyone can do this

The Updates panel has no permission on it. A cashier can start an update on the till they are working at.

What pressing Update actually does

It depends on the device, and not all of them install by themselves.

Device	What happens
Web	The page reloads onto the new version. Nothing to install.
Android from the Play Store	Installs in place, without leaving the app.
iPhone	Takes you to the App Store. You have to tap Update there yourself.
Windows	The Windows App Installer opens and installs it.
macOS	An updater panel appears, downloads and restarts the app.
Linux	No automatic path. A file downloads in your browser and you install it by hand.
Android installed from a file	Same — the installer file downloads and you run it yourself.

When something goes wrong

“Couldn’t open the update. Try again shortly.” — the app could not start the install. Usually the download address is missing or wrong, or the device has no handler for it. Trying again rarely helps; install manually from the Downloads page instead.

“Couldn’t check for updates” / the Offline badge — the app could not reach the server. Normally just a connection problem.

A failed automatic check pretends everything is fine

This is worth knowing. Only a check you start yourself ever reports a problem. The automatic ones on launch and resume fail silently and report that you are up to date.

So a device that cannot reach the server — wrong address, blocked network — will say “You’re on the latest version” forever and never update. If a till seems to be stuck on an old version, open Settings → Updates and press Check for updates; that is the only thing that tells you the truth.

Last checked is also stamped even when the check failed, so a recent timestamp does not mean it worked.

Two version numbers that look identical

The banner shows only the first three parts of a version. When the change is in the part that is not shown, the banner says “Version 1.4.0 is ready to install” while Settings says you are on 1.4.0. It is not a mistake — they really are different builds.

The Settings badge says “Available” for a required update

It turns red, but the word stays Available. The status line beside it is the accurate one: Update required.

For whoever runs your SaleSprint

One wrong entry locks out every device on that platform

Whether an update is required is decided by a minimum-version floor set per platform and channel, published centrally. It applies to everyone at once, and there is no staged rollout — a percentage can be recorded but nothing acts on it.

Set that floor wrong and every Windows till in every branch hits the blocking screen at the same moment. Publish the release and confirm it installs before raising the floor.

If a release is switched off, or the server has a problem answering, every device is told it is up to date rather than shown an error. That is deliberate — it keeps shops selling — but it means silence is not proof that updates are working.

Related

• Signing in
• Working offline