This document gives an overview of the main tabs of the Appery.io platform dashboard and introduces the general functions you might need when backing up or otherwise managing your data.
Video Tutorial: Appery.io Dashboard Overview
We highly recommend that you also check this detailed video guide covering the main features of the Appery.io platform:
The Apps tab includes information about your projects, saved versions, people with whom you share the project, and about hosting on Appery.io. Here you can:
- Create new projects.
- Open, test, rename, update, and delete projects created earlier.
- Make an app backup.
- Create project versions and restore the old version of the project.
- Invite people to share the project, or change the project owner.
- Publish your project to your custom domain or Appery.io domain.
The left panel is the list of your apps with the labels indicating the framework the app was built with:
But if you are new to Appery.io, you will have no projects listed and will need to create your first app to see what's inside.
To create a new app, click the Create new app button:
The modal window will open offering to select from the five tabs for creating a new app:
- Ionic 4
- Ionic 5
- jQuery Mobile
- Appery.io Templates
- My templates
- From backup
The first three tabs offer the selection between three popular frameworks that are currently supported by Appery.io.
The My templates tab will show your projects that have been previously published as project templates (you can check this link to learn more about exporting projects as templates.)
Enter the app name (for example, NewIonic5App), select the needed tab (for example, Ionic 5) and click Create:
To create an app from a backup, switch to the From backup tab and select the project backup file. You can only upload an Appery.io project (exported as a backup).
Maximum App Backup Size
Appery.io has a limitation for backups. The maximum app backup size you can upload is 60MB.
Therefore, you should be careful with the size of your applications (with a lot of local media files) and if your backup file size exceeds the max. app backup size that can be later re-uploaded. Before initiating the backup process, please check if your project contains large media files and delete them or reduce their size. Also, you can consider keeping them in the cloud and upload them to your project separately.
However, if the project size doesn't exceed this limit, you can be sure all your data will be kept safe.
More information about managing project backups can be found here:
The default Start page will open in the Appery.io Visual Builder:
If you already have some projects and plug-ins created under your account, you can access them by selecting the needed app (or the previously created private plug-in).
The main app frame includes information about the selected project. Here, you can also switch between General, Push Notifications, Customer Console, and Permissions frames:
As you move the mouse over the project name, the Open button appears. Click it to open your project for editing (you will be redirected to Appery.io Visual Builder).
The General frame consists of the following sections:
- Project summary
- Share with support
The Project summary section contains the project name and some related data. You can also see the different options available for managing this project (Open, Test, Rename, Delete, Backup, Update, and Remote Debug):
From this section, the project can be opened, tested, renamed, deleted, updated, debugged remotely (to activate this option, click the Enable Weinre debugging checkbox under the project App settings > General tab) or saved for later use (backed up) with further restoring it or even transferring to another account if necessary.
Deleting cannot be undone later.
The Versions section contains information about versions of the project. This area contains the following information:
- Reversed order number.
- Creation date and time.
- User who created the version.
- Version comment.
- Links to restore or delete the version. When you click any link, a pop-up opens where you can confirm or cancel the action.
In this section, you can create a version of your current project. Click New version to create a new app version. It is a good idea to enter a version comment to help you identify the version later.
It’s always a good idea to make app versions as you go along during your development so that you can experiment with your project safely.
Later, you will be able to go to the General tab, scroll down to the Versions section, restore the necessary app version, and create another project backup if needed.
App Versions Number
The number of versions is plan-dependent, so check our Pricing table to learn how many versions can be created under your plan.
If you haven’t created a version yet, the Versions area contains information about the current user, and the date and time the project was last saved.
To create a version, type the version name and click New Version.
When you restore the version, you’ll lose the changes made after the last version was saved. If you created a new version before restoring one of the earlier saved versions, no changes are lost and you can restore them later.
The Hosting section allows you to publish your app. This area also contains information about the domains where the project was published.
Using Publish, you can publish the app and update it after editing. Using Unpublish, you can stop hosting the app.
More information on Webhooks can be found here.
The section Share with support is placed at the bottom of the page:
When a user shares (turns the toggle on), the specified resource appears in the admin section. This feature can be used by the support team for viewing and accessing all resources (apps, databases, server scripts, etc) shared.
When a user unshares (turns the toggle off), the specified resource can’t be accessed for viewing by the support.
And all you need to do is to select an app under the Apps tab list, go to its General tab and click Backup:
A new window opens allowing you to select where you would like to save your backup.
App Backups Number
The number of backups is plan-dependent, so check our Pricing table to learn how many app backups can be created under your plan.
If your app has integrated backend services like Databases, Server Code, API Express, or proxies, you can export this app bundle with all its dependencies. This allows making a full copy of the existing app in just a few clicks with keeping all the service settings and values in place.
With the option of creating a bundle project backup, there is no need to regenerate all the backend data anew.
Please note that such custom dependent data like push configuration settings (certificates, etc.), Google Services JSON File, Firebase Admin SDK JSON File, API Express Security Providers, etc. are NOT added to the build and you will need to define them separately.
To generate the bundle project backup, select the needed app under the Apps tab list, go to its General tab and click Backup.
If your app has some backend, a new window will open and you will be offered to check the backup options you would like to save:
Now, all you need to do is select the backend services you would like to save with the project and confirm your selection.
You will see the message App export has been queued. You will be notified by e-mail when ready. After a while, you can check your inbox for the email with the link to the generated bundle project backup.
Please be informed that the source application and the application you created from the backup will not be connected and not dependent on each other in any way.
Now, you are free to save it to your drive for further use or recreate the app with all its dependencies under the same account (so that you have two different working copies of the same app), or even create an app from this backup under a different Appery.io account.
Please be aware that it is NOT recommended that you make any changes (for example, renaming or replace elements, etc.) to the exported backup file - this might result in a corrupt file with no possibility to unpack it in the future.
Later, when you decide to recreate your saved project, under the Apps tab, click Create new app. In the new window, select the From backup tab, enter the project name, choose the backup file saved on your drive, and confirm the action:
We highly recommend that you always save all your custom generated data like Apple provisioning profiles or those involving 3rd party Push notification providers like Firebase Cloud Messaging(FCM) and legacy Google Cloud Messaging (GCM).
Importing other saved data is even easier.
Just select the appropriate tab (Apps, Databases, Server Code, or API Express) and click the green button Create new ….
In the new window, choose the previously saved backup file to be imported, name it, and hit Create.
Please be aware that you will need to make backups under the corresponding tabs and import them back under the same tabs.
Check below how to create a new database from a backup:
You will need to wait a bit and then…
Congratulations! You’re done!
Find more details about how to work with private plug-ins in this document.
The below tabs provide tools for setting up a backend for your Appery.io projects and the detailed information can be found under the corresponding links:
Databases tab stores app data;
Secure Proxy is used for creating a service used for securing sensitive data such as an API key by keeping it only in the database and not in a mobile application;
API Express is used for exposing enterprise data sources such as an
SQL database or
SOAP service via REST APIs.
The Resources tab provides access to the resources saved under your account such as certificates, webhooks, and Cordova plug-ins. Selecting the corresponding tab allows access to the management options among which are exporting, exporting to ZIP, deleting, updating,
etc., depending on the resource selected:
Find more details about how to work with:
- Certificates: https://docs.appery.io/docs/appexport-certificate-management
- Webhooks: https://docs.appery.io/docs/webhooks-overview
- Cordova plug-ins: https://docs.appery.io/docs/cordova-overview.
To view/update your account information, go to the Account tab:
There, many options are available such as changing/canceling plans, deleting the account, creating teams, purchasing support packs, etc. For more details, check here.
Updated 3 days ago