White‑Label PWA Apps Guide
EazyClassroom allows you to create a fully branded Progressive Web App (PWA) for your school or academy. Your users can install your app on their devices – phones, tablets, and desktops – complete with your logo, name, and colours. This guide explains how to set up white‑label branding and how users install the app on different platforms.
1. What is a PWA and Why White‑Label?
A Progressive Web App is a website that behaves like a native app. Users can install it on their home screen, launch it like any other app, and use it offline (basic caching). White‑label means removing EazyClassroom branding and replacing it with your own.
Benefits:
- Your school name and logo appear on the home screen.
- No “EazyClassroom” branding visible in the classroom or dashboard.
- Trust and recognition – students see your brand, not ours.
- One‑click installation – no app store approval needed.
2. What Can You Customize?
| Element | Where It Appears | Required Size |
|---|---|---|
| Main logo | Header of the web app (all pages) | 223×40 pixels |
| Mobile icon | Home screen icon (phones and tablets) | 192×192 pixels |
| Desktop icon | Desktop icon (Windows, Mac, Chromebooks) | 512×512 pixels |
| Classroom background | Behind the main content when a session is starting | Auto‑generated from main logo |
| PWA name | Under the icon on home screen | Text (e.g., “Al‑Noor Academy”) |
| Theme colour | Browser address bar, splash screen | Hex colour (default #0000ff) |
3. Step‑by‑Step Setup for Admins
Step 1: Upgrade to a plan that includes white‑label
White‑label branding is available on the School Plan ($15/month) and higher. The Free and Teacher plans show EazyClassroom branding.
If you are on the School Plan, proceed.
Step 2: Prepare your images
Create three images with the exact dimensions:
| Image | Size | Format | Example |
|---|---|---|---|
| Main logo | 223 × 40 | PNG (transparent background recommended) | logo-main.png |
| Mobile icon | 192 × 192 | PNG (square) | logo-mobile.png |
| Desktop icon | 512 × 512 | PNG (square) | logo-desktop.png |
Tip: Use a transparent background for the main logo so it blends with any theme. For the icons, use a solid background or your brand colour.
Step 3: Upload logos
- Log in as Admin.
- Go to Settings → Branding (or White‑Label in the sidebar).
- Under Main logo, click Upload and select your 223×40 image.
- Under Mobile icon, upload the 192×192 image.
- Under Desktop icon, upload the 512×512 image.
- Click Save.
The system will automatically:
- Resize and crop the images (if needed) – but you should upload exact sizes for best quality.
- Generate a new manifest.json file for each user type (admin, teacher, parent) under
assets/manifests/. - Update the classroom background image with your logo and school name.
Step 4 (Optional): Change the PWA name and theme colour
The PWA name is taken from your school name (set in Settings → Profile). To change it:
- Go to Settings → Profile.
- Update the School name field.
- Save – the manifest will regenerate.
To change the theme colour (currently fixed to #0000ff), contact support (customisation coming soon).
Step 5: Notify your users
Ask your teachers, parents, and students to re‑install the PWA (remove the old app and add it again). The new branding will appear after re‑installation.
4. How Users Install the PWA on Different Devices
Android (Chrome)
- Open Chrome and go to
https://app.eazyclassroom.net. - Log in (as admin, teacher, or parent – each role has its own manifest).
- Look for the install banner at the bottom of the screen (may appear after a few seconds).
- Tap Install or Add to Home Screen.
- The app icon appears on your home screen with your logo.
- Tap the icon – the app opens in full‑screen (no browser address bar).
Alternative: Tap the three‑dot menu → Install app → Install.
iPhone / iPad (Safari)
iOS does not show an automatic banner. Users must install manually:
- Open Safari and go to
https://app.eazyclassroom.net. - Log in.
- Tap the Share icon (square with arrow at the bottom of the screen).
- Scroll down and tap Add to Home Screen.
- Edit the name if desired, then tap Add.
- The icon appears on your home screen – tap to open the app.
Note: On iOS, the PWA does not support push notifications yet (this is an Apple limitation). It will open in a standalone window without browser controls.
Windows 10/11 (Chrome or Edge)
- Open Chrome (or Edge) and go to
https://app.eazyclassroom.net. - Log in.
- Look for the install icon in the address bar (a monitor with a down arrow).
- Click Install.
- A window appears – click Install again.
- The app appears in the Start menu and can be pinned to the taskbar.
macOS (Chrome or Edge)
- Open Chrome and go to
https://app.eazyclassroom.net. - Log in.
- Click the install icon in the address bar.
- Click Install.
- The app opens as a standalone window (like a native macOS app). It appears in Launchpad.
Chromebook
- Open Chrome and go to
https://app.eazyclassroom.net. - Log in.
- The install prompt appears automatically (or click the install icon in the address bar).
- Click Install.
- The app appears in the app drawer.
5. Verifying the Correct Branding
After installation, check these elements:
| Element | What to Expect |
|---|---|
| App icon | Your 192×192 or 512×512 logo (depending on device) |
| Launch screen | Your main logo and school name (generated from your settings) |
| Header logo | Your 223×40 logo in the top‑left corner |
| Classroom background | Your logo and school name on the pre‑join screen |
| App name | Your school name (not “EazyClassroom”) |
If any element still shows EazyClassroom branding, clear your browser cache and re‑install the app.
6. Troubleshooting White‑Label Issues
| Issue | Likely Cause | Solution |
|---|---|---|
| Manifest not updating | Browser cache | Clear cache, uninstall and re‑install the app. |
| Icons blurry | Wrong image size | Re‑upload images with exact dimensions (192×192 and 512×512). |
| App still says “EazyClassroom” | PWA name not updated | Change your school name in Settings → Profile. |
| Classroom background missing | Logo upload failed | Re‑upload the main logo and ensure it is a valid PNG/JPG. |
| No install prompt on Android | Site not served over HTTPS (should be) | Check that you are using https://. Also, the user may have already installed it. |
| iOS users cannot install | Safari restrictions | Follow the manual “Add to Home Screen” steps – iOS does not support automatic prompts. |
7. Frequently Asked Questions (White‑Label PWA)
Is white‑label included in the free plan?
No. White‑label is only available on the School Plan ($15/month) and higher.
Can I use my own domain (e.g., class.myschool.com)?
This feature is planned for Q1 2027. Currently, the PWA is hosted at app.eazyclassroom.net. Contact support if you need a custom domain urgently.
Will the PWA work offline?
Basic offline caching works (the app shell loads). However, live classes require an internet connection.
How do I update the logo after changing it?
Upload the new logo in Settings → Branding. Then ask all users to re‑install the PWA (remove and add again). The new logo will appear after re‑installation.
Can I have different branding for teachers and parents?
No. The branding is global for your entire account. Teachers and parents see the same logos and name.
Do I need to regenerate the manifest manually?
No. The system regenerates the manifest automatically whenever you upload a new logo or change your school name.
What if I want to remove the PWA completely (stop offering it)?
You cannot disable the PWA – it is part of how EazyClassroom works. However, users are not forced to install it; they can continue using the website in a regular browser.
8. Advanced: Customising the PWA Name per Role
Currently, the PWA name is the same for all roles (taken from your school name). The internal manifest names are:
- Admin panel:
"name": "Admin Panel" - Teacher panel:
"name": "Teacher Panel" - Parent panel:
"name": "Parent Panel"
These appear when the app is installed from each role’s dashboard. The short name (under the icon) is your school name for all roles.
If you need more customisation, contact support for a white‑label enterprise plan.
9. Example: Installing Your Branded App
Scenario: Al‑Noor Academy uploads its logo and school name.
- Android user: Visits
app.eazyclassroom.net, logs in as a parent, sees the install banner, taps “Install”. The home screen now shows the Al‑Noor Academy logo. - iPhone user: Logs in via Safari, taps Share → “Add to Home Screen”. The icon appears with the Al‑Noor Academy name.
- Teacher on Windows: Logs in, clicks the install icon in Chrome, pins the app to the taskbar. Opens like a native app.
All users see the academy’s branding, never “EazyClassroom”.
10. Next Steps
- Upload your logos now – it takes only a few minutes.
- Test the installation on your own phone and computer.
- Inform your users via email or newsletter – include simple instructions for their device type.
Need help with white‑label branding? Contact support@eazyclassroom.net for assistance or to request custom domain support.