User Guide

Dashboard

The dashboard provides an overview of your app's status and quick access to key features.

App Settings

Configure your app's basic information, branding, and behavior.

Who Can Manage App Settings

• Main Admin: Can manage settings for all organizations and all apps.
• Organization: Can manage settings for apps owned by their organization.
• App Manager: Can manage settings for apps they are assigned to.

Organization settings (global limits/configuration) are only available to the main admin.

App Selection

Organizations and app managers must select the active app from the global app selector in the header. All settings, pages, onboarding, versions, and notifications apply to the selected app.

Accessing App Settings

Navigate to App Settings from the sidebar or visit /app-settings

Basic Information

Branding & Design

Color Scheme

Customize your app's colors using the color pickers:

• Primary Color: Main brand color for headers and buttons
• Secondary Color: Accent color for highlights

Feature Toggles

Enable or disable features by checking/unchecking the boxes:

• Pull to Refresh: Allow users to refresh by pulling down
• Exit Popup: Show confirmation when exiting app
• Hide Header: Hide the app toolbar
• Hide Footer: Hide bottom navigation
• Maintenance Mode: Show maintenance message to users

Custom Messages

• Share Message: Text shown when users share your app
• Offline Message: Message displayed when device is offline

App Versions

Manage app versions and force updates for your mobile applications.

Creating a New Version

1. Click App Versions in the sidebar
2. Click Create New Version button
3. Fill in the version details:
   • Version Name: Display version (e.g., "1.0.0")
   • Version Code: Numeric code (e.g., 1, 2, 3...)
   • Platform: Android, iOS, or Both
   • Release Notes: What's new in this version
   • Force Update: Require users to update
   • Status: Active or Inactive
4. Click Create Version

Managing Versions

• Edit: Click edit icon to modify version details
• Delete: Remove versions that are no longer needed
• View Logs: See version check history

Force Update

When enabled, users with older versions will be required to update before using the app.

Pages

Create custom pages to display in your mobile app (About, Privacy Policy, Terms, etc.).

Creating a Page

1. Go to Pages from the sidebar
2. Click Create New Page
3. Enter page details:
   • Title: Page title
   • Slug: URL-friendly identifier (e.g., "about-us")
   • Content: HTML content of the page
   • Status: Published or Draft
4. Click Create Page

Common Pages to Create

Accessing Pages

Pages are accessible via API at:

GET /api/pages/{slug}

Mobile apps can fetch and display these pages within the app.

Onboarding Screens

Create tutorial/welcome screens shown to first-time users.

Creating Onboarding Screens

1. Navigate to Onboarding
2. Click Create New Screen
3. Fill in the details:
   • Title: Screen heading
   • Description: Explanatory text
   • Image: Upload illustration (recommended: 1080x1080px)
   • Order: Display sequence (1, 2, 3...)
   • Status: Active or Inactive
4. Click Create Screen

Best Practices

• Keep screens to 3-5 for optimal user experience
• Use clear, concise messaging
• Highlight key features and benefits
• Use consistent visual style across screens
• Set proper order to control flow

Managing Screens

• Reorder: Change the order number to adjust sequence
• Edit: Update content and images
• Deactivate: Hide screens without deleting them

Push Notifications

Send push notifications to engage users and share updates.

Sending a Notification

1. Go to Push Notifications
2. Click Create Notification
3. Fill in notification details:
   • Title: Notification heading (max 255 chars)
   • Message: Notification body (max 1000 chars)
   • Action URL: Optional URL to open when tapped
   • Target Platform: All, Android only, or iOS only
4. Choose action:
   • Save as Draft: Save for later
   • Send Now: Send immediately

Target Platform Options

Notification Preview

The create page shows a live preview of how your notification will appear on devices.

Managing Notifications

• View: See notification details and delivery stats
• Edit: Modify draft notifications before sending
• Duplicate: Create a copy of existing notification
• Send: Send draft notifications
• Delete: Remove draft or failed notifications

Delivery Statistics

After sending, view detailed statistics:

• Total Tokens: Number of devices targeted
• Success Count: Successfully delivered
• Failure Count: Failed deliveries
• Sent At: Timestamp of delivery

Best Practices

Tips & Tricks