Help Center / Troubleshooting

Troubleshooting Guide

Fix common issues and get the most out of Baby Tracker.

Offline Mode & Sync Issues

Issue: Data is not syncing when back online.
Solution:
  1. Check your internet connection.
  2. Refresh the page - this triggers a sync attempt.
  3. Look for the pending sync badge in the navbar.
  4. If records are stuck, an administrator can clear the sync queue.

Photo Upload Issues

Issue: Photos are not uploading or showing 404 errors.
Solution:
  1. Check file size (max 5MB for profile pictures, 2MB for other photos).
  2. Use supported formats: JPG, PNG, GIF, WEBP.
  3. Verify the uploads directory has write permissions (755 on Linux).
  4. Clear browser cache and try again.

Session Timeout Issues

Issue: Session expires too quickly or too slowly.
Solution:
  1. Session timeout is configured by the administrator in the admin panel.
  2. Click "Extend Session" when the warning appears.
  3. Activity (clicks, typing, scrolling) automatically resets the timer.

Notification Issues

Issue: Notifications are not appearing or are delayed.
Solution:
  1. Ensure notifications are enabled in the admin settings.
  2. Notifications are checked every hour via cron job.
  3. Refresh the page to trigger a manual check.
  4. Sticky notifications persist until dismissed.

Chart Data Not Appearing

Issue: Growth charts or sleep charts show no data.
Solution:
  1. Ensure you have logged at least 2 weight measurements for growth charts.
  2. Check that you have selected the correct child.
  3. Try a different date range (Last Week, Last Month, All Time).
  4. Clear browser cache and refresh.

Browser Support

Supported Browsers:
  • Google Chrome (latest 2 versions)
  • Mozilla Firefox (latest 2 versions)
  • Apple Safari (latest 2 versions)
  • Microsoft Edge (latest 2 versions)
  • Mobile browsers (iOS Safari, Chrome for Android)
Not Supported: Internet Explorer, older versions of Chrome/Firefox/Safari

Clearing Cache and Hard Refresh

How to clear cache:
  • Chrome/Edge: Ctrl+Shift+Delete β†’ Clear cached images and files
  • Firefox: Ctrl+Shift+Delete β†’ Clear cache
  • Safari: Develop β†’ Empty Caches (enable Develop menu first)
  • Hard Refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)

Export / Backup Data

To export your baby's data:

  1. Go to the Dashboard page.
  2. Click the "Save Report" button to download a text summary.
  3. For full database backup, contact your system administrator.

Contact Support / Report Bug

How to report an issue:
  • Check the logs/ directory for error messages.
  • Note the steps to reproduce the issue.
  • Include browser version and operating system.
  • Contact your system administrator with the details.