Mobile App Overview
The Uni8 PWA mobile app feature lets you publish a branded Progressive Web App for your community. Members install it directly from their browser — no App Store submission required.
Plan Requirements
The Mobile App feature (moduleMobileApp) is available on Pro Network+, Builder, and Enterprise plans.
Publishing the mobile app to all members (publishMobileApp) requires the Enterprise plan. On lower plans you can configure and preview the app, but the Publish button shows an upgrade prompt.
| Capability | Pro Network+ | Builder | Enterprise |
|---|---|---|---|
| Access admin config page | Yes | Yes | Yes |
| Configure branding, nav, notifications | Yes | Yes | Yes |
| Try It (admin preview) | Yes | Yes | Yes |
| Publish to members | No | No | Yes |
If your plan does not include moduleMobileApp, the Mobile App settings page shows an "Unlock Feature: Mobile App" prompt instead of the configuration UI.
App Lifecycle
The mobile app moves through four states, visible as a status badge at the top of the settings page.
| Badge | Meaning |
|---|---|
| Off | Feature disabled. Members cannot install or access the app. |
| Draft | Enabled but not published. Admins can configure; no member access. |
| Try Mode | Admins can preview the app at /app/:tenant/* before going live. |
| Published | Live to all members. Members can install from the community site. |
Lifecycle Actions
| Current state | Available buttons | Result |
|---|---|---|
| Off | — | Toggle Enable the mobile app to reach Draft |
| Draft | Try It, Publish | Try It → Try Mode; Publish → Published (Enterprise only) |
| Try Mode | Stop Try, Publish | Stop Try → Draft; Publish → Published |
| Published | Re-publish, Unpublish | Re-publish pushes draft changes live; Unpublish → Draft |
Happy Path
- Go to Settings → Mobile App.
- Toggle Enable the mobile app to ON. Status badge changes to Draft.
- Configure branding, navigation tabs, push notifications.
- Click Try It to enter Try Mode and preview on your own devices.
- When satisfied, click Publish (Enterprise). Status badge changes to Published.
- Share the community URL with members. They will see an install prompt (see the member install guide).
- To push future changes live without downtime, click Re-publish.
Default Configuration
When you first enable the mobile app, the following defaults apply:
| Setting | Default |
|---|---|
| Bottom nav tabs visible | Feed, Spaces, Notifications, Me |
| Primary tab | Feed |
| App icon | Tenant logo (no custom icon) |
| Icon background | Solid white (#ffffff) |
| Splash screen | Enabled, white background, pulse animation |
| Install banner title | Install {Your Community Name} |
| Install banner description | "Add to your home screen for quick access" |
| Show banner on public page | ON |
| Route visibility (Events, Courses, Directory, Job Board, News) | All ON |
| Directory space mapping | Auto-detect (first directory space) |
| Jobs space mapping | All jobs (across spaces) |
Push notification defaults are documented in Push Notifications.
Where Settings Live
All mobile app configuration is stored in the Site.mobileAppConfig JSON field. Configuration is split across two tabs on the admin page:
- Design tab — Phone mockup preview + bottom navigation editor
- Settings tab (sheet) — App icon, splash screen, install banner, push notifications, route visibility
Next Steps
- Branding — Upload app icon and configure splash screen
- Navigation Tabs — Configure bottom navigation tabs
- Push Notifications — Set notification category defaults
- Preview and Publish — Try mode, simulator, and publishing