# Developer Fix Pack

You are my AI coding agent. Improve the homepage at https://freecourse.io using the audit below.

Goal: edit the homepage source code so the page is clearer, more specific, more trustworthy, and easier to convert. Do not just summarize the audit.

Before editing:
- Inspect the homepage implementation and reuse the existing framework, components, styles, and copy patterns.
- Keep the same product and offer. Change the framing, copy, layout, CTA support text, and metadata where needed.
- Do not invent pricing, plan limits, free-trial details, credit-card policy, cancellation terms, setup time, security claims, customer names, metrics, or guarantees.
- Use only facts present in the audit or the current page. If a fact is missing, use placeholders like [actual starting price] or [actual credit-card policy] and leave it obvious for me to fill in.
- Prefer concrete copy and UI changes over generic advice.

Make these changes:
1. Rewrite the hero section: headline, subheadline, primary CTA, secondary CTA if useful, and the short proof or reassurance line under the CTA.
2. Rewrite weak page sections called out in the audit with exact replacement copy.
3. Add or move trust proof, objection handling, and CTA support near the conversion points.
4. Apply visual hierarchy fixes from the audit: spacing, CTA contrast, section order, typography emphasis, and mobile density.
5. Fix SEO, load-speed, mobile, color/contrast, and technical issues where the code allows.
6. Keep the page honest: replace unsupported facts with placeholders instead of made-up examples.
7. Run the relevant formatter, linter, or tests after editing.

## Score Summary

- Headline & Subheadline: 4/10
- Value Proposition: 5/10
- CTA Architecture: 4/10
- Trust & Social Proof: 2/10
- Anxiety & Objection Handling: 5/10
- Copy Specificity & Tone: 4/10
- Page Narrative & Flow: 4/10
- Visual Hierarchy: 4/10
- Color & Accessibility: 2/10
- Friction & Distraction: 3/10
- Mobile Experience: 3/10
- SEO Fundamentals: 5/10
- Load Speed: 3/10
- Technical Health: 4/10


## Critical Fixes (do these first)

- **cro**: Primary hero CTAs have empty hrefs, making the main conversion path non-functional for users and crawlers -> Add valid internal hrefs to 'Explore Courses' and 'Browse Categories', then set 'Explore Courses' as the dominant primary action
- **visual**: 16 visible element overlaps detected in the rendered viewport obstruct readability and tapping -> Inspect absolute, fixed, and stacked elements at mobile and desktop breakpoints and remove incoherent overlaps
- **media**: The hero/LCP image uses loading='lazy', which delays Largest Contentful Paint -> Remove loading='lazy' from the above-fold hero image, add width and height attributes, and only lazy-load below-fold images
- **performance**: 22 external scripts and 3 render-blocking scripts severely delay Time to Interactive -> Remove low-value scripts, consolidate noncritical code away from the landing page, add defer or async where safe, and move blocking scripts after first render
- **trust_proof**: No named partner logos, verifiable metrics, or legal links are visible near the primary CTAs -> Add a trust bar beneath the hero CTAs displaying named platform logos and specific verification copy, then ensure footer anchors for Privacy Policy and Terms of Use are clearly labeled


## Fix First Sequence

1. Use a real link or form submit path so visitors, crawlers, analytics, and QA can verify the conversion path. Validate: Re-run the audit and confirm this finding is resolved: Primary CTA has no inspectable destination.
2. Inspect stacked/absolute/fixed elements at mobile and desktop breakpoints and remove incoherent overlaps. Validate: Re-run the audit and confirm this finding is resolved: Potential element overlap detected.
3. Increase foreground/background contrast for text and CTA states. Validate: Re-run the audit and confirm this finding is resolved: Potential text contrast risks detected.
4. Raise body/support text sizes and line-height for mobile readability. Validate: Re-run the audit and confirm this finding is resolved: Small mobile text detected.
5. Give mobile buttons and links at least a 44px touch area with enough spacing. Validate: Re-run the audit and confirm this finding is resolved: Small mobile tap targets detected.
6. Constrain paragraph width to roughly 50-75 characters per line and split dense copy blocks. Validate: Re-run the audit and confirm this finding is resolved: Long readable line lengths detected.


## Findings To Cover

