🎓 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
⚙️ 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.
