Provider Help & Documentation

Everything you need to know about managing your business with LawnSnowPro

Getting Started

1. Sign Up & Set Up Your Business

Create your account and set up your business profile. You'll be assigned the OWNER role with full access to all features.

  • Add your business name, address, and contact information
  • Configure your subscription and billing preferences
  • Set up your initial settings and preferences

2. Define Your Service Areas

Set up the ZIP codes where you provide services to receive qualified leads:

  • Navigate to Dashboard → Service Areas
  • Create service areas with names (e.g., "Downtown Austin", "North Side")
  • Add ZIP codes one at a time for each area
  • Choose service type: Lawn Care, Snow Removal, or Both
  • Mark areas as active to start receiving leads

3. Add Your Team

Invite team members and assign them appropriate roles:

  • OWNER - Full access to all features and settings
  • DISPATCHER - Manage routes, schedules, leads, and customer communication
  • FIELD_OPERATOR - View assigned routes, update job status, track GPS

4. Add Customers & Properties

Import or manually add your customer base with their service properties. Each customer can have multiple properties.

  • Add customer contact information
  • Create properties with addresses and service details
  • Set priority tiers (STANDARD, PRIORITY, PREMIUM)
  • Assign service templates for recurring work

5. Enable Weather Monitoring (Optional)

Set up weather API keys to enable automated storm detection and route generation:

  • OpenWeatherMap API for current conditions
  • Visual Crossing API for detailed forecasts
  • Weather.gov (NOAA) for official alerts (no API key needed)

Lead Generation System

Service Areas & Lead Matching

Define your coverage areas to automatically receive qualified leads from customers in your service zones.

  • Create multiple service areas with different ZIP codes
  • Specify service type for each area (Lawn, Snow, or Both)
  • AI-powered matching connects customer requests with your areas
  • Only active service areas receive leads
  • Real-time email notifications when new leads arrive

Lead Notifications

Get instant notifications when customers in your area request service.

  • Email notifications with full customer details
  • Customer contact information (email, phone, name)
  • Property address and service description
  • Detected service type and specific services needed
  • Matched service areas for your reference
  • Direct link to lead detail page in dashboard

Lead Management Dashboard

View, respond to, and track all your leads from one central location.

  • Dashboard → Leads to view all incoming requests
  • Filter by status: NEW, CONTACTED, QUOTED, WON, LOST
  • See customer details and service requirements
  • Add internal notes and customer-visible responses
  • Track conversation history with timestamps
  • Update lead status as you progress through your sales process

AI Service Detection

Our AI automatically analyzes customer descriptions to determine service type and specific needs.

  • 100+ lawn care keywords (mowing, fertilizing, aeration, cleanup, etc.)
  • 60+ snow removal keywords (plowing, shoveling, salting, etc.)
  • Multi-category detection (identifies specific services needed)
  • Confidence scoring (high/medium/low match accuracy)
  • Seasonal fallback for ambiguous requests

Key Features

Real-Time GPS Tracking

Field operators can broadcast their location while on routes. Dispatchers and customers can view crew locations on a live map.

  • Field operators start GPS tracking from route detail page
  • Location broadcasts every 30 seconds
  • View all active crews on the Live Map dashboard
  • Customers can see estimated arrival times
  • Automatic arrival notifications

Multi-Source Weather Aggregation

Get the most accurate weather data by aggregating forecasts from three trusted sources.

  • OpenWeatherMap for current conditions and short-term forecasts
  • Visual Crossing for detailed hourly and daily forecasts
  • Weather.gov (NOAA) for official government alerts
  • Consensus algorithm calculates confidence scores
  • Zone-based monitoring for multi-area coverage

Automated Storm Response

Automatically detect snow events and generate priority-based routes.

  • Automatic storm detection based on snowfall thresholds
  • Routes generated by priority tier (PREMIUM → PRIORITY → STANDARD)
  • Crew and customer notifications sent automatically
  • Optimized routing minimizes drive time
  • Test storm detection from Demo page

Intelligent Route Planning

Create efficient routes with automatic optimization and time estimates.

  • Drag-and-drop route builder
  • Automatic distance and time calculations
  • Respect customer time windows and priority tiers
  • Assign routes to field operators
  • Track completion status in real-time

Smart Scheduling

Schedule recurring jobs with weather-aware rescheduling suggestions.

  • Create one-time or recurring jobs
  • Weather-based reschedule recommendations
  • Seasonal mode switching (Lawn vs. Snow)
  • Customer approval workflows
  • Automatic customer notifications

Invoicing & Payments

Generate invoices from completed jobs and accept online payments.

  • Automatic invoice generation from job completion
  • Flexible pricing models (per-service, per-inch, seasonal)
  • Online payment processing (Stripe integration ready)
  • Payment tracking and history
  • Customer portal for invoice viewing

