AladiaDocs

Mobile app

Your workspace app on the App Store and Google Play, with your name, icon and colors. Developer accounts, appearance, connecting the stores, the store listing, privacy and publishing.

Draft · being trialled on pilot workspaces (12/10/2026)

With Settings › Mobile you prepare your academy's app: your students download it from the App Store and Google Play and find it with your name, your icon and your colors. Inside are courses, calendar, chat, events and profile, as on the site.

Owners and admins of the academy see the section (in the personal workspace, its owner). It is included from Organization (and on Enterprise); on Solo and Team you already see the real app in the phone, with your workspace content, and you can navigate it; next to it the App Store and Google Play badges let you try it on your phone. Name, icon, colors, splash and stores stay locked with Upgrade to Organization. It is one of the features available only once paid: during the Organization trial you see the same preview and End the trial and pay now.

How the page works

Everything is on a single page:

  • on the right the phone with the real app and, attached to its edge, the toolbar: Preview, Appearance, Store and Try it on your phone (hover an icon to see its name). The phone stays in place while you scroll. On a phone, the phone goes on top and the toolbar sits below it, horizontally;
  • on the left five sections that open and close: Apple App Store, Google Play, Store listing, Privacy and compliance and Publishing. They start closed; the one that needs an action (for example a key with an error) opens by itself. Each section shows its status in the header.

When you have unsaved changes (appearance or store listing), Reset and Save appear at the top.

Before you start: developer accounts

The app is published in your academy's developer accounts, not in Aladia's. Apple (guideline 4.2.6) accepts apps made with a platform only when they are published by whoever owns the content. This way the app stays yours, with its name, reviews and users, even if one day you leave Aladia.

StoreCostWhat you need
Apple (Apple Developer Program)99 USD a yearAn Organization account, with the company's D-U-N-S number (free, it takes 1-2 weeks)
Google Play (Play Console)25 USD one-offAn Organization account, with the D-U-N-S number

We recommend an Organization account on Google too: with a personal account, Google first requires a closed test with 12 testers for 14 days.

The D-U-N-S number is the slowest part: request it right away from the Dun & Bradstreet site or from Apple's enrollment page.

App preview

