Managing Apps

Adding an App

To add a new App to the console click the primary action button while viewing a client.

Client Dashboard

Fill in the name of the App, and optionally, add a brief description or upload an icon. Click "Save".

Create an App

You will now be redirected to the dashboard for that app.


Editing an App

From the Client dashboard, use the context action on the App card you wish to edit, select "Edit"

Context menu

Edit option

Make any edits you wish, then click "Save" to return to the Client dashboard.


Deleting an App

To delete an App, from the Client dashboard use the context action on the App card you wish to delete, select "Delete"

Edit option

You will be prompted to confirm the deletion.

Client Card Menu

After deletion the App will be removed from the console.

Moving an App to another Client

To move an App to another Client, simply edit the App and select a new Client from the dropdown, click "Save" to confirm.

Moving an App


The App Dashboard

The App Dashboard shows the status of the features that have been enabled for that app as well as the API Keys required to authenticate that app. You can also access the files and links for that app.

App Dashboard

The App Dashboard will also alert you to any warning or critical problems that require your attention such as an expired APNS certificate or a new crash that has been reported.

Alerts

The following problems will raise an amber warning or a red critical alert.

Feature Alert Reason
Push Warning APNS Certificate expires in under two weeks.
Push Critical APNS Certificate has expired.
You cannot send push notifications to your iOS App!
Build Warning Latency to backend database is over 2 seconds (Hookup).
Build Critical Unable to connect to backend database (Hookup).
The app cannot download new content and data!
Crash Warning One or more issues remain in an open state.
Crash Critical One or more issues remain in the new state
A new crash has occurred and requires urgent investigation!

Enabling features for Apps

Starting a 30 day free trial

Kumulos features are free to use on up to 25 test devices for up to 30 days while your app is in development. To trial a feature for an app, click the Start button on the app dashboard next to the required feature.

Select Start

You will now see some more information about that feature.

Get Started

If you wish to continue click Get Started or Enable. You will be asked to confirm that you wish to begin a 30 day free trial.

Confirm start trial

Click Yes, proceed when prompted. The setup process for that feature will now start. For further details, refer to the documentation for that feature. For example Analytics.

Adding features to your subscription

When trialling features, the app dashboard will show you how many days of your trial you have left.

Trial expires

To add a feature to your subscription, click Buy. You will be asked to confirm that you wish to add the feature to your subscription. At the same time, you can also buy any other features currently being trialled by checking the appropriate box. Any features already subscribed will also be shown.

Add to subscription

Check any other features that you want to buy and click Yes, proceed. If this is the first feature you have bought, you will need to create a billing subscription by adding payment card details.

Launching your App

Kumulos features are free to use on up to 25 test devices for up to 30 days while your app is in development. After this, you must either switch features off or add features to your subscription to remove these device and time-based limits (and also allow you to create a staging environment for your app).

This should be done prior to store submission (so that your app is not rejected due to exceeding device or time-based usage limits during the approval process).

If this is the first feature you have bought, you will need to create a billing subscription by adding payment card details.


Suspending an App

Should you wish to temporarily disable all features for an app without changing their configuration (for example: if there is a billing dispute with a client), you can suspend an app. While viewing the app from the client or app dashboard use the context action and select "Suspend"

Click Suspend

As this will cause all features to stop working, you will be asked to confirm.

Click Confirm

When you click confirm, the app will now be suspended and all features will stop functioning.

This will not automatically adjust your subscription. Please contact us if you wish to do so.

App suspended

  • New analytics installs, sessions and events will not be registered
  • New push installs will not be registered
  • Push Notification API calls will fail
  • ASO keyword rankings will cease
  • Crash reports will be ignored
  • Build API calls will fail

When you (or your client) attempts to access any feature, the following message will now be shown.

Features suspended

Re-enabling a suspended app

When you wish to un-suspend an app and re-enable all features, while viewing the app from the client or app dashboard use the context action and select "Enable"

Click Enable

This will resume all features to their previous configuration and so you will be asked to confirm.

Click Confirm

When you click confirm, all features will be enabled.


Creating a staging environment

If you have enabled and bought the App Build Mobile Backend-as-a-Service feature, it can be useful to create complete copies of the app so that bugs can be fixed on a test version, or new features can be added in a staging version of an existing app. This can be accomplished for any app for which the App Build Mobile Backend-as-a-Service feature has been bought.

While viewing the app from the client or app dashboard use the context action and select "Copy"

Click Copy

The create environment dialog will appear, prompting for a name for the new copy of the app. The suggested title will append '_staging' to the current app name. Click 'Submit' to start the copy process.

Create environment dialog

Once the process has completed the dialog will provide feedback and a link to the newly created app, simply click the button to open its dashboard.

Copy Complete

If you want to promote any changes to API Methods from a staging environment to your live app, then please contact support who will be happy to do this for you.