Skip to content

USER_TESTING_GUIDE.md

Latest commit

 

History

History
190 lines (155 loc) · 4.97 KB

USER_TESTING_GUIDE.md

File metadata and controls

190 lines (155 loc) · 4.97 KB

InnerSpace User Testing Guide

🎯 Testing Objectives

Primary Goals:

  1. Verify authentication works smoothly
  2. Test user experience for teenagers
  3. Identify any bugs or issues
  4. Gather feedback on usability

🧪 Testing Scenarios

Scenario 1: First-Time User (Anonymous)

Instructions for testers:

  1. Visit http://localhost:3000
  2. Click "Get Started" or "Sign In"
  3. Click the "Anonymous" tab
  4. Click "Start Anonymous Session"
  5. Try using the app features (check-in, journal, etc.)
  6. Check if data persists on page refresh

Expected behavior:

  • ✅ Modal opens with three tabs
  • ✅ Anonymous mode activates without account
  • ✅ User can access all features
  • ✅ Data saves locally
  • ✅ No login required

Scenario 2: New User Registration

Instructions for testers:

  1. Click "Sign In" button
  2. Click "Sign Up" tab
  3. Enter a username (e.g., "testuser")
  4. Enter an email (e.g., "test@example.com")
  5. Enter a password (e.g., "password123")
  6. Click "Create Account"
  7. Check email for verification (if enabled)

Expected behavior:

  • ✅ Form validation works
  • ✅ Account creation succeeds
  • ✅ Success message appears
  • ✅ User profile shows in navigation

Scenario 3: Existing User Login

Instructions for testers:

  1. Click "Sign In" button
  2. Click "Sign In" tab
  3. Enter email and password from Scenario 2
  4. Click "Sign In"

Expected behavior:

  • ✅ Login succeeds
  • ✅ Welcome message shows username
  • ✅ User profile appears in navigation
  • ✅ All features work with account

Scenario 4: User Profile & Settings

Instructions for testers:

  1. Click on user profile (avatar) in navigation
  2. Check dropdown menu options
  3. Try "Sign Out" option
  4. Verify logout works

Expected behavior:

  • ✅ Profile dropdown opens
  • ✅ Shows user information
  • ✅ Sign out works properly
  • ✅ Returns to unauthenticated state

Scenario 5: Error Handling

Instructions for testers:

  1. Try signing in with wrong password
  2. Try signing up with existing email
  3. Try submitting empty forms
  4. Check error messages

Expected behavior:

  • ✅ Clear error messages appear
  • ✅ Form validation prevents empty submissions
  • ✅ Helpful error descriptions

🔍 What to Look For

✅ Positive Indicators:

  • Smooth transitions between states
  • Clear feedback for all actions
  • Intuitive navigation and layout
  • Fast loading times
  • Responsive design on different screen sizes

❌ Issues to Report:

  • Broken functionality (buttons not working)
  • Confusing error messages
  • Slow loading or freezing
  • Layout problems on mobile/desktop
  • Data not saving properly
  • Authentication failures

📊 Test Panel Information

When logged in, a test panel appears in the bottom-right corner showing:

  • User ID
  • Email address
  • Username
  • Authentication provider
  • Session status
  • Loading state
  • Account creation date

This helps verify authentication is working correctly.

🎨 UI/UX Feedback Areas

Design Questions:

  1. Is the interface teen-friendly?
  2. Are the colors and fonts appropriate?
  3. Is the navigation intuitive?
  4. Are the buttons and links clear?

Functionality Questions:

  1. Is the authentication process clear?
  2. Are the error messages helpful?
  3. Does the app feel secure and private?
  4. Is anonymous mode easy to understand?

Content Questions:

  1. Are the prompts and questions appropriate for teenagers?
  2. Is the language accessible and not too formal?
  3. Do the features feel useful and engaging?

🐛 Bug Reporting Format

If you find issues, please report them with:

Bug Title: Brief description Steps to Reproduce:

  1. Step 1
  2. Step 2
  3. Step 3 Expected Behavior: What should happen Actual Behavior: What actually happened Device/Browser: What you're using Screenshots: If applicable

🚀 Testing Checklist

Authentication Flow:

  • Sign In button appears
  • Modal opens correctly
  • All three tabs work
  • Form validation works
  • Error messages are clear
  • Success messages appear
  • User profile shows after login
  • Sign out works

User Experience:

  • Loading states work
  • Navigation updates properly
  • Welcome message is personalized
  • Anonymous mode works
  • Data persists correctly
  • No console errors

Mobile Testing:

  • Works on mobile devices
  • Touch interactions work
  • Text is readable
  • Buttons are tappable

📝 Feedback Collection

Please collect feedback on:

  1. Overall impression of the app
  2. Ease of use for teenagers
  3. Privacy concerns or questions
  4. Feature suggestions or improvements
  5. Technical issues encountered

🎉 Success Criteria

The testing is successful if:

  • ✅ All authentication flows work
  • ✅ No critical bugs are found
  • ✅ Users can complete basic tasks
  • ✅ Interface feels appropriate for teenagers
  • ✅ Privacy features are clear and working

Good luck with the testing! 🚀