feat(peer-demo-showcase): AI-Powered Hackathon Showcase & Sponsor Matcher Kit

[Avad05]

🚀 Lamatic AgentKit Challenge Submission

📹 Walkthrough Video

📌 https://www.loom.com/share/ee030ec4015d4bc299da327ec0dd34e5

---

🎯 1. Problem Statement

Organizing hackathons, demo days, and developer accelerators involves heavy manual effort:

• Manual Sponsor Track Assignment: Organizers spend hours manually reviewing GitHub repos to pair projects with relevant sponsor tracks and breakout tables.
• Fragmented Upvoting & Spam: Public voting on projects is prone to duplicate votes and refresh spamming.
• Disconnected Judging: Judges rely on paper forms or static spreadsheets to score criteria.
• Chaotic Winner Announcements: Declaring winners lacks real-time excitement and structured timing.

---

💡 2. The Solution: peer-demo-showcase Kit

The Peer Demo Showcase & AI Matcher Kit is a complete, multi-agent AI solution built on Lamatic.ai that automates the entire showcase lifecycle:

1. Instant AI Matching: Automatically parses GitHub repositories and matches projects with optimal sponsor tracks, match justifications, and assigned breakout tables.
2. Real-Time Visual Pipeline Tracker: Displays a live 3-node agent execution pipeline (EnterpriseAIPipeline) showing logs, latency, and node status.
3. Public Showcase Gallery: A rich glassmorphism gallery with search, multi-filter navigation, pagination, and localStorage-backed upvote deduplication.
4. Judge Evaluation Portal: Secure criteria-based scoring (1–10 on Innovation, Execution, Impact, Presentation) with direct repository & live demo links.
5. Admin Command Center: Clearbit company logo auto-complete for sponsors, track reassignment, judge account management, and automatic 15-minute inactivity session timeouts.
6. Live Winner Podium & Countdown Engine: Dynamic HH:MM:SS countdown timer that automatically reloads upon expiry to reveal an animated Top 3 Winners Podium with confetti.

---

🔌 3. Lamatic.ai 5-Flow Orchestration Architecture

This kit demonstrates how 5 decoupled Lamatic flows interoperate to power a full-stack Next.js application:

• LAMATIC_SUBMISSION_FLOW_ID: Analyzes GitHub repos, extracts tech stack, determines sponsor track match & breakout table.
• LAMATIC_SUBMISSIONS_MANAGER_FLOW_ID: Handles D1 database CRUD operations, project listing, status updates, and column-level upvotes.
• LAMATIC_SPONSORS_MANAGER_FLOW_ID: Fetches active sponsor tracks and persists new sponsors to the database.
• LAMATIC_JUDGING_MANAGER_FLOW_ID: Manages judge accounts, credentials, and criteria scoring records.
• LAMATIC_EVENT_CONFIG_FLOW_ID: Controls submission deadlines and dynamic winner declaration countdown timers.

---

⚖️ 4. Key Trade-offs & Engineering Decisions

• Client-Side Upvote Memory (localStorage): Used browser local storage to prevent users from spam-upvoting projects across page refreshes without locking down anonymous viewing.
• Transition-Only Reload Timers: Built smart timer logic that only triggers a single window.location.reload() when transitioning live from active to expired, preventing infinite refresh loops on historical dates.
• 15-Minute Security Session Timeout: Protected Admin and Judge portals with active interaction tracking to automatically invalidate sessions when left unattended.

---

🛠️ 5. Tech Stack

• Framework: Next.js 15 (App Router), TypeScript, TailwindCSS
• Animations & FX: Framer Motion, Canvas Confetti, Lucide React, Sonner
• AI & Flow Orchestration: Lamatic.ai SDK (executeFlow)
• Email Notifications: Resend API

---