How snocap/calendso works
Cal.com is a self-hostable scheduling application. Its central user journey is publishing an event type, letting an invitee choose a time, and managing the resulting booking; the repository also includes calendar/video integrations, teams, account security, payments, and webhooks. The map preserves these product branches, but several API and persistence connections are unverified because their implementation was not sampled.
Main entry points: event.ts Booking endpoints · calendarClient.ts Calendar operations · BookingPage.tsx Booking flow · server.ts Stripe payments
Components 20
Scheduling
- Event types
pages/event-types/index.tsx - Public event page
pages/[user]/[type].tsx - Booking flow
components/booking/pages/BookingPage.tsx - Booking endpoints
pages/api/book/event.ts - Availability
pages/availability/index.tsx - Booking management
pages/bookings/index.tsx
Accounts & teams
- Authentication
pages/api/auth/[...nextauth].tsx - Two-factor security
components/security/TwoFactorAuthSection.tsx - Team scheduling
pages/api/teams/[team]/index.ts
Integrations
- Integration settings
pages/integrations/index.tsx - Calendar operations
lib/calendarClient.ts - Apple calendar adapter
lib/integrations/Apple/AppleCalendarAdapter.ts - CalDAV adapter
lib/integrations/CalDav/CalDavCalendarAdapter.ts - Video meetings
lib/videoClient.ts - Stripe payments
ee/lib/stripe/server.ts
Application platform
- Webhook delivery
lib/webhooks/sendPayload.tsx - Request context
server/createContext.ts - Application database
lib/prisma.ts
Notifications
- Email notifications
lib/emails/EventOrganizerMail.ts
Other components
- Invitee
Connections 20
- Invitee → Public event page: opens event
- Public event page → Booking flow: starts booking
- Booking flow → Booking endpoints: submits booking
- Event types → Availability: configures times
- Availability → Booking flow: offers slots
- Booking endpoints → Calendar operations: creates calendar event
- Booking flow → Public event page: renders within
components/booking/pages/BookingPage.tsx - Calendar operations → Apple calendar adapter: dispatches to
lib/calendarClient.ts - Calendar operations → CalDAV adapter: dispatches to
lib/calendarClient.ts - Calendar operations → Email notifications: sends organizer mail
lib/calendarClient.ts - Request context → Application database: loads user
server/createContext.ts - Request context → Authentication: gets session
server/createContext.ts - Two-factor security → Authentication: manages account security
- Integration settings → Calendar operations: configures calendars
- Booking endpoints → Video meetings: creates meeting
- Booking endpoints → Stripe payments: handles payment
- Stripe payments → Application database: records payment
ee/lib/stripe/server.ts - Stripe payments → Email notifications: sends payment mail
ee/lib/stripe/server.ts - Team scheduling → Booking management: supports team bookings
- Booking management → Booking endpoints: manages bookings