Skip to main content

Main, Beyond and URLs

When looking at the foundations of EVA, we can basically split it up into two categories: Apps on your Apple devices and your web-based Admin Suite. Each category has its own way of handling updates, both of which we will explain on this page.

Both the Apps and Admin Suite (as well as other web-based functionality) run on either the current and stable Main version or on the upcoming Beyond one. Due to the structural difference between both categories however, the way we update them is different as well.

*Although displayed here for the sake of clarity, the first version, Dev, only ever exists internally at New Black. This version is not relevant for you.

Our Main version will be your bread and butter, this is the version you want to run "live" in your stores for the most stable experience. This is also the version you want to use for your Admin Suite when you want the functionality to be as close to the production environment as possible.

Whenever a new version of any of our applications is released, it will be released as a Beyond version. In this context, this means one version 'beyond' your Main version.

Releases on your Apps

Our use of Apps here includes Companion, POS and App Suite.

Let's start off by explaining the use of either version on your Apps and how updating is handled. Let's say we have the following two applications:

  • Main 0.1
  • Beyond 0.2

Now, when we release application version 0.3, the Beyond application is automatically bumped to 0.3, bumping Main up from 0.1 to 0.2, and essentially deprecating 0.1. You will be notified of this in your MDM.

Following this logic, you won't ever be more than two versions behind.


In practice you can have 2 applications: Beyond (latest) and Main (second-latest). We advise using the first in a limited number of stores.

When you decide to use our Beyond version in your Apps, make sure to also have Main installed. This will allow you to easily switch back if necessary.

Example store setup

  • Regular stores run on Main versions
  • A set of dedicated 'pilot' stores run on Beyond versions with the possibility of falling back on Main.
Postponing updates

You can configure each App to be either updated automatically or manually, but if you set it to update automatically, there is no such thing as delaying updates. You cannot run behind on versions. You could however create multiple groups to have varying (unsupported) configurations.

Releases on Admin Suite

We mention Admin Suite, but the Return Portal, Digital Giftcard App and Admin 1.0 share the same proces.

All web-based EVA applications can run on either the Main or Beyond version at any time, simply by changing its URL structure. These applications share the same release cycle as the mentioned Apps, but due to them being web-based, there is no need for you to download or configure anything to handle the new releases.

URL structure

Use the following URLs to set up your Admin Suite environments in their various stages.

Admin Suite front end - MainAdmin Suite front end - Beyond
URLs you shouldn't use

Internally we use release-- URLs for regression-testing versions upcoming to your Beyond version. These versions are available only during the regression week and although technically open to you, we advise to stick to the versions above.

The same goes for dev URLs. These can change multiple times on daily basis; these are best left to the the actual devs.