- `cro.primary_cta_no_destination` [high / cro / confidence 0.78] Location: Post-click funnel QA. Evidence: Primary CTA is "Explore Courses" with no href. Exact fix: Use a real link or form submit path so visitors, crawlers, analytics, and QA can verify the conversion path.
- `visual.obvious_overlap` [high / visual / confidence 0.78] Location: rendered viewport. Evidence: 16 visible element overlaps were detected in the rendered viewport. Exact fix: Inspect stacked/absolute/fixed elements at mobile and desktop breakpoints and remove incoherent overlaps.
- `media.hero_image_lazy_loaded` [high / media / confidence 0.9] Location: web.dev LCP image guidance. Evidence: First image is "/logos/edx-logo.svg" with loading="lazy". Exact fix: Set the above-fold hero image to eager/default loading and lazy-load only below-fold images.
- `performance.script_count` [high / performance / confidence 0.9] Location: Semrush JS/CSS report pattern. Evidence: 22 external scripts were extracted. Exact fix: Remove low-value scripts and split noncritical code away from the landing page.

## Overall Assessment

Things done well:
- Core value proposition around verified discount coupons is explicit and easy to understand once found
- Meta description and Open Graph tags are populated and reference Udemy, Coursera, and edX

Priority issues to fix:
1. Use only verified page facts here: Plans start at [actual starting price] | [actual trial or credit-card policy] | [actual cancellation, setup, or security detail]. If the site does not state a fact, ask the founder to add the real detail instead of inventing it.
2. Fix layout stability and narrative order: resolve the 16 viewport element overlaps, move 'How It Works' above the course grid, truncate course card descriptions to 2 lines with a Read More toggle, and remove Telegram and WhatsApp exits from above the fold
3. Cut render-blocking payload: remove lazy loading from the hero/LCP image, consolidate or defer the 22 external scripts and 3 render-blocking tags, and add width/height attributes plus descriptive alt text to all course thumbnails

## Conversion Theory

The page triggers immediate skepticism with a vague 'Absolutely Free' promise and a grammar error in the subheadline, then fails to convert because its primary hero buttons have empty destinations and no nearby trust signals. Dense pasted course descriptions, premature social exits, and a heavy script payload further exhaust users before they understand the coupon mechanism.


## Tool-Style Checks

These objective checks are modeled after technical SEO, local browser lab, accessibility, and crawl-audit tools. Treat critical and high severity issues here as hard requirements.

- [high] Primary CTA has no inspectable destination: Primary CTA is "Explore Courses" with no href. Fix: Use a real link or form submit path so visitors, crawlers, analytics, and QA can verify the conversion path.
- [high] Likely hero/LCP image is lazy-loaded: First image is "/logos/edx-logo.svg" with loading="lazy". Fix: Set the above-fold hero image to eager/default loading and lazy-load only below-fold images.
- [high] JavaScript file count is high: 22 external scripts were extracted. Fix: Remove low-value scripts and split noncritical code away from the landing page.
- [medium] Likely hero/LCP image lacks high fetch priority: First image is "/logos/edx-logo.svg" without fetchpriority="high". Fix: Add fetchpriority="high" to the LCP image or preload the correct responsive candidate.
- [medium] Most images are not responsive: 18 of 19 images lack usable srcset/sizes metadata. Fix: Serve responsive image candidates with srcset and sizes so mobile visitors avoid desktop-sized downloads.
- [medium] Render-blocking scripts detected: 3 blocking scripts were extracted. Fix: Add defer or async where safe and move noncritical scripts below first render.
- [medium] Desktop request-count proxy is heavy: 120 local browser requests were captured. Fix: Remove noncritical tags and consolidate low-value assets.
- [medium] All images are lazy-loaded: All 19 images use lazy loading. Fix: Do not lazy-load the hero or likely LCP image.

## Ranked Action Plan

Use this impact/effort/confidence ranking before choosing what to edit first:

- Score 4.86: JavaScript file count is high (optimize, effort 2/5, confidence 90%). Fix: Remove low-value scripts and split noncritical code away from the landing page.
- Score 4.68: Primary CTA has no inspectable destination (test, effort 2/5, confidence 78%). Fix: Use a real link or form submit path so visitors, crawlers, analytics, and QA can verify the conversion path.
- Score 4.52: Likely hero/LCP image is lazy-loaded (optimize, effort 2/5, confidence 90%). Fix: Set the above-fold hero image to eager/default loading and lazy-load only below-fold images.
- Score 3.31: Submitted page is absent from sitemap (fix, effort 3/5, confidence 92%). Fix: Include important canonical landing pages in the XML sitemap.
- Score 3.28: Desktop request-count proxy is heavy (optimize, effort 3/5, confidence 90%). Fix: Remove noncritical tags and consolidate low-value assets.
- Score 3.28: All images are lazy-loaded (optimize, effort 3/5, confidence 90%). Fix: Do not lazy-load the hero or likely LCP image.


