How khadar1020/timelymeeting works
TimelyMeet is a scheduling and appointment-booking application for event creators and bookers. Creators configure weekly availability, publish free or paid event types, and share public booking links; bookers select a slot, submit a booking, and receive meeting details. Paid bookings proceed through Stripe Checkout and are confirmed by a verified webhook. The graph includes account, meeting-management, and payout capabilities documented in the README; several route and action implementations were not sampled, so those links are cited as documented rather than inferred from source.
Main entry points: page.jsx Dashboard · prisma.js Application database · create-checkout-session/route.js Checkout session API · webhook/route.js Payment webhook
Components 25
Creator Workspace
- Dashboard
app/(main)/dashboard/page.jsx - User account actions
actions/users.js - Availability setup
app/(main)/availability/_components/availability-form.jsx - Availability actions
actions/availability.js - Event management
components/event-form.jsx - Event actions
actions/events.js - Meeting management
app/(main)/meetings/_components/meeting-actions.jsx
Public Booking
- Public profile
app/[username]/page.jsx - Public event page
app/[username]/[eventId]/page.jsx - Booking form
app/[username]/[eventId]/_components/booking-form.jsx - Booking actions
actions/bookings.js - Booking success and issue report
app/booking/success/page.jsx
Payments & Payouts
- Checkout session API
app/api/stripe/create-checkout-session/route.js - Payment webhook
app/api/stripe/webhook/route.js - Mentor Connect setup
app/(main)/dashboard/_components/stripe-connect-card.jsx - Payout service
lib/stripe-connect.js
Application Services
- Calendar integration
lib/calendar.js - Booking conflict checks
lib/bookings.js - Input validation
app/lib/validators.js - Application database
lib/prisma.js - Clerk authentication
Other components
- Event creator
- Booker
- Google Calendar
- Stripe
Connections 39
- Event creator → Dashboard: manages account
- Dashboard → User account actions: updates username
app/(main)/dashboard/page.jsx - Dashboard → Meeting management: views updates
app/(main)/dashboard/page.jsx - Event creator → Availability setup: sets hours
- Availability setup → Availability actions: loads and saves
app/(main)/availability/_components/availability-form.jsx - Availability actions → Application database: reads and writes
actions/availability.js - Event creator → Event management: creates event types
- Event management → Event actions: submits event
components/event-form.jsx - Event actions → Input validation: validates event
actions/events.js - Event actions → Application database: stores events
actions/events.js - Event creator → Meeting management: manages bookings
- Event creator → Dashboard: connects payout account
- Dashboard → Mentor Connect setup: renders setup
app/(main)/dashboard/page.jsx - Mentor Connect setup → Payout service: configures account
- Booker → Public profile: opens shared link
- Public profile → Public event page: opens public event
app/[username]/page.jsx - Public event page → Event actions: loads event details
app/[username]/[eventId]/page.jsx - Public event page → Availability actions: loads available slots
app/[username]/[eventId]/page.jsx - Public event page → Booking form: renders booking form
app/[username]/[eventId]/page.jsx - Booker → Booking form: selects slot
- Booking form → Booking actions: submits booking
app/[username]/[eventId]/_components/booking-form.jsx - Booking form → Checkout session API: starts paid checkout
- Checkout session API → Input validation: validates request
app/api/stripe/create-checkout-session/route.js - Checkout session API → Booking conflict checks: checks slot conflict
app/api/stripe/create-checkout-session/route.js - Checkout session API → Application database: loads event
app/api/stripe/create-checkout-session/route.js - Checkout session API → Stripe: creates session
app/api/stripe/create-checkout-session/route.js - Stripe → Payment webhook: sends payment event
- Payment webhook → Application database: checks and records booking
app/api/stripe/webhook/route.js - Payment webhook → Booking conflict checks: checks slot conflict
app/api/stripe/webhook/route.js - Payment webhook → Calendar integration: creates meeting event
app/api/stripe/webhook/route.js - Calendar integration → Google Calendar: creates calendar event
- Payment webhook → Payout service: calculates payout amounts
app/api/stripe/webhook/route.js - Meeting management → Payout service: handles completed payouts
- Payout service → Stripe: creates transfer
lib/stripe-connect.js - Payout service → Application database: updates payout state
lib/stripe-connect.js - Booker → Booking success and issue report: views booking outcome
- Booking success and issue report → Booking actions: reports booking issue
- Meeting management → Application database: updates meeting status
- Dashboard → Clerk authentication: reads signed-in user