Progressive Web App & Push Notifications

LeadMachine is available as a Progressive Web App (PWA) that you can install directly to your phone or computer's home screen. Once installed, you'll receive instant push notifications when leads are assigned to you - completely free with no SMS charges.


Why Use the LeadMachine App?

🔔 Instant Push Notifications

  • Get notified immediately when leads are assigned to you
  • See lead name and contact info right in the notification
  • Tap to open the lead directly in the app
  • 100% FREE - no SMS fees or charges
  • âš¡ Works Offline

  • Access your leads even without internet
  • View cached lead data when offline
  • Automatic sync when you're back online
  • 🚀 Fast & Native-Like

  • Launches instantly from your home screen
  • No need to open browser and navigate
  • Full-screen experience without browser UI
  • Uses device resources efficiently
  • 💾 Saves Data

  • Intelligent caching reduces data usage
  • Works great on limited data plans
  • Faster than loading in browser each time
  • 🔢 App Badge

  • See notification and task counts on the app icon
  • Badge updates automatically when you have pending items
  • Clear at a glance whether you have items requiring attention
  • 🔄 Automatic Updates

  • App updates automatically when new versions are released
  • You'll see an "Update available" banner when there's a new version
  • Just tap "Refresh Now" to get the latest features

  • Installing the PWA

    iOS (iPhone/iPad) - Safari Required

    > Note: Push notifications on iOS require iOS 16.4 or later and Safari browser.

  • Open Safari and navigate to app.leadmachine.fyi
  • Tap the Share button (square with arrow pointing up) at the bottom of Safari
  • Scroll down and tap "Add to Home Screen"
  • Name the app (default: "LeadMachine.fyi") and tap "Add"
  • The app icon will appear on your home screen
  • Alternative: You may see a banner at the bottom of the screen with install instructions. Follow those if shown.

    Android - Chrome or Edge

  • Open Chrome or Edge and navigate to app.leadmachine.fyi
  • Tap the three dots menu (â‹®) in the top right
  • Tap "Install app" or "Add to Home Screen"
  • Confirm by tapping "Install"
  • The app will be added to your home screen and app drawer
  • Alternative: You may see an "Install" banner at the bottom of the screen. Tap "Install" to proceed.

    Desktop - Chrome, Edge, or Brave

  • Open your browser and navigate to app.leadmachine.fyi
  • Look for the install icon (⊕ or ⬇) in the address bar
  • Click the icon and confirm installation
  • The app will open in its own window and be added to your applications
  • Alternative: Click the three dots menu → "Install LeadMachine" or "Install app"


    Enabling Push Notifications

    After installing the PWA, you'll be prompted to enable push notifications. Here's what to expect:

    First Launch

  • Open the installed app from your home screen (first time)
  • Wait 3 seconds - a modal will appear asking to enable notifications
  • Tap "Enable Notifications"
  • Allow when your device prompts for permission
  • Done! You'll now receive push notifications
  • Manual Setup

    If you dismissed the prompt or need to enable later:

  • Open the app and navigate to your profile (top right)
  • Go to Settings tab
  • Scroll to "Push Notifications" section
  • Click "Enable Notifications" button
  • Allow when prompted
  • Send Test Notification to verify it's working
  • What Notifications You'll Receive

    New Lead Assignments

  • Notification appears when a lead is assigned to you
  • Shows lead name and contact info (email or phone)
  • Tap to open the lead directly
  • Task Assignments

  • Notification appears when someone assigns a task to you
  • Shows who assigned it and the task title
  • Tap to go directly to your tasks
  • Format Examples:

    
    🔔 New Lead Assigned
    John Smith - [email protected]

    🔔 New Task Assigned Mike assigned you: Follow up with client


    Managing Notification Settings

    View Your Status

    Go to Profile → Settings → Push Notifications to see:
  • ✅ Installation status (PWA installed or browser)
  • ✅ Notification permission status (Enabled, Not Enabled, or Blocked)
  • ✅ Subscription status (Subscribed or Not Subscribed)
  • Test Notifications

  • Navigate to Profile → Settings → Push Notifications
  • Ensure you see "Push Notifications Enabled" with green checkmark
  • Click "Send Test Notification" button
  • You should receive a test notification on your device
  • Disable Notifications

    If you no longer want push notifications:

  • Go to Profile → Settings → Push Notifications
  • Click "Disable Push Notifications" button
  • Confirm when prompted
  • You can re-enable anytime by clicking "Enable Notifications" again.

    Blocked Notifications?

    If you previously blocked notifications:

    iOS:

  • Go to iPhone Settings → Notifications
  • Scroll to LeadMachine.fyi
  • Enable "Allow Notifications"
  • Return to the app and refresh
  • Android:

  • Go to Settings → Apps → LeadMachine
  • Tap Notifications
  • Enable notifications
  • Return to the app and refresh
  • Desktop:

  • Go to browser Settings → Privacy → Notifications
  • Find app.leadmachine.fyi
  • Change to "Allow"
  • Refresh the app

  • Troubleshooting

    Not Receiving Notifications?

    Check Installation:

  • Make sure you installed the PWA (not just bookmarked)
  • Look for the app icon on your home screen
  • App should open in full screen without browser UI
  • Check Permissions:

  • Go to Profile → Settings → Push Notifications
  • Status should show "Push Notifications Enabled"
  • If not, click "Enable Notifications" and allow
  • Check Device Settings:

  • Ensure notifications aren't blocked in device settings
  • Check Do Not Disturb isn't active
  • Verify Focus modes aren't blocking notifications (iOS)
  • iOS Specific:

  • Requires iOS 16.4 or later
  • Must be installed via Safari (not Chrome/Firefox)
  • Check Settings → Notifications → LeadMachine.fyi
  • Send a Test:

  • Use the "Send Test Notification" button in settings
  • If test works but lead assignments don't, contact support
  • "Not Supported" Message in Browser?

    You're viewing in a regular browser tab, not the installed PWA:

  • Click the "Add App" button shown
  • Follow installation instructions for your device
  • Notifications only work in the installed PWA
  • Install Prompt Not Showing?

    iOS:

  • Must use Safari browser (not Chrome, Firefox, etc.)
  • Open app.leadmachine.fyi in Safari
  • Manually tap Share → Add to Home Screen
  • Android/Desktop:

  • Try refreshing the page
  • Check if you dismissed it previously
  • Use browser menu → Install app manually
  • App Not Opening in Full Screen?

    This means it wasn't installed correctly:

  • Delete the icon from home screen
  • Follow installation instructions again carefully
  • Ensure you selected "Add to Home Screen" (iOS) or "Install app" (Android)

  • Privacy & Data

    What Data is Stored?

  • Your push notification subscription (endpoint, encryption keys)
  • Your device information (user agent)
  • Timestamps of last notification sent
  • Can Others See My Notifications?

  • No - push notifications are private to your device only
  • Only you receive notifications for leads assigned to you
  • Each device you install on gets its own subscription
  • How to Remove All Data?

  • Disable push notifications in settings (removes subscription)
  • Uninstall the PWA from your device
  • Clear browser data for app.leadmachine.fyi

  • Frequently Asked Questions

    Q: Do I need the PWA for push notifications? A: Yes, push notifications only work in the installed PWA, not in a regular browser tab.

    Q: Can I install on multiple devices? A: Absolutely! Install on your phone, tablet, and computer. Each will receive notifications independently.

    Q: Will I still receive email notifications? A: Yes, email notifications are separate and controlled in Email Preferences (if configured by your admin).

    Q: What's the difference between SMS and push? A: Push notifications are instant, free, and work through the app. SMS requires a phone number and may incur carrier charges. Push is recommended for all users.

    Q: Do push notifications work offline? A: You need internet to receive notifications, but the PWA itself works offline for viewing cached leads.

    Q: Can I customize which notifications I receive? A: Currently all lead assignment notifications are sent. Additional preferences coming soon.

    Q: How do I uninstall the PWA? A:

  • iOS: Long press the app icon → Remove App → Delete
  • Android: Long press → Uninstall or App info → Uninstall
  • Desktop: Right-click app → Uninstall or go to browser settings
  • Q: Is this safe and secure? A: Yes! Push notifications use industry-standard encryption (VAPID). Your data is never shared with third parties.


    Support

    Having trouble with the PWA or push notifications?

  • Test Your Setup: Use the "Send Test Notification" button in Profile → Settings
  • Check Requirements: iOS 16.4+, Safari (iOS), Chrome/Edge (Android/Desktop)
  • Contact Support: Click the headset icon (🎧) in the navigation bar or email [email protected]

Last Updated: December 2025