Testing Guide - Mobile Menu & CTA Buttons (v2 - Fixed)
π§ What Was Wrong (Original Attempt)
The original implementation failed because:
- CSS wasnβt recompiling - Jekyll on GitHub Pages wasnβt rebuilding the SCSS files
- Styles were missing - The minified CSS file didnβt contain our new styles
- Mobile menu wasnβt appearing - Styles werenβt loading
β What I Fixed
New Approach: Added all styles as inline CSS in the <head> section
- β No SCSS compilation needed
- β Works immediately when pushed
- β Guaranteed to load with the page
π Pre-Commit Checklist
Before you commit and push, verify these files are updated:
1. _includes/top.html
- β
Should have a large
<style>block with mobile menu and CTA styles - β
Located right before the
</head>tag
2. _includes/header.html
- β
Should have the hamburger button HTML:
<button class="mobile-menu-toggle" aria-label="Toggle navigation menu"> <span class="hamburger-line"></span> <span class="hamburger-line"></span> <span class="hamburger-line"></span> </button>
3. _layouts/default.html
- β
Should have
<div class="mobile-menu-overlay"></div>after wrapper - β Should have mobile menu JavaScript at the bottom
4. index.html
- β
Should have
.cta-containerdivs with buttons - β
Buttons should have
hrefattributes pointing to/contact
5. contact/index.html
- β
Should have
.contact-info-boxwith styled content - β
Should have
.contact-methodswith phone and email
π§ͺ Testing Steps (In Order)
Test 1: Desktop View
- Visit homepage in Chrome/Firefox
- Page should load normally
- CTA buttons should be centered and look like actual buttons (not plain text)
- Primary button should be teal/blue gradient
- Secondary button should be white with blue border
- Hover over buttons - they should lift up slightly
- No hamburger menu should be visible
Expected Result: β Everything looks professional, buttons are centered
Test 2: Mobile View (Browser)
- Open Chrome DevTools (F12)
- Click βToggle Device Toolbarβ (Ctrl+Shift+M)
- Select βiPhone SEβ or similar small phone
- Look in top-right corner - you should see 3 horizontal lines (hamburger)
- Click the hamburger - menu should slide in from right
- Hamburger should animate to an X
- Dark overlay should appear behind menu
- Click overlay or a menu link - menu should close
- CTA buttons should stack vertically (one on top of the other)
Expected Result: β Hamburger visible, menu works, buttons stacked
Test 3: Contact Page
- Click βSchedule Free Consultationβ button
- Should go to Contact page
- Contact page should have:
- β Light blue/green info box at top
- β Two contact method boxes (phone and email) with icons
- β Phone number is clickable
- β Email is clickable
- On mobile, contact boxes should stack vertically
Expected Result: β Professional-looking contact page with styled boxes
Test 4: Actual Mobile Device (If Possible)
- Push changes to GitHub
- Wait 2-3 minutes for GitHub Pages to rebuild
- Visit site on your actual phone
- Test hamburger menu
- Test CTA buttons (phone number should trigger phone dialer)
Expected Result: β Everything works on real device
π¨ Troubleshooting
Problem: βI still donβt see the hamburger menuβ
Solutions:
- Hard refresh: Ctrl+Shift+R (PC) or Cmd+Shift+R (Mac)
- Clear cache:
- Chrome: Settings β Privacy β Clear browsing data
- Firefox: Settings β Privacy β Clear Data
- Check file was saved: Look at
_includes/top.html- should have<style>block - Check mobile view: Make browser < 768px width
- Incognito mode: Try opening in private/incognito window
Problem: βCTA buttons are just blue underlined linksβ
Solutions:
- Check inline styles loaded: Right-click button β βInspectβ β Look for
.cta-buttonstyles - Hard refresh: Ctrl+Shift+R
- Check class names: Button should have
class="cta-button cta-primary"
Problem: βButtons are left-aligned, not centeredβ
Solutions:
- Check container: Buttons should be wrapped in
<div class="cta-container"> - Check inline styles:
.cta-containershould havedisplay: flexandalign-items: center - Hard refresh: Ctrl+Shift+R
Problem: βMenu slides in but hamburger doesnβt animate to Xβ
Solution:
- Check if
bodytag gets classmobile-menu-openwhen you click (use browser inspector) - If not, JavaScript isnβt working - check browser console for errors
π― What Success Looks Like
Desktop:
- Clean header with horizontal navigation
- Two prominent, centered CTA buttons on homepage
- Buttons have gradient backgrounds and shadows
- Hover effects work smoothly
Mobile:
- Hamburger menu icon in top-right
- Menu slides in from right smoothly
- Hamburger animates to X when open
- Dark overlay behind menu
- CTA buttons stack vertically
- Everything is easy to tap
Contact Page:
- Styled info box with light background
- Two contact method cards with icons
- Professional, modern layout
- Phone/email are clickable
πΈ Visual Reference
Desktop CTA Buttons Should Look Like:
βββββββββββββββββββββββββββββββββββ
β β
β [Schedule Free Consultation] β β Teal gradient button
β [π Call (303) 731-6149] β β White button with blue border
β β
βββββββββββββββββββββββββββββββββββ
Mobile Hamburger Should Look Like:
Desktop (> 768px): Mobile (< 768px):
ββββββββββββββββββββ ββββββββββββββββββββ
β Logo About FAQ β β Logo β° β β Hamburger visible
ββββββββββββββββββββ ββββββββββββββββββββ
Mobile Menu Open:
βββββββββββββββββββββββββββββ
β Logo β β MENU β
β β About β
β [Dark Overlay] β FAQ β
β β Cont β
βββββββββββββββββββββββββββββ
π Files Changed (v2)
_includes/top.html- Added inline CSS (major change)_includes/header.html- Added hamburger button_includes/navigation.html- Added ID_layouts/default.html- Added overlay + JavaScriptindex.html- Added CTA buttonscontact/index.html- Redesigned with info boxes
Note: We did NOT modify SCSS files this time to avoid compilation issues!
β Final Check Before Pushing
Run through this quick checklist:
- Hamburger menu visible on mobile view in browser
- CTA buttons are centered and look like actual buttons
- Buttons have proper colors (teal gradient + white/blue)
- Hover effects work on buttons
- Contact page has styled info boxes
- Phone number and email are clickable links
If all checked β β Ready to commit and push!
π Commit Message Suggestion
git add .
git commit -m "Add mobile navigation and CTA buttons (v2 with inline styles)"
git push origin master
Good luck! Let me know if you encounter any issues. π