# Performance Issues (https://yapl.app/en/docs/troubleshooting/performance)

# Performance Issues

Solutions for slow loading, unresponsive features, and general performance problems.

## Quick Performance Fixes

Try these first before detailed troubleshooting:

1. **Refresh the page** - Ctrl+R (Windows) or Cmd+R (Mac)
2. **Close unused tabs** - Free up browser memory
3. **Clear browser cache** - Remove old cached data
4. **Update your browser** - Latest version has best performance
5. **Check internet speed** - Run a speed test

## Slow Page Loading

### Initial Page Load Slow

**Symptoms:**
- Pages take long to appear
- Spinner shows for extended time
- Blank screen before content

**Solutions:**

1. **Clear browser cache**
   - Chrome: Settings > Privacy > Clear browsing data
   - Select "Cached images and files"
   - Reload the page

2. **Check internet connection**
   - Run a speed test
   - Try different network if possible
   - Restart router/modem

3. **Disable browser extensions**
   - Extensions can slow page loads
   - Try incognito mode to test

4. **Update browser**
   - Older browsers are slower
   - Install latest version

### Navigation Between Pages Slow

**If switching between sections is slow:**

1. Keep fewer browser tabs open
2. Close other applications
3. Check device memory usage
4. Try a browser with better performance (Chrome recommended)

## Large Data Sets

### Plans with Many Tasks

Large plans (hundreds of tasks) require more processing:

**Optimization tips:**

1. **Use filters**
   - Show only relevant tasks
   - Filter by status, assignee, or date

2. **Collapse hierarchies**
   - Collapse parent tasks you're not working on
   - Expand only what you need

3. **Consider splitting plans**
   - Break large plans into phases
   - Use multiple plans for different aspects

### Long Task Lists

**If task lists are slow:**

1. Use pagination (if available)
2. Apply filters to reduce visible tasks
3. Search for specific tasks instead of scrolling

### Gantt Chart Performance

Gantt charts with many tasks can be slow:

1. **Zoom to relevant timeframe**
   - Don't view entire project timeline
   - Focus on current period

2. **Filter visible tasks**
   - Show only relevant tasks
   - Hide completed tasks

3. **Reduce timeline range**
   - Shorter date ranges render faster

## Browser-Specific Issues

### Chrome Performance

1. **Clear cache**
   - Menu > Settings > Privacy > Clear browsing data

2. **Check extensions**
   - Menu > Extensions
   - Disable unnecessary extensions

3. **Reset Chrome** (last resort)
   - Settings > Reset and clean up

### Firefox Performance

1. **Refresh Firefox**
   - Menu > Help > Troubleshooting Information
   - Click "Refresh Firefox"

2. **Disable hardware acceleration**
   - Settings > General > Performance
   - Uncheck "Use hardware acceleration"

### Safari Performance

1. **Clear website data**
   - Preferences > Privacy > Manage Website Data

2. **Reset Safari** (last resort)
   - Safari > Clear History

### Edge Performance

1. **Clear browsing data**
   - Settings > Privacy > Choose what to clear

2. **Reset Edge settings**
   - Settings > Reset settings

## Memory Issues

### Signs of Memory Problems

- Browser becomes sluggish over time
- "Page Unresponsive" errors
- System slowdown

### Solutions

1. **Close other tabs**
   - Each tab uses memory
   - Keep only necessary tabs open

2. **Restart browser**
   - Closes all tabs and frees memory
   - Reopen needed tabs fresh

3. **Close other applications**
   - Free up system memory
   - Especially resource-heavy apps

4. **Restart your device**
   - Clears all memory
   - Fresh start often helps

## Network-Related Performance

### Slow Internet Connection

**Test your connection:**
1. Run a speed test (fast.com or speedtest.net)
2. Compare with your expected speed
3. Contact ISP if significantly slower

**Minimum requirements:**
- Download: 5 Mbps or higher recommended
- Latency: Under 100ms for best experience

### Unstable Connection

**Symptoms:**
- Intermittent loading
- Random disconnections
- Actions not saving

**Solutions:**
1. Move closer to WiFi router
2. Use wired connection if possible
3. Restart router/modem
4. Check for network interference

### VPN Impact

VPNs can slow down connections:
1. Try disabling VPN temporarily
2. Connect to closer VPN server
3. Use split tunneling if available

### Corporate Network Issues

If on corporate network:
1. Check with IT about firewall rules
2. Verify YAPL domains are whitelisted
3. Ask about network throttling policies

## Feature-Specific Performance

### Dashboard Loading Slow

1. Dashboard loads multiple data sources
2. First load after login is slower
3. Subsequent loads use cached data

### Kanban Board Slow

With many cards:
1. Use status filters
2. Archive completed tasks
3. Limit visible columns

### Resource Management Slow

With many resources:
1. Use search instead of scrolling
2. Apply filters
3. Work with smaller resource groups

## Device Performance

### Mobile Performance

Mobile devices may be slower:
1. Close background apps
2. Use latest iOS/Android version
3. Clear app cache
4. Restart device periodically

### Older Devices

On older hardware:
1. Use a simpler browser
2. Keep fewer tabs open
3. Don't run other heavy applications
4. Consider device upgrade

### Low Memory Devices

With limited RAM:
1. Close all unnecessary apps
2. Use browser memory saver features
3. Keep only one YAPL tab open
4. Restart device before heavy use

## Diagnostic Steps

### Check Browser Console

1. Open Developer Tools (F12)
2. Go to Console tab
3. Look for errors (red text)
4. Note any error messages for support

### Check Network Tab

1. Open Developer Tools (F12)
2. Go to Network tab
3. Reload the page
4. Look for:
   - Failed requests (red)
   - Slow requests (high ms)

### Test in Incognito Mode

1. Open incognito/private window
2. Log into YAPL
3. Test if performance is better
4. If yes, an extension may be the cause

## When Performance Issues Are Server-Side

### Signs of Server Issues

- Everyone experiences slowness
- Specific features consistently slow
- Error messages about server

### What to Do

1. Wait a few minutes and retry
2. Check status page if available
3. Try again later
4. Contact support if persistent

## Optimization Best Practices

### Daily Habits

1. Close unused tabs
2. Clear cache weekly
3. Restart browser daily
4. Keep browser updated

### Project Organization

1. Archive completed projects
2. Don't exceed task limits
3. Use filters effectively
4. Break large plans into smaller ones

### Account Management

1. Remove inactive team members
2. Archive old data regularly
3. Clean up unused resources

## Still Having Performance Issues?

If problems persist after trying these solutions:

1. Note specific slow features
2. Try at different times of day
3. Test on different device/network
4. [Contact support](/contact) with:
   - Browser and version
   - Device type
   - Internet speed test results
   - Specific features that are slow
   - When slowness occurs