🗓️ Calendlify – Scheduling Made Simple

Calendlify is a full-stack scheduling application inspired by Calendly.
It allows users to create event types, manage availability, and let others book meetings through a shared link.

---

🔗 Live Links

• 🎥 Video Demo
  https://docs.google.com/videos/d/1vqmOH-kCrOXktdxyIezEyoCrfwD4DhPVEvBMmaLM_gY/edit?usp=sharing

• 🌐 Frontend (Vercel)
  https://calendlify.vercel.app/

• ⚙️ Backend API (Render)
  https://calendlify.onrender.com/

---

https://calendlify.onrender.com/

---

Core Features

1. Event Types Management

• Create event types with name, duration (in minutes), and unique URL slug
• Edit and delete existing event types
• List all event types on the scheduling page
• Each event type has a unique public booking link

2. Availability Settings

• Configure available days of the week (e.g., Monday to Friday)
• Set available time slots per day (e.g., 9:00 AM – 5:00 PM)
• Timezone-aware availability configuration

3. Public Booking Page

• Month calendar view for date selection
• Display available time slots for selected date
• Booking form to collect invitee name and email
• Prevent double booking of the same time slot
• Booking confirmation page with meeting details

4. Meetings Page

• View upcoming meetings
• View past meetings
• Cancel meetings

---

🌟 Bonus Features Implemented

• Responsive design (mobile, tablet, desktop)
• Multiple availability schedules
• Date-specific hours (override availability for specific dates)
• Custom invitee questions on booking form

---

🛠️ Tech Stack

Frontend

• React.js (Vite)
• Tailwind CSS
• React Router
• Axios
• Deployed on Vercel

Backend

• Node.js
• Express.js
• PostgreSQL (Neon DB)
• Prisma ORM
• express-validator
• date-fns
• Deployed on Render

---

🧩 Backend API Endpoints

Event Types

Method	Endpoint	Description
GET	/api/event-types	List all event types
GET	/api/event-types/:id	Get event type by ID
GET	/api/event-types/slug/:slug	Get event type by slug
POST	/api/event-types	Create event type
PUT	/api/event-types/:id	Update event type
DELETE	/api/event-types/:id	Delete event type

Availability

Method	Endpoint	Description
GET	/api/availability	Get all schedules
GET	/api/availability/default	Get default availability
POST	/api/availability	Create schedule
PUT	/api/availability/:id	Update schedule
POST	/api/availability/:id/overrides	Add date override

Bookings

Method	Endpoint	Description
GET	/api/bookings/slots/:slug/:date	Get available slots
POST	/api/bookings	Create booking
GET	/api/bookings/:id	Get booking details
PUT	/api/bookings/:id/cancel	Cancel booking
PUT	/api/bookings/:id/reschedule	Reschedule booking

Meetings

Method	Endpoint	Description
GET	/api/meetings?filter=upcoming	Get upcoming meetings
GET	/api/meetings?filter=past	Get past meetings
GET	/api/meetings/counts	Get meeting counts
PUT	/api/meetings/:id/cancel	Cancel meeting

---

🗄️ Database Schema (High Level)

• users
• event_types
• availabilities
• availability_rules
• date_overrides
• bookings

---

Setup Instructions

1. Install Dependencies

cd backend
npm install

2. Configure Environment Variables

Update .env file with your Neon PostgreSQL connection string:

DATABASE_URL="postgresql://username:password@host/database?sslmode=require"
PORT=5000
NODE_ENV=development
FRONTEND_URL=http://localhost:3000

3. Setup Database

# Generate Prisma client
npm run db:generate

# Push schema to database
npm run db:push

# Seed sample data
npm run db:seed

4. Start the Server

# Development mode (with hot reload)
npm run dev

# Production mode
npm start