Inspiration

Hackathons can feel like speed-dating for developers—exciting, but often random. We wanted to turn team formation into a more deliberate, data-driven process. By capturing each participant’s skills, interests, and preferred roles, Neon Nexus Finder lights the path to your perfect collaborators.

What it does

  • Matchmaking: Computes similarity scores between your profile and every other participant using a blended Jaccard index:
    [ S = \frac{1}{3}\bigl(J(\text{skills}) + J(\text{interests}) + J(\text{roles})\bigr),\quad J(A,B)=\frac{|A\cap B|}{|A\cup B|} ]
  • Recommendations: Ranks the top 10 most compatible teammates.
  • Invites: Sends magical “join my team” emails via a serverless endpoint so you can build your dream squad in one click.

How we built it

  1. Frontend: Vite + React + TypeScript, styled with Tailwind CSS and shadcn/ui primitives for a neon-cyberpunk aesthetic.
  2. Auth & Database: Supabase handles magic-link sign-in, user profiles (Postgres), and real-time updates.
  3. Edge Functions:
    • qloo-recommendations: Fetches profiles, computes (S), returns matches.
    • send-team-request: Persists invites and emails teammates using the Resend API.
  4. Custom Hooks & Types: Zod + TypeScript schemas ensure type safety and runtime validation throughout.

Challenges we ran into

  • Balancing Weights: Early match lists over-favored shared interests. We experimented with weighting factors until teams felt intuitive.
  • CORS & Security: Locking down Edge Functions to authenticated clients while serving a static SPA required careful header and JWT handling.
  • Performance: Rendering dozens of avatar-rich cards on mobile caused jank. We added viewport checks (useMobile) and lazy-loaded images to smooth the UI.

Accomplishments that we're proud of

  • Zero-Config Deploy: One CLI command deploys our entire stack—database migrations, Edge Functions, and static site—directly to Supabase.
  • Real-Time Invites: Users see inbound team requests update instantly without refreshing.
  • Type-Safe Everywhere: Catching mismatches at build time saved countless debugging hours.

What we learned

  • Serverless Edge Functions can double as lightweight microservices, delivering sub-100 ms responses for matching logic.
  • Semantic CSS variables combined with Tailwind enable on-the-fly theming without recompiling.
  • Zod schemas + TypeScript deliver a fortress of data correctness, from form inputs to API payloads.

What's next for Neon Nexus Finder

  • Advanced Matching: Integrate ML-backed similarity via collaborative filtering.
  • Team Analytics: Dashboard insights on team diversity of skills and experience.
  • Mobile App: React Native version with push-notification support for instant invites on the go.

Built With

Share this project:

Updates