## Opportunity Clusters

Treat these as root-cause workstreams. Avoid fixing one symptom while leaving the related blockers untouched:

- Score 7.06: Speed and Delivery (10 related findings, metric: mobile_bounce_rate). Lead fix: Remove low-value scripts and split noncritical code away from the landing page.
- Score 5.21: Site Quality (2 related findings, metric: site_health_score). Lead fix: Use a real link or form submit path so visitors, crawlers, analytics, and QA can verify the conversion path.
- Score 3.31: Indexability and Discoverability (1 related findings, metric: indexed_click_eligible_pages). Lead fix: Include important canonical landing pages in the XML sitemap.
- Score 2.35: Conversion Path (1 related findings, metric: primary_cta_click_rate). Lead fix: Reduce above-fold navigation to the few paths visitors need to decide.


## Recommendation Briefs

Use these as the implementation plan. Keep validation events and metrics intact:

- Speed and Delivery [optimize]: Remove low-value scripts and split noncritical code away from the landing page. Validate with mobile_bounce_rate.
- Site Quality [fix_now]: Use a real link or form submit path so visitors, crawlers, analytics, and QA can verify the conversion path. Validate with site_health_score.
- Indexability and Discoverability [test]: Include important canonical landing pages in the XML sitemap. Validate with indexed_click_eligible_pages.
- Conversion Path [test]: Reduce above-fold navigation to the few paths visitors need to decide. Validate with primary_cta_click_rate.


## Stack, Form, and Trust Signals

- Next.js: framework
- Forms: 0 | Fields: 0 | Required: 0 | Missing autocomplete: 0 | Business fields: 0 | Sensitive fields: 0 | Confirm fields: 0 | Privacy microcopy: no | Social auth: 0
- Privacy: True | Terms: True | Security: True | Pricing: True | Logos: 19 | Testimonials: 0 | Case studies: 1 | Risk reversal: True
- Analytics: clarity, ga4 | Events: none | UTM fields: 0 | Params: 1 | Form starts: 0 | CTA clicks: 0 | Form errors: 0 | GA IDs: 1 | Consent tools: none
- Schema types: EducationalOrganization, WebSite | Items: 2 | Invalid JSON-LD: 0

- URL length: 21 | Depth: 0 | Params: 0 | Canonical path mismatch: False
- Images: 19 | Responsive: 1 | Legacy: 0 | Videos: 0
- Font stylesheets: 0 | Font preloads: 2 | Missing font-display: 0 | Legacy fonts: 0
- Compression: br | Cache-Control: True | Validators: False | CDN cache signal: True
- Hero CTA: True | Hero words: 39 | CTA count: 22 | Footer CTAs: 1 | CTA destinations: 10 | External CTA paths: 2 | Missing CTA anchors: 0
- Section flow: 4 sections | Sequence: hero, problem, solution, solution
- Main landmarks: 1 | Generic links: 0 | Small targets: 0 | Unsafe new-tab links: 8


- Competitor matrix: keyword-aligned competitors 0 | competitors with high-intent CTA 0 | competitors with proof 0 | missing terms: none


## Social Profiles To Review

Use these public profiles to cross-check positioning, proof, audience, trust, and launch-channel suggestions:

- x: https://x.com/freecourseio
- github: https://github.com/freecourseio
- linkedin: https://linkedin.com/company/freecourse
- instagram: https://instagram.com/freecourseio

- Organization sameAs URLs: 3


## Experiment Ideas

- Test indexability and discoverability: Because Submitted page is absent from sitemap. Search and AI systems must be able to crawl, understand, and trust the page. we believe Include important canonical landing pages in the XML sitemap. will improve indexed_click_eligible_pages. Primary metric: indexed_click_eligible_pages.
- Test conversion path: Because Navigation may be overloaded. Visitors need an obvious next step before secondary improvements can pay off. we believe Reduce above-fold navigation to the few paths visitors need to decide. will improve primary_cta_click_rate. Primary metric: primary_cta_click_rate.
- Reduce above-fold navigation choices: Reducing competing navigation choices will increase attention on the primary conversion path. Primary metric: primary_cta_click_rate.


