Common issues and fixes.
Arduino core not installed
Symptoms: Compile/Upload disabled or failing.
Fix:
- Open Board Manager → Update Index → Install the required core
- Reopen the Board dropdown and select a matching board
No serial ports detected
Fix:
- Ensure USB cable supports data
- Try a different port
- Open the Port dropdown to refresh
- Install drivers for your board if required
Build fails
Fix:
- Open Output tab to view full logs
- Click "Fix with AI" to get suggestions from the Agent
- Verify FQBN and board options are correct
Git push/pull fails
Fix:
- Check remote URL and credentials
- Set upstream for the current branch
- Fetch → Pull → Push in order
Update check fails
Fix:
- Verify internet connectivity (indicator on toolbar)
- Try again later; GitHub API rate limits may apply
Terminal rendering issues
Fix:
- Resize the bottom panel to trigger a re‑fit
- Create a new session