The phone on the right shows the real app, the same one your students will download. With Preview in the toolbar you choose:

  • iPhone / Android: the phone frame and details (Dynamic Island and home bar, or camera hole). It is a simulation: some native parts, such as the status bar or system menus, may differ from a real phone.
  • Light / Dark: the phone theme.
  • Student / Teacher / Admin: which role to view it as. Each role sees its own tabs and actions.
  • Data: Real (your workspace's courses, teachers, calendar and chat) or Sample (a demo art academy with real photos and videos).
  • Screen: Splash (the splash screen with your background and logo), Home, Courses, Chat or More.

With Real the app reads the workspace data with your own access, read-only: you only see what you already see on the web, without signing in again. The chosen role decides tabs and modules; the content is what you have access to (for example "My courses" shows your enrollments). What you do in the preview (a message, a reaction) stays simulated: it reaches nobody and disappears on reload. If real data cannot be shown (workspace without courses, page opened from a custom domain instead of aladia.io, expired session) the preview uses sample data and tells you why below the switch. Real data is rolling out gradually: if you cannot pick Real, it is not enabled for your workspace yet.

With Sample the preview uses demo data: fake courses, lessons and messages, none of your students' data. If it does not load, you see a simulation in its place (the splash screen and the Home drawn with your colors), with the note "Live preview unavailable".

Appearance

With Appearance in the toolbar you decide how the app looks. Name and colors show up in the phone right away, even before saving.

  • App name: up to 30 characters, under the icon and in the stores.
  • Short name: up to 12 characters, when the name does not fit.
  • Icon: upload a square PNG of at least 1024 × 1024 px, without transparency, or press Use Branding logo. If the logo is not a square of at least 1024 px we tell you: Apple and Google would reject it.
  • Colors: the primary color for the light theme and, if you like, one for the dark theme. If the color has low contrast with the button text we tell you.
  • Splash screen: the background color and the logo (here too you can use the Branding one). Without a logo the icon is used. You see it by choosing Splash in Preview.
  • Visible tabs: Home, Courses, Calendar, Chat, Events, Profile. Home and Profile are always there.

Press Save (in the Appearance window or at the top of the page). Colors and tabs reach the app without a new version; name, icon and splash screen with the next version. Images are saved as soon as you pick them.

If you had already filled in the "Mobile app" section in Settings › Branding, you find it here as a starting point.

Try it on your phone

Press Try it on your phone in the toolbar (or in the Publishing section) to see the app on your own phone:

  1. Download the Aladia app (until your app is in the stores, from the beta: TestFlight on iPhone, internal testing on Android; the links are in the window).
  2. Scan the QR code with your camera.
  3. The preview of your workspace opens with the chosen role. You can change the role in the window: the QR code is regenerated.

With Copy link you can send the link to a colleague. The link expires after 1 hour (the exact time is shown in the window): just reopen the window to get a new one. If you open the link on a phone without the app, you find the Open in the Aladia app button and the links to download it.

Apple App Store and Google Play: connecting the stores

The Apple App Store and Google Play sections show the store's mark and their status: Not connected, To verify, Connected or Error. Open them to follow the steps.

Apple: the App Store Connect API key

In App Store Connect open Users and Access › Integrations › App Store Connect API and create a key with Admin access (it is needed to create the app's certificates and profiles). Download the .p8 file: Apple lets you download it only once. In Aladia enter the Issuer ID (at the top of the same page), the Key ID and upload the .p8 file. If the file is called AuthKey_XXXXXXXXXX.p8, the Key ID fills in by itself.

Apple: the push key (APNs)

In the Apple Developer portal open Certificates, Identifiers & Profiles › Keys, create a key with Apple Push Notifications service (APNs) and download the .p8. In Aladia upload it with its Key ID. It powers the app's notifications.

Google: the service account

In Google Cloud create a service account in the project linked to Play Console, enable the Google Play Android Developer API and create a JSON key. In Play Console, under Users and permissions, invite the service account's email with the Release apps permission. In Aladia upload the JSON file.

Google: create the app in Play Console

In Play Console create the app with the package shown in the Google section (for example io.aladia.t.name, with a button to copy it). Only the account owner can create the app.

Verify and connect

Press Verify and connect: Aladia saves the keys and really tries them. With Apple it reads the list of apps and checks that the key is Admin; with Google it opens and discards a test edit on the app, without changing anything. If something is wrong, the message says what to fix.

The iOS app's Bundle ID (for example io.aladia.t.name) is in the Apple section, with a button to copy it.

Visibility: on Apple choose Public (found by search) or Unlisted (only with the link, suited to schools with enrolled students only); on Google Public or Testing only.

Don't want to create the keys? Press Invite us as Admin: you find the steps to add us to your Apple and Play Console accounts, and we create the keys.

Most common messages

MessageWhat to do
Apple does not recognise the keyCheck Issuer ID and Key ID and that the key has not been revoked
The key does not have the Admin roleCreate a new API key with Admin access
The app does not exist in Play Console yetCreate the app with the package shown, then try again
The service account has no access to the appInvite it in Play Console with the Release apps permission
The Google Play Android Developer API is not enabledEnable it in the service account's Google Cloud project
Store linking is not available yetWe are finishing the setup: meanwhile prepare the appearance and the listing

Your keys are safe

  • Keys are stored encrypted and are never shown again: after the upload you only see "Key …XXXX uploaded on dd/mm".
  • Replace uploads a new key (to be verified again); Disconnect deletes it from Aladia. An app already published stays in the stores.
  • We use them only to build and submit the versions of your app.

Store listing

The Store listing section holds the texts and contacts that Apple and Google show on your app's page. Fields with an asterisk are needed to publish.

  • App name: the one from Appearance; Edit in Appearance opens the window from the toolbar.
  • Short description (Google): up to 80 characters, required on Google Play.
  • Subtitle (Apple): up to 30 characters, optional.
  • Full description: up to 4000 characters.
  • Keywords (Apple): comma separated, up to 100 characters (commas count too; we remove the spaces after commas).
  • Category: starts as Education.

Suggest with AI writes the subtitle, short description, description and keywords from your workspace data (name, about, published courses and subjects). It uses AI credits like the other AI tools. The texts go into the fields for you to review: nothing is saved until you press Save. If you had already written something, we ask before replacing it.

Contacts:

  • Contact email: if you leave it empty we use the email of the workspace owner. It is public on Google Play.
  • Support URL: required by Apple; if you leave it empty we use the academy website.
  • Privacy policy URL: required by Apple and Google. If Settings › Requests already has the address of your privacy policy we use it from there; otherwise enter it (for example the privacy page of your website).

Under More (optional) you find the Marketing URL and the Promo video (a YouTube link on Google Play).

The store page

Store in the toolbar opens, next to the phone, your app's page on the store, scaled down and scrollable. The phone always keeps showing the app. When the Store listing section is open, the Store button shows a dot.

  • At the top choose App Store or Google Play. The choice follows the Preview phone: iPhone shows the App Store, Android shows Google Play (and the other way round). Light and dark follow the Preview Theme.
  • The page uses the current data, even before you save: name and icon from Appearance, texts from the Store listing, the data collected from Privacy and compliance, the academy name as developer.
  • On the App Store the description closes after 3 lines with more, as students will see it. If the subtitle is empty you see the grey placeholder Subtitle.
  • Click a text (subtitle, short description, description, keywords) to edit it in place: under the field you see the counter with the store limit, red when you go over it. It is the same text as the fields on the left: one Save saves everything. Apple keywords are not visible on the store, so they sit in a separate dashed box.
  • The screenshots are samples drawn with your app's colors and name (with Aladia's color if you have none): we generate the real ones at the first build.

It is an approximate preview: Apple and Google decide the final look, and it may change with their updates.

What the stores require

RequirementApple App StoreGoogle PlayIn Aladia
Nameup to 30 charactersup to 30 charactersAppearance
Subtitle / short descriptionsubtitle, 30, optionalshort description, 80, requiredStore listing
Descriptionup to 4000 charactersup to 4000 charactersStore listing
Keywords100 charactersnot usedStore listing
Icon1024 × 1024 px512 × 512 px (we derive it from yours)Appearance
Screenshots and feature graphic (1024 × 500, Google)requiredrequiredwe will generate them with the first version
Privacy policy (URL)requiredrequiredStore listing
Support URLrequiredoptionalStore listing
Contact emailfor the reviewpublicStore listing
App privacy / Data safetyrequiredrequiredPrivacy and compliance
Age and content ratingrequiredrequired (IARC questionnaire)Privacy and compliance
Export compliance (encryption)requirednot usedPrivacy and compliance
Demo account for reviewersif sign-in is neededif sign-in is neededwe will create it automatically

Privacy and compliance

Apple and Google ask for some declarations about the app. They are the same for every Aladia app (same code), so you find them already filled in: read them and press Confirm on each one. We save the date and who confirmed ("Confirmed on dd/mm by Name"); Withdraw cancels the confirmation.

  • Data collected (App Privacy on Apple, Data safety on Google): contact info (name, email, phone), user content (messages, posts, assignments and test answers, uploaded photos, videos and audio), identifiers (user and device, for notifications), location (only when the user adds a place to a post), purchases, usage data and diagnostics. All linked to the account and used to run the app; no tracking across other companies' apps, no sale of data, data encrypted in transit, users can delete their account from Profile.
  • Age and content: Education category, no sensitive content; school users can message each other and share content, with reporting and moderation. Proposed rating: 4+ on Apple, PEGI 3 / Everyone on Google.
  • Encryption: only the system's standard encryption (HTTPS), so the app is exempt from export documentation.
  • Copyright: "© year and your academy's name".

If one day the app collects new data, we update the declarations and ask you to confirm them again.

Publishing

The Publishing section shows what is missing before submission, with a count. Next to each step to complete, Go opens the right section (or the Appearance window).

  • Stores connected (for example 1/2): Apple (API key and push key verified) and Google;
  • App name, icon and color;
  • Texts ready: short description, description, keywords, email, support and privacy;
  • Store graphics: we generate them with the first version (coming soon);
  • Privacy confirmed: all four declarations;
  • Demo account for reviewers: we will create it automatically (coming soon);
  • At least one published course.

Here you also find Try it on your phone (it opens the same window as the toolbar), the Store status and the Version history, which will list every submission with its status. Submit for review is coming soon: for now, once the checklist is complete, we submit together with you.

On this page