> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altoura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common issues and solutions for the Trainee App

If you're having trouble with the Trainee App, check these common issues and solutions first.

## Loading & Access Issues

<AccordionGroup>
  <Accordion title="The training won't load — I see a blank screen">
    Check your internet connection and refresh the page. If the issue persists, try a different browser (Chrome or Edge recommended). Your browser may need WebGL enabled — see [Supported Devices](/creator-studio/trainee-app/supported-devices).
  </Accordion>

  <Accordion title="I see 'Authentication Failed'">
    Click **Try Again** to restart the login process. Ensure you have a valid account with your organization. If the issue persists, contact your training administrator.
  </Accordion>

  <Accordion title="I'm stuck on 'Authenticating...'">
    Check your internet connection and try refreshing the page. Your organization's login service may be temporarily unavailable — try again later.
  </Accordion>

  <Accordion title="The training link says 'Not Found' or gives a 404 error">
    The training URL may have changed or the training may have been removed. Contact your training administrator for the correct link.
  </Accordion>

  <Accordion title="Assets are loading very slowly">
    Close other browser tabs to free up memory. Check your internet speed — a stable 5 Mbps+ connection is recommended. Large trainings with many 3D models take longer to load on the first visit. Subsequent visits are faster because assets are cached locally.
  </Accordion>

  <Accordion title="I see 'Access Denied'">
    Your account does not have permission to access this training. You will be redirected to the Dashboard. Contact your training administrator to request access.
  </Accordion>

  <Accordion title="The training shows as unavailable or still processing">
    The training may not be published yet, may still be processing, or may have been removed. Contact your training administrator to confirm the training status and get the correct link.
  </Accordion>

  <Accordion title="I see 'Offline Training Unavailable'">
    This training has not been cached locally yet. Connect to the internet and open the training once to download and cache the required assets. After that, the training may be available for offline use. See [Progress & Completion](/creator-studio/trainee-app/progress-completion#offline--caching) for more details.
  </Accordion>
</AccordionGroup>

## Interaction Issues

<AccordionGroup>
  <Accordion title="I'm clicking an object but nothing happens">
    Make sure you're clicking the correct object for the current step. Look for the highlighted glow and direction indicator arrow. If no objects are glowing, you may be in assessment mode where visual guides are hidden.
  </Accordion>

  <Accordion title="I see a red flash when I click">
    The red vignette means you tapped the wrong object. Re-read the step instructions and look for the direction indicator arrow or ghost hand animation pointing to the correct object.
  </Accordion>

  <Accordion title="The ghost hand animation isn't showing">
    If you're in assessment mode, animations are intentionally hidden. If you're in guided mode, try maximizing your browser window — the animation might be off-screen. You can also use **Reset Step** to restart the step and trigger the animation again.
  </Accordion>

  <Accordion title="I can't find the object I need to interact with">
    Rotate your view to look around the full scene. Use the direction indicator arrow (if visible) to locate the target. Adjust camera height with the +/− controls or Q/E keys. If still lost, use **Reset View** to return to the default camera position.
  </Accordion>
</AccordionGroup>

## Navigation Issues

<AccordionGroup>
  <Accordion title="I'm completely disoriented — can't tell which way I'm facing">
    Use **Reset View** from the Reset menu (left side of screen) to snap back to the default camera position and orientation.
  </Accordion>

  <Accordion title="I can't move around the scene">
    Try using WASD keys or scroll wheel. On touch devices, enable the **Virtual Joystick** in Settings. If nothing works, refresh the page.
  </Accordion>

  <Accordion title="Camera height controls aren't visible">
    Open Settings via your profile avatar and enable the **Adjust Height** toggle under Controls.
  </Accordion>

  <Accordion title="The virtual joystick isn't appearing">
    It's off by default. Open Settings and enable the **Virtual Joystick** toggle under Controls.
  </Accordion>
</AccordionGroup>

## Audio & Video Issues

<AccordionGroup>
  <Accordion title="I can't hear any audio">
    Check the volume slider in Settings. Make sure **Step Instruction Audio** is toggled on. Also check that your device volume isn't muted and that your browser tab has audio permissions.
  </Accordion>

  <Accordion title="A video panel won't play">
    Check your internet connection. Try refreshing the page. If it still doesn't work, contact your training administrator — the video file may be unavailable.
  </Accordion>
</AccordionGroup>

## Connection Issues

<AccordionGroup>
  <Accordion title="I see 'Connection lost' during training">
    Check your internet connection. The app will attempt to reconnect automatically. If it doesn't, refresh the page. Your last completed step should be saved.
  </Accordion>

  <Accordion title="The training is lagging or stuttering">
    Close other browser tabs and applications. Ensure a stable internet connection. Try Chrome or Edge for best 3D performance. See [Supported Devices](/creator-studio/trainee-app/supported-devices) for recommended specifications.
  </Accordion>
</AccordionGroup>

## Still Having Issues?

If none of the above solutions work, contact your training administrator with:

* The exact error message you see
* Your browser name and version
* The training URL you're trying to access
* A screenshot of the issue (if possible)