BaddieLink

Stop scrolling. Start connecting.

Comment

BaddieLink

Elevator Pitch: BaddieLink is a gamified LinkedIn discovery platform that makes networking and dating on LinkedIn fun and effortless. Instead of endlessly scrolling through LinkedIn search results, users set preferences (industry, major, location, gender) and receive curated profiles in an engaging "pack opening" card game format. The app leverages PhantomBuster for LinkedIn profile scraping and AI (Google Gemini) to generate profile insights, draft personalized messages, and create conversation starters. Save matches to your roster, get AI-powered message drafts, and transform LinkedIn from a chore into an exciting discovery experience.

This repository now contains a minimal full-stack scaffold:

  • client/ – React 18 + Vite frontend
  • server/ – FastAPI backend

Tech Stack

Frontend

  • React 18 - UI framework
  • Vite - Build tool and dev server
  • Tailwind CSS - Utility-first CSS framework
  • Three.js / React Three Fiber - 3D graphics and animations
  • GSAP - Advanced animation library
  • TSParticles / React Particles - Particle effects for background
  • React Icons - Icon library
  • Google Generative AI - Client-side AI integration

Backend

  • Python 3.11 - Programming language
  • FastAPI - Modern, fast web framework for building APIs
  • Uvicorn - ASGI server
  • Motor - Async MongoDB driver
  • PyMongo - MongoDB Python driver
  • Google Generative AI (Gemini) - AI-powered profile insights and message generation
  • httpx - Async HTTP client
  • python-dotenv - Environment variable management
  • gender-guesser - Gender detection from names
  • python-multipart - File upload support

Database

  • MongoDB Atlas - Cloud database for storing search results and user data

External Services & APIs

  • PhantomBuster API - LinkedIn profile scraping and search
  • Google Gemini AI - Profile analysis, message drafting, and insights
  • Hugging Face - Beauty scoring API

Infrastructure & DevOps

  • Docker - Containerization
  • Docker Compose - Multi-container orchestration
  • Nginx - Web server and reverse proxy for frontend
  • Node.js 18 - JavaScript runtime for frontend

Development Tools

  • ESLint - Code linting
  • PostCSS - CSS processing
  • Autoprefixer - CSS vendor prefixing

Getting Started

Prerequisites

  • Node.js 18+
  • Python 3.11+

Frontend

cd client
npm install
npm run dev

Backend

cd server
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload

The React app expects the API to be available at http://127.0.0.1:8000, configurable via the VITE_API_URL env var in the frontend.

Built With

Share this project:

Updates