Peerly

A class meetup app that lets students post spontaneous hangout plans and invite classmates to join — no back-and-forth texting required.

What it does

• Class lists — Teachers or admins create a class and share an invite code. Students join with the code.
• Meetup posts — Any class member can post a plan: where they’re going, when, and how many spots are available.
• Location integration — Google Maps autocomplete for picking locations. Supports fixed times or flexible notes like “in about 30 minutes”.
• RSVP — Classmates respond with going / maybe / not going.

Tech stack

• Next.js 14 (App Router)
• NextAuth.js — credential-based auth with JWT sessions
• Prisma — ORM with PostgreSQL
• Tailwind CSS
• Google Maps JavaScript API

Getting started

Prerequisites

• Node.js 18+
• PostgreSQL database
• Google Maps API key (with Maps JavaScript API and Places API enabled)

Setup

1. Clone the repo and install dependencies:

npm install

1. Copy the environment file and fill in your values:

cp .env.example .env

Required environment variables:

DATABASE_URL=postgresql://...
NEXTAUTH_SECRET=<random secret>
NEXTAUTH_URL=http://localhost:3000
NEXT_PUBLIC_GOOGLE_MAPS_API_KEY=<your Google Maps API key>

1. Run database migrations:

npx prisma migrate deploy

1. Start the development server:

npm run dev

Open http://localhost:3000.

Database

Prisma schema is at prisma/schema.prisma. Key models:

• User — students and admins
• Class — a class list with a unique invite code
• ClassMember — join table between users and classes (with role)
• Meetup — a hangout plan tied to a class, with location and time
• Attendance — RSVP records per user per meetup

Useful commands:

npm run db:push     # push schema changes without migrations (dev)
npm run db:studio   # open Prisma Studio

Deployment

The build step runs migrations automatically:

npm run build   # runs: prisma generate && prisma migrate deploy && next build
npm run start

The app is configured for Vercel deployment. Set the environment variables in your Vercel project settings.