RailScanPro is a server-rendered application — most performance issues are either network-related or browser-related, not server-related. Here's how to diagnose and fix them.
Quick Fixes (Try These First)
- Refresh the page — Ctrl+R (Windows) or Cmd+R (Mac)
- Clear your browser cache — Settings → Privacy → Clear Browsing Data → Cached Images and Files
- Try a different browser — Chrome and Edge tend to be the fastest for Blazor apps; Safari can be slower on complex pages
- Close other tabs — especially if other tabs are running video or large web apps
- Check your internet connection — run a quick speed test at fast.com. You need at least 5 Mbps for photo upload
Photo Uploads Are Slow
Photo uploads are limited by your internet upload speed (not download speed). Most home connections have asymmetric speeds — e.g., 100 Mbps download but only 10 Mbps upload.
- A 5 MB photo takes about 4 seconds on a 10 Mbps upload connection
- Bulk uploads of 50+ photos may take several minutes
Tips:
- Upload photos when not streaming video on the same connection
- If your ISP offers fiber, the symmetric upload speeds make a noticeable difference
- Upload on WiFi close to your router — 5 GHz bands are faster than 2.4 GHz
AI Recognition Is Slow
AI recognition typically completes in 3–5 seconds. If it's taking 20+ seconds:
- Try a smaller photo — photos over 10 MB are resized before AI processing, adding time. Your phone's default resolution (4–8 MB) is optimal.
- Check service status — go to
/statusto see if the AI vision service is experiencing delays - Reduce batch size — for bulk uploads, the AI processes photos in parallel but queues them. 10 at a time is the sweet spot.
Pages Loading Slowly
RailScanPro uses Blazor Server, which maintains a persistent WebSocket connection to the server. If that connection is unstable, the UI feels laggy.
Signs of WebSocket issues:
- Pages "hang" for 3–5 seconds then respond
- The bottom of the browser shows a reconnecting indicator
- The navigation breadcrumb shows "Reconnecting..."
Fixes:
- Move closer to your router, or plug in via Ethernet
- Disable VPN — some VPNs route traffic through distant servers
- If on corporate WiFi, some network configurations block WebSocket connections — try your phone's mobile data as a test
Large Collections (1,000+ Items)
If you have a very large inventory, the Asset Management list view may feel slower when loading:
- Use Filters to narrow the view before loading — don't load all 2,000 items at once
- Enable Compact View (grid icon → Compact) to show more items with less rendering overhead
- Use Collections to segment your inventory into smaller working subsets
Checking Service Status
If nothing above helps, check whether it's a platform issue:
- Go to railscanpro.com/status
- Look for any incidents affecting your region or the AI service
If there's a known incident, it will show there with an estimated resolution time.
Next Steps
- Sync Not Working — mobile/web data sync troubleshooting
- Login Issues — if slow performance is accompanied by login errors