## Detailed Breakdown Per Section

### Headline & Subheadline
**Score:** 4/10
**Issue:** The H1 'Learn Anything, Absolutely Free' fails the stranger test because it does not specify the mechanism (coupons) or the source (Udemy/Coursera), triggering skepticism. The subheadline 'Master web development, design, AI, business and more with from top platforms' contains a critical grammar error ('with from') that signals low quality.
**Fix:** Change H1 to 'Get Paid Udemy and Coursera Courses for Free'. Change subheadline to 'Access 100 percent verified discount codes. Join 300,000+ learners saving on certificates daily.'
### Value Proposition
**Score:** 5/10
**Issue:** The hero section claims 'Access premium courses for free in three simple steps' but does not list the steps immediately. The explanation 'Access 100 percent verified discount codes and coupons' is located further down in the 'How It Works' section, creating friction for users evaluating the offer.
**Fix:** Move the '100 percent verified discount codes' claim to the hero subheadline. Add a 3-step visual or bullet list directly under the CTA buttons showing 'Browse', 'Copy Code', 'Enroll'.
### Copy Specificity & Tone
**Score:** 4/10
**Issue:** Phrases like 'Start Learning for Free and Upskill' and 'unlock opportunities without spending a dime' are vague. The page uses 'Upskill' which is corporate jargon. The course descriptions are dense blocks of text pasted from providers, making the page visually heavy.
**Fix:** Replace 'Upskill' with 'Get Certified'. Replace 'unlock opportunities' with 'Add certificates to your LinkedIn'. Truncate course descriptions to 2 lines with a 'Read More' toggle to improve scanability.
### Page Narrative & Flow
**Score:** 4/10
**Issue:** The H1 promises 'Learn Anything, Absolutely Free', but the immediate next section is 'Latest Courses' with a long list of course cards. The 'How It Works' section, which explains the coupon mechanism, appears after the course list. Users see the 'what' before understanding the 'how'.
**Fix:** Move the 'How It Works' section above the 'Latest Courses' section. Add a sub-headline under the H1 that says 'Access premium courses from Udemy and Coursera using verified 100 percent off coupons.'
### Anxiety & Objection Handling
**Score:** 5/10
**Issue:** The hero section claims courses are 'Absolutely Free' which triggers immediate skepticism about hidden costs or piracy. The answer 'Are the courses really 100 percent free? Yes! All courses listed on FreeCourse.io have verified 100 percent off coupons' is located in the FAQ section at the bottom of the page.
**Fix:** Use only verified page facts here: Plans start at [actual starting price] | [actual trial or credit-card policy] | [actual cancellation, setup, or security detail]. If the site does not state a fact, ask the founder to add the real detail instead of inventing it.
### CTA Architecture
**Score:** 4/10
**Issue:** The hero section presents two equal-weight CTAs: 'Explore Courses' and 'Browse Categories'. This creates decision paralysis for a user whose primary intent is to find a specific course.
**Fix:** Make 'Explore Courses' the primary button. Change 'Browse Categories' to a text link or secondary outline button to reduce visual weight.
### Friction & Distraction
**Score:** 3/10
**Issue:** The page contains 22 internal links and prominent CTAs like 'Join Telegram' and 'Join WhatsApp' that pull users away from the course discovery funnel before they engage.
**Fix:** Move 'Join Telegram' and 'Join WhatsApp' to the footer. Reduce header navigation to essential links only (Courses, Categories, About).
### Trust & Social Proof
**Score:** 2/10
**Issue:** The page states 'Every coupon is tested and validated' and 'Official Affiliate Partner of top course platforms,' but it never names the platforms, displays partner logos, or provides visible links to Privacy Policy, Terms of Use, or Contact information. Its only quantitative proof, 'Connect with 300K+ learners worldwide,' is located away from the 'Explore Courses' and 'View Course' CTAs, while course ratings shown on cards belong to Udemy instructors and do not validate FreeCourse.io as a safe coupon curator.
**Fix:** Add a trust bar directly below the hero CTAs that displays named partner logos (Udemy, Coursera, edX) and specific micro-copy such as '[Actual number] coupons verified in the last 24 hours.' Move the existing '300K+ learners worldwide' claim to sit immediately above or below the primary 'Explore Courses' button. Add labeled footer anchors for Privacy Policy, Terms of Use, and Contact to reduce anxiety about data legitimacy.
### Visual Hierarchy
**Score:** 4/10
**Issue:** The hero section splits attention between the H1 'Learn Anything, Absolutely Free' and the subhead 'Master web development...', while course cards like 'Montessori Birth to Three' display hundreds of words of copy instead of a summary, creating a wall of text that buries the 'View Course' CTAs.
**Fix:** Reduce course card descriptions to 2 lines max with a 'Read More' toggle, consolidate hero copy to one clear value proposition, and limit above-fold navigation to reduce the 22 extracted internal links.
### Color & Accessibility
**Score:** 2/10
**Issue:** Primary CTA 'Explore Courses' has an empty href in extracted data, and course images lack alt text attributes in the scrape.
**Fix:** Add valid href to 'Explore Courses', implement unique aria-labels for 'View Course' links, and add descriptive alt text to all course thumbnails.
### Mobile Experience
**Score:** 3/10
**Issue:** Scraped CTA text shows full course descriptions (e.g. 500+ words for Montessori course) embedded in card links instead of summaries.
**Fix:** Limit course card descriptions to 2 lines on mobile and move full syllabus to the course detail page.
### SEO Fundamentals
**Score:** 5/10
**Issue:** The provided audit context states the submitted URL is absent from the XML sitemap (12 URLs present, none matching this page), the meta description is 163 characters which risks truncation, the sole H1 'Learn Anything, Absolutely Free' does not contain the target phrase 'free online courses', scraped data shows no H3 subheadings beneath the listed H2s, and there is no evidence of alt text attributes, canonical tags, or structured data markup.
**Fix:** Add https://freecourse.io to the XML sitemap immediately. Rewrite the meta description to 156 characters: 'Access high-quality free courses from Udemy, Coursera, edX and more. Master web development, design, business, and other skills with our curated collection.' Replace the H1 with 'Learn Anything With Free Online Courses'. Wrap each course title and FAQ item in H3 tags. Add descriptive alt text to every course thumbnail image. Implement self-referencing canonical tags and CourseList structured data if not already present.
### Load Speed
**Score:** 3/10
**Issue:** Each 'View Course' CTA includes the complete course landing page copy (observed up to 2000+ characters per course), causing excessive DOM size and parse time. No lazy loading attributes or explicit image dimensions are evident for course thumbnails. Third-party domains like Telegram and WhatsApp are not preconnected.
**Fix:** Truncate course card descriptions to 150 characters, load full content on detail pages only. Add loading='lazy' and width/height attributes to all course images. Add <link rel='preconnect'> for t.me and wa.me origins. Consider implementing infinite scroll or pagination to reduce initial DOM nodes.
### Technical Health
**Score:** 4/10
**Issue:** The hero buttons 'Explore Courses' and 'Browse Categories' (cta_details: href empty, is_hero true) do not lead to any destination page.
**Fix:** Update the href attribute to point to the correct internal pages such as '/courses' and '/categories'.

## AI Copy Detection

This page's copy was likely generated by AI (medium confidence).
- Generic marketing phrases such as 'unlock opportunities' and 'Start Learning for Free and Upskill' replace concrete outcomes
- Course descriptions are dense, feature-heavy blocks pasted directly from providers rather than rewritten as curated summaries
- Subheadline contains an unedited grammar error suggesting low human oversight on templated copy
- Repeated em dash usage (2 found)
- AI filler phrases found: whether you're a

Rewrite the flagged sections in a human voice - specific, opinionated, and differentiated.


## Validation Checklist

- `cro.primary_cta_no_destination`: Re-run the audit and confirm this finding is resolved: Primary CTA has no inspectable destination.
- `visual.obvious_overlap`: Re-run the audit and confirm this finding is resolved: Potential element overlap detected.
- `media.hero_image_lazy_loaded`: Re-run the audit and confirm this finding is resolved: Likely hero/LCP image is lazy-loaded.
- `performance.script_count`: Re-run the audit and confirm this finding is resolved: JavaScript file count is high.

## Output I Want From You

- Make the code changes directly.
- Show a concise summary of what changed.
- List any placeholders I need to replace with real business facts.
- Mention which checks you ran.