Introduction

This document describes our customizable Starter App template that is designed to serve as the foundation of any modern mobile application and can be used on any device:

🚧

Important!

Note that to make sending confirmation emails or messages possible you need to personalize your profile. For testing purposes, use the code 12345.

As a bonus, we provide detailed explanations for those who are interested in customizing the offered app template.

Using Starter App Template

No special knowledge or experience is required to use our Starter App template — just follow the simple steps below to install the app and enjoy low-code development with Appery.io!

📘

Important!

Please rest assured that you are the creator and the only owner of this application (actually, like any other app created with Appery.io).
For more details, you can check our Copyright, Trademark, and Content Ownership section here.

👍

Customizing Options

Besides, many customization options are available like renaming the app, changing the template color themes, launch icons and screens, customizing app pages, etc.
If interested, check out the instructions in the Customizing App Template section below or watch this video to learn how to use the app:

Creating App from Template

1. From the Apps tab, click Create new app.
2. Select App Starter, enter the name for your project (for example, Starter App, and click the Create button.

In a moment, refresh your browser to see that the app is created and the first thing you can see is our App Builder Educational Video Guide page with the Project View section on the left where all the predefined project data can be found.

The application is ready to be used so let's test the app at work and see what it's all about.
Click the TEST button in the app Toolbar; you will be redirected to the tab with the app preview.

🚧

Note!

If you are launching your project for the first time, please allow some time for the app preview to load.

Registering Account

1. Once loaded, the Initial Setup page will launch in the preview, looking like this:

2. On this page, you can experiment with setting it to dark mode and back by clicking the corresponding toggle or using the language selector to change the app language.
3. Once ready, you can proceed to the next page by clicking SAVE:

4. As a new app user, you will need to register an account before you can start using the app. So, once redirected to the Login... page, click the Create Account link:

5. The Sign up page opens where you will be asked to provide your registration data: first and last names, email address, phone number, and password:

6. Once registered, you will get a warning informing you that since this app is operating with a native API, sending emails and messages cannot be tested in the browser. To test the app in full, you will need to configure the StarterLib server code script.

7. For now, let's continue in the Test mode. For this, enter 12345 as the confirmation code to finish registration.
8. Now, as a registered user, you can enter your details on the Login... page and click LOGIN:

👍

Note!

The page also has the Remember me and Forgot Password? options.

🚧

Forgot Password? Feature

Note that the Forgot Password? feature and will not work out-of-the-box unless the app Server Code script is properly defined.

App Description

Once you log into the app, it will start with showing the three Tabs buttons in the footer (left to right): Notes (current), Settings, and Profile.

By default, the Notes page will launch in the preview, informing you that you do not have any notes for now and offering to create a new note:

App Menu Page

To access the app menu, click the three-line button in the upper left corner of the screen: the sidebar on the left will open with three menu list items that duplicate the tabbed pages in the footer (Notes, Settings, and Profile). Also, the Logout option becomes available.

What is good - as an app user, you require no special training to use the app: simply choose the corresponding list item you are interested in and proceed with defining the app:

• manage your notes
• open the app Settings page
• go to the user Profile page
  or
• Log out.

Settings Page

From the Menu page, click Settings; you will find yourself on the page you already saw in the initial setup stage. Here, you can switch between light and dark modes and use the language selector:

On this page, you can also delete the current user.

Notes Page

Creating notes is the main option of the app and using it is also very simple.
Let's check out how you can create a new note.

Creating Notes

1. To start, select Notes on the menu list or click the Notes tab in the footer.
2. From the Notes page, click the + ADD button to open the modal window; there, enter the note name and add its description. You can create as many notes as you need:

3. After you hit SAVE, the created note will appear on the Notes page list.
4. If needed, you can search for a specific note by using the search option:

Managing Notes

1. When created, any note can be edited; select it on the list, make the changes you need, and click SAVE:

2. Swipe left to delete the note:

Profile Page

1. To open the user profile, select Profile on the menu list or click the Profile tab in the footer.

2. Select the pencil button in the upper left corner of the page to open the modal where you can edit the user details such as the profile photo (cropping is available), gender, address, etc.
3. Click SAVE to keep the changes made and go back to the Profile page:

👍

Customizing Options

For this template, many customization options are also available like changing the app color themes, launch icons and screens, customizing app pages, etc.
If interested, check out the instructions in the Customizing App Template section below or watch this video to learn how to use the app.

Personalizing Profile

Note that before the app can be used efficiently, some personalization changes need to be made to the server code library; this will make sending confirmation emails or messages possible.

1. Click the Server Code link located to the right of the top app Toolbar to open the Server Code dashboard in a new window so that you can now work with it without even closing the project.
2. On the Server Code page, select StarterLib to open the library:

3. Now, proceed with selecting what confirmationType will be used for sending notifications: SMS or email messaging.
4. When done, proceed with personalizing the needed fields by replacing the default values with your custom ones, for example, provide your valid email settings or enter your Twilio details:

👍

Defining Options

To learn how to set up your Twilio account, open this page.

For more details on how to define SMPT for your Gmail account you can check this video:

Reviewing App Backend

The suggested template goes with the integrated backend services like Server Code (discussed earlier) and Appery.io Database.
While the Appery.io Server Code services provide correct serverside interactions, Appery.io Database services are responsible for keeping all app data.

Let's take a quick look at what the app database looks like from the inside.

1. Click the Database link located to the right of the top app Toolbar to open the Databases dashboard in a new window so that you can now review it without even closing the project:

2. On the Databases page, click Starter_DB to open the database:

3. When in the database, click on the Collections tab to access the default user records organized in the Users predefined collection and check that there are records of the users registered for your app:

4. Any other database collection can be reviewed (and modified if needed) in a similar way.
   For example, to review the list of duties that have already been added to the app, select the duties custom collection:

👍

Video: Integrating a New Database Collection with Your Starter Template App

You can also check this YouTube video tutorial that shows how to how to create and customize a database collection for integrating it into the project connected to an API backend (cloud database) and created from the App Starter template:

Customizing App Template

It is natural that being a template, our Starter App offers many customization options. So, if you are interested in customizing this template, we highly recommend that you check out the instructions in this section.

👍

Note that our Services Team will be happy to assist you in building the application you need. So, if you require professional help with additional customizing or debugging your app code and/or logic, you can consider purchasing one of our Support Packs to get the highest priority support.

Renaming App

The first thing you might like to do to make your app unique is to rename your project.

1. To do it, you will need to exit the App Builder so click the CLOSE button in the top app Toolbar:

2. After that, you will be redirected to the Apps tab with the information about your Appery.io projects, their saved versions, people with whom you share the project, and about hosting on Appery.io. Here, click the app Rename button:

3. Now, in a new window, provide a new app name, for example, Genius App, and confirm this change:

In a moment, the Apps tab will be updated with a new app name.

4. Now, you can click Open to proceed with customizing your own application:

Reviewing General App Structure

When the app opens in the App Builder, you will see that this app template was created with Ionic and has multiple folders comprising a set of organized pages, predefined color Themes, integrated backend services, and TypeScripts all of which can be customized as per your needs and app requirements. You can unfold any of them to see what resources are available:

Every file or folder in the Project tree was created using our App Builder and we will now give you a little background on how you can customize the template resources.

Customizing App Pages

Opening the Pages folder, for example, will allow you to customize the individual app pages' UI and behavior. The easiest is changing the text so let's have a closer look at how this can be done.

Changing Text Property

With Appery.io, not only can you easily change the name of your application, but also you can modify any text in the suggested template.

Let's review the example of changing the text of one of the Login page UI components.

1. First, select the Login page on the Project tab list located to the left of the mobile phone frame. The page will open in the DESIGN panel.

📘

Adjusting Screen Size

Note that you might need to switch to the comfortable screen size (depending on your monitor) XS, SM, MD, LG, XL to see the whole page.

2. Select the text instance you would like to modify.

📘

Using Breadcrumbs

You might have noted that there are the breadcrumbs above the phone frame: they are often used for easy navigation between the parent/child components.

3. The PROPERTIES panel for that component will be shown on the right where you can locate its Text property.
4. Now, you can simply modify the text value, for example, replace the default Username with Genius name and this change will be automatically reflected in the UI:

5. Now, when you click TEST once again, you will see that the preview has also been updated according to the recent change made.

Changing App Logo

Our template has a default logo on its Login page, but you can replace it with any other image you like.

1. To change the default image, in the app Project tab, open the Login page - the page where this image is added to, click the image on the screen which will automatically select the LogoImage component, and then click the Change button for its Image property on the PROPERTIES panel:

2. The Media Manager window will open where you can either select one of the available images or upload a needed file from your drive.

3. Click Upload file, select the needed image on your drive and confirm uploading it.
4. When uploaded, the image file should appear on the images list and can be selected and then applied as a new app logo.

Customizing App Color Themes

Another great way to make your application stand out from a plethora of other apps is by changing the app color theme. You will be surprised to see how easy it is to completely change the looks of your app using our Theme Generator option.

Each of our templates has its unique design. What it also has is called Themes that are created under the Theme folder.
Our Starter App template offers two different color themes to select from: Dark and the default one:

👍

Creating Custom Themes

If you would like to create your custom theme, you can do it using the CREATE NEW > Theme drop-down and following the instructions in this document.

Every app page has a Theme drop-down. The default app theme is applied here but you can try selecting other theme options from the drop-down to see what this specific page will look like under a different theme:

👍

Important!

This drop-down works for preview purposes only and if you decide to apply the selected theme to the entire application, go to Project > App Settings > General and select the needed theme from the drop-down:

Customizing App Launch Icons and Screens

In addition to modifying the appearance of the app pages, you are also free to replace the default launch icons and screens (iOS only) by using our Launch Icons and Screens generator (or upload your custom fonts by using the Files Manager).
It works similar to what was demonstrated in the Changing App Logo section: by clicking the Change button and using the Media Manager:

Testing Customized App

Testing any Appery.io app is fast and simple. Simply click the TEST button in the top App Builder Toolbar.
The browser will launch with the app that you have just built.

Testing on Device

When your app version is ready, you might also like to test it on the device.

👍

Appery.io Tester App

A great option to quickly test the app on the device is to use our Appery.io Tester app.
The app is free and available for both iOS and Android.
You can check out this page to learn more about using the Appery.io Tester app.

🚧

Hiding Controls menu

When testing using the Appery.io Tester app, you can also hide the Controls menu by first clicking the main control a button and then selecting the third icon (Four arrows pointing inwards) on the menu. In the modal screen, click OK to confirm:

And here is how our customized Starter App behaves on the device when tested with our Appery.io Tester app:

Note that the login page also has the Biometric Login option integrated. Enabling/disabling this option is available on the Settings page and accessible when tested on the device only:

Exporting App

When your final app version is ready, you might like to proceed with exporting your app for
Android or iOS with further installing it on a device.

👍

Selecting Build Type

Before you can proceed with exporting your app, go to Project view > Project > App settings > Android binary/iOS binary to select the Release build type (Debug is the default type for both and can be used for testing purposes only):

If the Release and Publish type is selected under the iOS binary tab, building the release app version will be performed together with publishing it to the App Store.

👍

Important Note!

Please, note that before you can export the app, the app certificates must be imported or automatically generated (in the case of Android).
You can check this document in case you need help with exporting your application for iOS.
Here, you will find information on generating certificates for Android.
Note as well that starting from August 2021, new apps are required to publish with the Android App Bundle (.aab) on Google Play.
Please read more here.
You can also check this Appery.io Community video that shows how to create Android and iOS certificates:

1. After the needed certificates have been added to your app all you need to do is to wait for the bundle to be created.

2. Now, you need to select the format you prefer (you are also free to build both if you need): .aab or .ipa to start building your project:

🚧

Managing Build Error The certificate file is not set

If this is your first app created with Appery you will most likely get the error signifying about missing certificates that will prevent you from successfully finishing the build process.
The error reads similarly for both binary types and indicates that you should set the corresponding certificate before starting a new build.
If this notification is what you see after starting your build, please check out this document about certificate management that explains how to add the needed certificate to your project:

3. Once your project is generated, you will see the QR-Code that you can use to upload the application to your device (or save the .aab or .ipa file for further use):

4. Then, install the app on your device and enjoy the result of your customization efforts:

Publishing App

Any app that you build in Appery.io can be published as a mobile web app. This means the app will be hosted on a server and can be accessed from any browser on a mobile device: