NexMeet

NexMeet is an AI-powered networking and matchmaking web application designed for live events, conferences, hackathons, and community meetups. It helps attendees connect with the right people in the room by automatically pairing them with their top 3 matches based on common interests, skills, and networking goals.

---

🚀 Key Features

For Attendees

• No Downloads or Accounts: Scan a QR code or enter a 4-letter event code to join instantly without download friction.
• Smart Onboarding Form: Answer quick registration questions generated specifically for the event's theme.
• AI-Powered Matchmaking: Receive up to 3 curated connections complete with a contact method, matching reasoning, and custom conversation starters.
• Interactive Venue Map: Share real-time location to easily find matches inside the event space.

For Organizers

• AI Setup & Styling: Host inputs event details, and the AI automatically designs relevant sign-up questions and customized color schemes/fonts.
• Live Event Dashboard: Real-time RSVP counters, check-in tracking, and match logs.
• Match Timing Controls: Schedule automated matchmaking sessions or trigger matches manually on demand.
• Event Analytics: Detailed statistics, matchmaking success rates, and interactive connection graphs.

---

🛠️ Tech Stack

• Framework: Next.js (App Router)
• Language: TypeScript
• Database: PostgreSQL (managed using the pg client)
• Styling: Tailwind CSS & Vanilla CSS (enhanced with GSAP and Framer Motion)
• AI Platform: Google Gemini API via the @google/genai SDK
• Media Handling: Cloudinary (for event graphics)
• Emails: Nodemailer

---

⚙️ Getting Started

1. Clone & Install Dependencies

pnpm install

2. Configure Environment Variables

Create a .env (or .env.local) file based on .env.example:

# Email configuration
EMAIL_USER=your_email@gmail.com
EMAIL_PASS=your_app_password

# Database configuration
DATABASE_URL=postgresql://nexmeet:nexmeet@localhost:5432/nexmeet

# Media integration (Cloudinary)
NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret
NEXT_PUBLIC_CLOUDINARY_UPLOAD_PRESET=nexmeet

# Authentication
AUTH_SECRET=your_secret_key

# Google Gemini API
GEMINI_API_KEY=your_gemini_api_key

# Cron Job validation
CRON_SECRET=your_cron_secret

3. Set Up the Database

You can run the PostgreSQL database locally or via Docker:

docker-compose up -d db

To initialize the database tables, run the migration script:

npx tsx run-migration.ts

4. Run the Development Server

Start the local development server:

pnpm dev

Open http://localhost:3000 (or the port specified by the CLI) with your browser to see the result.