Troubleshooting

❌ Problem

My changes in config.js don't appear on the website

✅ Solutions

• 1. Hard refresh the browser: Press Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)
• 2. Check for syntax errors: Missing comma, quote, or bracket in config.js
• 3. Clear browser cache: Settings → Clear browsing data
• 4. Check browser console: Press F12 → Console tab for error messages

❌ Problem

Profile photo or portfolio images show broken image icon

✅ Solutions

• 1. Check file path: Make sure path in config.js matches actual file location
• 2. Check file name: File names are case-sensitive (profile.jpg ≠ Profile.JPG)
• 3. Verify file exists: Confirm image file is in the correct folder
• 4. Check file format: Use JPG, PNG, or GIF formats

❌ Problem

CV download button doesn't work or downloads wrong file

✅ Solutions

• 1. Check file path: Verify CV file path in config.js is correct
• 2. Use PDF format: CV files should be in PDF format
• 3. Check display toggle: Make sure showHeroCV or showAboutCV is set to true
• 4. Verify file exists: Confirm PDF is in assets/documents/ folder

❌ Problem

Clicking filter buttons doesn't filter projects

✅ Solutions

• 1. Match categories: Project category must match filter value
• 2. Check spelling: Category names are case-sensitive
• 3. Hard refresh: Press Ctrl+F5 to clear cache

❌ Problem

Contact form doesn't open email client

✅ Solutions

• 1. Email client: Make sure you have an email app installed (Outlook, Mail, Gmail, etc.)
• 2. Check email address: Verify email address in config.js is correct
• 3. Browser popup blocker: Allow popups for your site
• 4. Try different browser: Some browsers handle mailto links differently

❌ Problem

Social media icons don't appear in Hero or Contact sections

✅ Solutions

• 1. Check display toggle: Set showHeroSocial or showContactSocial to true
• 2. Check social array: Make sure social array has items
• 3. Verify icon class: Use correct Font Awesome icon class

❌ Problem

Typing animation in Hero section doesn't animate

✅ Solutions

• 1. Check typingTitles array: Make sure it has at least one title
• 2. Check for errors: Open browser console (F12) for JavaScript errors
• 3. Hard refresh: Press Ctrl+F5 to reload scripts

❌ Problem

Mobile menu doesn't open when clicking hamburger icon

✅ Solutions

• 1. Check browser console: Look for JavaScript errors
• 2. Test on different device: Try on actual mobile device
• 3. Clear cache: Hard refresh the page

❌ Problem

Website shows blank page or console shows syntax error

✅ Common Mistakes

• 1. Missing comma: Each item in array needs comma except last one
• 2. Missing quote: All text values need quotes
• 3. Missing bracket: Every opening bracket needs closing bracket
• 4. Extra comma: Don't put comma after last item in array

Supported Browsers

• ✅ Chrome (latest)
• ✅ Firefox (latest)
• ✅ Safari (latest)
• ✅ Edge (latest)
• ❌ Internet Explorer (not supported)

Before Asking for Help

• 1. Check browser console for error messages (F12 → Console)
• 2. Try hard refresh (Ctrl+F5 or Cmd+Shift+R)
• 3. Test in different browser
• 4. Review this troubleshooting guide
• 5. Check config.js for syntax errors

When Reporting Issues

• • Describe what you expected to happen
• • Describe what actually happened
• • Include browser console errors (if any)
• • Mention which browser and version you're using
• • Share relevant config.js section (remove personal info)