Frequently Asked Questions

How do leads work?

When customers submit service requests, our AI analyzes their description to determine service type (lawn, snow, or both). We then match them with all active service areas that cover their ZIP code and service type. You'll receive an email notification with full customer details and can respond through your dashboard.

How do I set up service areas?

Go to Dashboard → Service Areas and click 'Add Service Area'. Give it a name (e.g., 'Downtown Austin'), select the service type (Lawn, Snow, or Both), and add ZIP codes one at a time. Make sure to mark it as Active to start receiving leads. You can edit or deactivate areas anytime.

What types of service requests will I receive?

You'll only receive leads for service types you've specified in your service areas. If you set an area to 'Lawn Care Only', you won't receive snow removal requests. Our AI detects over 100 lawn keywords (mowing, fertilizing, cleanup, etc.) and 60 snow keywords (plowing, salting, etc.).

How do I respond to leads?

Click on any lead in your Leads dashboard to view full details. You can add notes (internal or customer-visible), update the status as you progress, and track all communication history. Customer-visible notes are sent via email to the customer automatically.

Can I pause lead generation temporarily?

Yes! Simply mark your service areas as Inactive in Dashboard → Service Areas. You'll stop receiving new leads but can reactivate anytime. This is useful during busy periods or seasonal shutdowns.

How do I enable GPS tracking for my crew?

Field operators can start GPS tracking from their assigned route detail page. They'll see a 'GPS Tracking' card with a 'Start GPS Tracking' button. The system requires browser location permission. Once started, location broadcasts every 30 seconds to the live map.

What weather APIs do I need?

For full weather functionality, you'll need API keys from OpenWeatherMap and Visual Crossing. Weather.gov (NOAA) doesn't require an API key. You can operate with just one source, but three sources provide the most accurate consensus forecasts.

How does automated storm response work?

When storm monitoring is enabled, the system checks weather every hour. If snow accumulation exceeds your threshold (default 2 inches in 24 hours), it automatically generates routes for all active snow removal customers, sorted by priority tier, and sends notifications to crews and customers.

Can customers track my crew in real-time?

Yes! When a field operator starts GPS tracking on an active route, customers assigned to that route can view the crew's live location and estimated arrival time from their customer portal.

What's the difference between priority tiers?

Priority tiers determine the order of service during storms: PREMIUM customers are serviced first, then PRIORITY, then STANDARD. This ensures your highest-value customers get priority treatment during high-demand events.

Can I customize job templates?

Yes! Go to Settings → Job Templates to create custom templates for different service types (mowing, plowing, salting, etc.). Each template can have a default duration, pricing, and required equipment.

How do I test GPS and weather features?

Owners and Dispatchers can access the Demo & Testing page from the dashboard. This page allows you to test GPS broadcasting and weather storm detection with one click, without affecting live operations.

Troubleshooting

Not Receiving Leads

  • Verify service areas are marked as Active
  • Check that ZIP codes are entered correctly (5 digits)
  • Ensure subscription status is ACTIVE or TRIALING
  • Confirm email settings are correct in your profile
  • Check spam/junk folder for lead notifications

GPS Tracking Not Working

  • Check browser location permissions (Settings → Privacy → Location)
  • Ensure HTTPS is enabled (geolocation requires secure connection)
  • Try disabling browser extensions that block location access
  • On mobile, ensure location services are enabled in device settings
  • Check that the route status is IN_PROGRESS or PUBLISHED

Weather Data Not Loading

  • Verify API keys are correctly set in environment variables
  • Check that STORM_MONITORING_ENABLED=true in settings
  • Ensure service zones are configured with valid ZIP codes
  • Test individual APIs from the Demo page to identify failures
  • Check API rate limits haven't been exceeded

Routes Not Generating Automatically

  • Confirm storm monitoring is enabled
  • Verify customers have active snow removal contracts
  • Check that properties have valid addresses and coordinates
  • Ensure field operators are available and active
  • Review storm detection threshold settings

Lead Detail Page Issues

  • Ensure you have OWNER or DISPATCHER role permissions
  • Refresh the page if notes aren't updating
  • Check internet connection for real-time updates
  • Clear browser cache if status changes aren't saving

Customer Portal Issues

  • Verify customer accounts are properly created and activated
  • Check that properties are linked to the correct customer
  • Ensure jobs are published (not in DRAFT status)
  • Test customer login credentials
  • Clear browser cache and cookies

Still Need Help?

Our support team is here to help you succeed.

Email: support@lawnsnowpro.app

Available: Monday - Friday, 8am - 6pm EST

Response time: Within 24 hours