[EPIC] Landing Page Polish, CTA/Form/Event Tracked Flows & Backend Integration Gaps

[basanth-p]

🎯 Goal

Take the func(kode) landing page from a visually assembled state to a fully production-shipped product — every section rendering correctly at all viewports, every CTA and form wired to both Supabase (actions) and PostHog (tracking), and every known backend integration gap patched so no user journey ends in a silent failure or broken state.

This EPIC sits between the structural rebuild (EPIC #92) and the analytics instrumentation (EPIC #108). It is the connective tissue that makes both of those EPICs actually work for real users.

---

📋 Context

• EPIC EPIC: Landing Page Rebuild — Atomic Component PRs #92 (Landing Page Rebuild) is nearing completion — SiteChrome ([Landing] SiteChrome layout wrapper + layout.tsx refactor #93), design tokens ([Landing] Design tokens — Tailwind config extensions for landing page typography & spacing #95), LandingBackground ([Landing] LandingBackground component + landing-assets.ts registry #96) are merged. Navbar ([Landing] Navbar rewrite — new design with auth state + GitHub fork count #94) and HeroSection ([Landing] HeroSection + HeroEditorMockup + page.tsx wiring #97) are the remaining PRs in flight.
• EPIC [EPIC] PostHog Analytics Integration — Full Coverage Across Landing, Auth Flows & Dashboard #108 (PostHog Analytics) has instrumented CTA clicks and section views on the landing page ([analytics] Instrument landing page — pageview, CTA clicks, section visibility, announcement popup #111) — but those events only fire if the CTAs and sections are actually rendered and wired correctly. Broken CTAs = broken analytics.
• EPIC EPIC: Landing Page Responsiveness, Dashboard UI Cleanup & Frontend–Backend Integration QA #116 (Responsiveness & Integration QA) covers QA checklists for existing features. This EPIC covers the implementation work that makes that QA pass: the remaining landing sections, the CTA/form wiring, and the backend gaps.
• Bug [BUG] GItHub OAuth Persistent Sessions for Developers (not working) #86 (GitHub OAuth not working) is an active open bug that directly blocks the primary landing page CTA flow.

---

📦 Child Issues

#	Issue	Area	Priority
1	#125 — AboutSection + HowItWorks landing sections — implement remaining above-fold sections	Landing	🔴 High
2	#126 — ForTeams + ForDevelopers + ContactUs landing sections — complete the page	Landing	🔴 High
3	#127 — Hero CTAs wiring — "Start Contributing" → /auth/login, "Explore the project" → /projects	Landing / CTA	🔴 High
4	#128 — Fix GitHub OAuth redirect loop (Bug #86) — patch @supabase/ssr callback handling	Auth / Backend	🔴 Critical
5	#129 — ContactUs section form — Supabase insert + PostHog contact_submitted event	Landing / Backend	🟡 Medium
6	#130 — Event Announcement Popup (#103) — date/time config, Discord CTA link, and PostHog events	Landing / Analytics	🟡 Medium
7	#131 — Landing page Footer component — links, social icons, PostHog footer_link_clicked	Landing	🟡 Medium
8	#132 — RELEASE_VERSION sourced from package.json — remove hardcoded version string	Tech Debt	🟢 Low

---

🚦 Definition of Done

• All landing page sections rendered and responsive at 375px, 768px, 1024px, 1280px, 1440px
• Every landing CTA navigates to the correct destination
• GitHub OAuth flow completes without redirect loop or 500 (Bug [BUG] GItHub OAuth Persistent Sessions for Developers (not working) #86 closed)
• ContactUs form inserts to Supabase and fires contact_submitted to PostHog on success
• Event Announcement Popup is configurable via props — not hardcoded date/copy
• Footer component exists with all required links and PostHog click tracking
• RELEASE_VERSION no longer hardcoded — sourced from env or package.json
• npm run build passes with zero type errors after all PRs merge
• All issues in this EPIC closed with a passing PR targeting fix/ui-tweaks → dev

---

🔗 Related EPICs & Issues

• EPIC: Landing Page Rebuild — Atomic Component PRs #92 — Landing Page Rebuild (structural — this EPIC fills the content + wiring layer on top)
• [EPIC] PostHog Analytics Integration — Full Coverage Across Landing, Auth Flows & Dashboard #108 — PostHog Analytics Integration (events in this EPIC feed the funnels in [analytics] Instrument landing page — pageview, CTA clicks, section visibility, announcement popup #111 and [analytics] Wire key funnels in PostHog — Landing → Login → Onboard → Dashboard #114)
• EPIC: Landing Page Responsiveness, Dashboard UI Cleanup & Frontend–Backend Integration QA #116 — Responsiveness & Integration QA (QA checklist — implementation work is here)
• [BUG] GItHub OAuth Persistent Sessions for Developers (not working) #86 — GitHub OAuth bug (child issue [Bug / Auth] Fix GitHub OAuth redirect loop — patch @supabase/ssr callback handling (Bug #86) #128 is the fix)
• feat: Event Announcement Pop-up on Landing Page — 🎉 Server Launch Party #103 — Event Announcement Popup (child issue [Landing] Event Announcement Popup — date/time config, Discord CTA link, PostHog events wired (PR #103 follow-up) #130 adds wiring + config)