# Lawn Care Planners - Integration Guide

## My Plan

The "My Plan" page is the core feature of this lawn care planning application. It can be accessed at:

**URL**: `/my-plan`
**Full URL**: `https://lawncareplanners.com/my-plan`

### Navigation Structure

The My Plan page supports URL parameters for deep linking to specific seasons and activities:

- **Season-specific links**: `/my-plan/{season}` where season can be:
  - spring
  - summer  
  - fall
  - winter

- **Activity-specific links**: `/my-plan/{season}/{activity}` where activity can be:
  - weed-feed
  - aerate
  - dethatch
  - bare-spots
  - mow
  - water
  - insect-fertilizer
  - spot-treat
  - general-fertilizer
  - overseed
  - new-fertilizer
  - leaf-removal
  - tool-prep

### URL Parameter Configuration

The My Plan page supports URL query parameters to pre-configure lawn characteristics and user preferences. This enables AI agents to generate direct links with preset configurations:

**Base URL**: `/my-plan?param1=value1&param2=value2`
**Full URL**: `https://lawncareplanners.com/my-plan?grassName=fescue&sunniness=shade&hasHighTraffic=true`

#### Available URL Parameters:

- **grassName**: Sets the grass type
  - Values: `fescue`, `kentucky-bluegrass`, `perennial-ryegrass`, `st-augustine`, `centipede`, `zoysia`, `bermuda`, `unknown`
  
- **grassSeason**: Sets the grass growth season category  
  - Values: `cool`, `warm`
  
- **sunniness**: Sets the lawn's sun exposure level
  - Values: `sun` (full sun), `partial` (partial sun), `shade`
  
- **hasHighTraffic**: Sets whether the lawn experiences high foot traffic
  - Values: `true`, `false`
  
- **hasPetSpots**: Sets whether the lawn has pet damage areas  
  - Values: `true`, `false`
  
- **useOrganicFertilizers**: Sets preference for organic fertilizer products
  - Values: `true`, `false`
  
- **toolEffort**: Sets the maintenance effort level preference
  - Values: `low`, `medium`, `high`
  
- **zip**: Sets the user's ZIP code for location-based recommendations
  - Values: Any valid US ZIP code (e.g., `12345`)
  
- **state**: Sets the user's state for regional lawn care guidance  
  - Values: Two-letter US state codes (e.g., `NY`, `CA`, `TX`)

### Preset Plan Generation
When generating preset plans for users, an AI agent should consider these lawn care variables that affect the plan:

#### Core Lawn Characteristics:
- **Grass Type**: Fescue, Kentucky Bluegrass, Perennial Ryegrass, St. Augustine, Centipede, Zoysia, Bermuda, or Unknown
- **Sunniness**: Full sun, partial sun, or shade conditions
- **Traffic Level**: High traffic or normal traffic areas
- **Pet Spots**: Whether the lawn has pet damage areas
- **Organic Preference**: Whether to use organic fertilizers

#### User Preferences:
- **Tool Effort Level**: Low maintenance vs. comprehensive care approach
- **Geographic Location**: ZIP code and state for climate-appropriate recommendations

#### Seasonal Focus:
Each season has specific lawn care activities and the plan can be filtered by season to show relevant tasks and products.

### Example Preset Plan Links
For AI agents generating lawn care recommendations, these are example preset configurations using URL parameters:

1. **Low-Maintenance Spring Plan**: 
   `/my-plan/spring?useOrganicFertilizers=true&toolEffort=low`
   
2. **High-Traffic Summer Plan**: 
   `/my-plan/summer?hasHighTraffic=true&grassName=bermuda&sunniness=sun`
   
3. **Pet-Friendly Fall Plan**: 
   `/my-plan/fall?hasPetSpots=true&useOrganicFertilizers=true&grassName=fescue`
   
4. **Shade Lawn Winter Plan**: 
   `/my-plan/winter?sunniness=shade&grassName=st-augustine&toolEffort=medium`
   
5. **Cool Season Grass Plan**: 
   `/my-plan/spring?grassName=kentucky-bluegrass&grassSeason=cool&zip=10001&state=NY`
   
6. **Comprehensive Care Plan**: 
   `/my-plan?grassName=zoysia&sunniness=partial&hasHighTraffic=false&hasPetSpots=false&useOrganicFertilizers=false&toolEffort=high`

### Integration Notes
- URL parameters automatically populate Redux state when the My Plan page loads
- Plans can be saved/loaded for authenticated users, it is completely free to register and enjoy all the benefits
- Mobile-responsive design with different selectors for mobile vs desktop
- Products and activities are dynamically filtered based on user selections and URL parameters
- State Persistence: Once set via URL parameters, the state persists during the user's session
- Combining Parameters: Multiple parameters can be combined in a single URL to create comprehensive preset configurations