🎓 Zenvy: Smart Peer-to-Peer Study Platform

Zenvy is a high-performance, real-time study platform designed to connect students through collaborative tools, AI-driven partner matching, and seamless communication.

🚀 Key Features

📡 Real-Time Communication

• Voice & Video Calling: Peer-to-peer calling using WebRTC (simple-peer) and Socket.io signaling.
• Smart Hardware Release: Automatic release of camera and microphone tracks after every call for maximum privacy.
• Global Study Lounge: A real-time lobby for all active students.
• Private DMs: Secure, direct messaging with persistence and real-time updates.

🧠 Intelligent Partner Matching

• Compatibility Scoring: Automatic synergy calculation based on majors, interests, and academic overlap.
• Partner Discovery: Easily find and connect with peers whose study habits align with yours.

📊 Dynamic Dashboard & Profiles

• Live Stats: Real-time visibility into active study groups and upcoming sessions.
• Rich Profiles: Personalized student profiles with major, college, and bio details.
• Cloud Storage: Secure profile picture uploads integrated with Supabase Storage.

✨ Visual Excellence

• Fluid Animations: Butter-smooth page transitions and staggered entrance animations.
• Premium UI: A high-end, responsive design with glassmorphism and modern typography.
• Elite Loading States: Custom-designed loading screens for a seamless UX.

🛠️ Tech Stack

• Frontend: Next.js 15+ (App Router), React, Tailwind CSS.
• Backend: Node.js (Vercel Runtime), Prisma ORM.
• Database: PostgreSQL (with PgBouncer support).
• Authentication: Auth.js v5 (NextAuth).
• Real-Time: Socket.io & WebRTC.
• Storage: Supabase Storage.
• Email: Resend.

⚙️ Setup & Installation

1. Requirements

• Node.js 18+
• PostgreSQL Database
• Supabase Account
• Resend API Key

2. Environment Variables

Create a .env file in the root directory and add the following:

# Database
DATABASE_URL="postgresql://user:password@host:port/dbname?pgbouncer=true&connection_limit=5&pool_timeout=20"
DIRECT_URL="postgresql://user:password@host:port/dbname"

# Auth
AUTH_SECRET="your-auth-secret"
NEXTAUTH_URL="http://localhost:3000"

# Optional: "Continue with Google" (the button only shows when both are set).
# Redirect URI in Google Cloud Console: <your site>/api/auth/callback/google
AUTH_GOOGLE_ID="your-google-client-id"
AUTH_GOOGLE_SECRET="your-google-client-secret"

# Supabase (Storage)
NEXT_PUBLIC_SUPABASE_URL="https://your-project.supabase.co"
NEXT_PUBLIC_SUPABASE_ANON_KEY="your-anon-key"
SUPABASE_SERVICE_ROLE_KEY="your-service-role-key"

# Resend (Email)
RESEND_API_KEY="re_..."

3. Initialize Database

npx prisma generate
npm run prisma:migrate

See docs/deployment.md for creating migrations and baselining existing databases.

4. Run Development Server

npm run dev

🧪 Testing

npm run test          # unit tests (Vitest)
npm run test:e2e      # Playwright smoke tests against `next start`
npm run test:visual   # full-page screenshots of every route (desktop + mobile) into test-results/

End-to-end tests need a production build and a local/throwaway database with seeded users:

npm run prisma:migrate
npm run db:seed:e2e   # refuses non-local DB hosts unless ALLOW_E2E_SEED=true
npm run build
AUTH_TRUST_HOST=true npm run test:e2e

Feature flags live in lib/flags.ts (for example FEATURE_JOBS=true).

Jobs portal

Off until FEATURE_JOBS=true. To use it you need:

• the 2_jobs_portal migration applied (npm run prisma:migrate),
• a private Supabase Storage bucket named job-media, and SUPABASE_SERVICE_ROLE_KEY set on the server,
• CRON_SECRET set, so the daily /api/cron/expire-jobs call in vercel.json can mark past-deadline posts as expired.

First-time posters are reviewed at /zenvy-admin/jobs. Image uploads are re-encoded to WebP and stripped of location data before storage.

📂 Project Structure

• /app: Next.js 15 app router pages and components.
• /prisma: Database schema and migrations.
• /lib: Shared utilities (Prima, Socket.io, Supabase client).
• /public: Static assets (fonts, images).

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.