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.

1. Open Safari and navigate to app.leadmachine.fyi
2. Tap the Share button (square with arrow pointing up) at the bottom of Safari
3. Scroll down and tap "Add to Home Screen"
4. Name the app (default: "LeadMachine.fyi") and tap "Add"
5. 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

1. Open Chrome or Edge and navigate to app.leadmachine.fyi
2. Tap the three dots menu (⋮) in the top right
3. Tap "Install app" or "Add to Home Screen"
4. Confirm by tapping "Install"
5. 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

1. Open your browser and navigate to app.leadmachine.fyi
2. Look for the install icon (⊕ or ⬇) in the address bar
3. Click the icon and confirm installation
4. 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

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

Manual Setup

1. Open the app and navigate to your profile (top right)
2. Go to Settings tab
3. Scroll to "Push Notifications" section
4. Click "Enable Notifications" button
5. Allow when prompted
6. 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

• ✅ Installation status (PWA installed or browser)
• ✅ Notification permission status (Enabled, Not Enabled, or Blocked)
• ✅ Subscription status (Subscribed or Not Subscribed)

Note: The status page now detects your push subscription even when viewing in your browser (not just in the installed PWA). If you have push notifications enabled from a previous install, you'll see the correct "Push Notifications Enabled" status.

Test Notifications

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

Disable Notifications

1. Go to Profile → Settings → Push Notifications
2. Click "Disable Push Notifications" button
3. Confirm when prompted

You can re-enable anytime by clicking "Enable Notifications" again.

Blocked Notifications?

iOS:

1. Go to iPhone Settings → Notifications
2. Scroll to LeadMachine.fyi
3. Enable "Allow Notifications"
4. Return to the app and refresh

Android:

1. Go to Settings → Apps → LeadMachine
2. Tap Notifications
3. Enable notifications
4. Return to the app and refresh

Desktop:

1. Go to browser Settings → Privacy → Notifications
2. Find app.leadmachine.fyi
3. Change to "Allow"
4. 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?

1. Disable push notifications in settings (removes subscription)
2. Uninstall the PWA from your device
3. 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: January 2026