Troubleshooting - jgerton/mcp-mindfulness GitHub Wiki

Troubleshooting Guide

Quick Solutions

Can't Log In?

  1. Check Basics

    • Verify email address
    • Confirm password (case sensitive)
    • Clear browser cache
    • Try incognito/private window

  2. Still Having Issues?

    • Use password reset
    • Check email spam folder
    • Try different browser
    • Contact support

Practice Issues

Meditation Timer

Problem: Timer not working properly

  • Check device sound settings
  • Ensure app has permissions
  • Close other audio apps
  • Restart the app

Session Tracking

Problem: Progress not saving

  • Check internet connection
  • Verify logged in status
  • Complete full session
  • Manual record backup

Audio Problems

Problem: Can't hear guided sessions

  • Test device volume
  • Check mute switch
  • Try headphones
  • Update app

Group Session Issues

Connection Problems

Problem: Can't join online sessions

  1. Before Session:

    • Test internet speed
    • Update browser/app
    • Check system requirements
    • Join 5 minutes early

  2. During Session:

    • Refresh browser
    • Reconnect to internet
    • Use mobile data backup
    • Contact session host

Video Issues

Problem: Camera/video not working

  • Allow camera permissions
  • Close other video apps
  • Restart device
  • Use audio-only mode

Common Practice Challenges

Focus Difficulties

Solution Steps:

  1. Reduce session length
  2. Use guided practices
  3. Try different time of day
  4. Start with body awareness

Physical Discomfort

Solution Steps:

  1. Adjust posture
  2. Use support props
  3. Try different position
  4. Alternate sitting/walking

Time Management

Solution Steps:

  1. Start with 5 minutes
  2. Set regular schedule
  3. Use reminders
  4. Track progress

App Navigation

Can't Find Features

Solution:

  • Check menu options
  • Review tutorials
  • Use search function
  • Check help section

Notification Issues

Solution:

  • Check app permissions
  • Verify settings
  • Update app
  • Reset preferences

Account Management

Profile Updates

Problem: Can't update information

  • Clear form completely
  • Try different browser
  • Check required fields
  • Contact support

Subscription Issues

Problem: Access problems

  • Verify account status
  • Check payment method
  • Review confirmation email
  • Contact billing support

Getting More Help

When to Contact Support

  • Login problems persist
  • Technical errors repeat
  • Payment issues
  • Account problems
  • Security concerns

How to Report Issues

  1. Gather Information

    • Error messages
    • Steps to reproduce
    • Device/browser info
    • Screenshots (if possible)

  2. Contact Methods

    • In-app help
    • Email support
    • Community forum
    • Help center

Self-Help Resources

Prevention Tips

Avoid Common Issues

  1. Regular Maintenance

    • Update app/browser
    • Clear cache regularly
    • Check notifications
    • Review settings

  2. Practice Preparation

    • Test audio before sessions
    • Join early
    • Save backup contacts
    • Keep guides accessible

Best Practices

  • Save login information
  • Bookmark important pages
  • Follow setup guides
  • Keep app updated

Back to Home