# snocap/calendso architecture

> Architecture diagram of the GitHub repository snocap/calendso, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/snocap/calendso
- Repository: https://github.com/snocap/calendso

## Overview

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: [`pages/api/book/event.ts`](https://github.com/snocap/calendso/blob/main/pages/api/book/event.ts) (Booking endpoints), [`lib/calendarClient.ts`](https://github.com/snocap/calendso/blob/main/lib/calendarClient.ts) (Calendar operations), [`components/booking/pages/BookingPage.tsx`](https://github.com/snocap/calendso/blob/main/components/booking/pages/BookingPage.tsx) (Booking flow), [`ee/lib/stripe/server.ts`](https://github.com/snocap/calendso/blob/main/ee/lib/stripe/server.ts) (Stripe payments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_booking["Scheduling"]
  node_event_type["Event types<br/>[index.tsx]"]
  node_public_page["Public event page<br/>[&#91;type&#93;.tsx]"]
  node_booking_ui["Booking flow<br/>[BookingPage.tsx]"]
  node_booking_api["Booking endpoints<br/>[event.ts]"]
  node_availability["Availability<br/>[index.tsx]"]
  node_booking_management["Booking management<br/>[index.tsx]"]
end

subgraph group_accounts["Accounts &amp; teams"]
  node_auth["Authentication<br/>[&#91;...nextauth&#93;.tsx]"]
  node_security["Two-factor security"]
  node_teams["Team scheduling<br/>[index.ts]"]
end

subgraph group_integrations["Integrations"]
  node_integrations_ui["Integration settings<br/>[index.tsx]"]
  node_calendar_client["Calendar operations<br/>[calendarClient.ts]"]
  node_apple_calendar["Apple calendar adapter"]
  node_caldav_calendar["CalDAV adapter"]
  node_video["Video meetings<br/>[videoClient.ts]"]
  node_payments["Stripe payments<br/>[server.ts]"]
end

subgraph group_platform["Application platform"]
  node_webhooks["Webhook delivery<br/>[sendPayload.tsx]"]
  node_request_context["Request context<br/>[createContext.ts]"]
  node_database[("Application database<br/>[prisma.ts]")]
end

subgraph group_messaging["Notifications"]
  node_emails["Email notifications"]
end

node_invitee(("Invitee"))

node_invitee -->|"opens event"| node_public_page
node_public_page -.->|"starts booking"| node_booking_ui
node_booking_ui -.->|"submits booking"| node_booking_api
node_event_type -.->|"configures times"| node_availability
node_availability -.->|"offers slots"| node_booking_ui
node_booking_api -.->|"creates calendar event"| node_calendar_client
node_booking_ui -->|"renders within"| node_public_page
node_calendar_client -->|"dispatches to"| node_apple_calendar
node_calendar_client -->|"dispatches to"| node_caldav_calendar
node_calendar_client -->|"sends organizer mail"| node_emails
node_request_context -->|"loads user"| node_database
node_request_context -->|"gets session"| node_auth
node_security -.->|"manages account security"| node_auth
node_integrations_ui -.->|"configures calendars"| node_calendar_client
node_booking_api -.->|"creates meeting"| node_video
node_booking_api -.->|"handles payment"| node_payments
node_payments -->|"records payment"| node_database
node_payments -->|"sends payment mail"| node_emails
node_teams -.->|"supports team bookings"| node_booking_management
node_booking_management -.->|"manages bookings"| node_booking_api

click node_event_type "https://github.com/snocap/calendso/blob/main/pages/event-types/index.tsx"
click node_public_page "https://github.com/snocap/calendso/blob/main/pages/%5Buser%5D/%5Btype%5D.tsx"
click node_booking_ui "https://github.com/snocap/calendso/blob/main/components/booking/pages/BookingPage.tsx"
click node_booking_api "https://github.com/snocap/calendso/blob/main/pages/api/book/event.ts"
click node_availability "https://github.com/snocap/calendso/blob/main/pages/availability/index.tsx"
click node_booking_management "https://github.com/snocap/calendso/blob/main/pages/bookings/index.tsx"
click node_auth "https://github.com/snocap/calendso/blob/main/pages/api/auth/%5B...nextauth%5D.tsx"
click node_security "https://github.com/snocap/calendso/blob/main/components/security/TwoFactorAuthSection.tsx"
click node_teams "https://github.com/snocap/calendso/blob/main/pages/api/teams/%5Bteam%5D/index.ts"
click node_integrations_ui "https://github.com/snocap/calendso/blob/main/pages/integrations/index.tsx"
click node_calendar_client "https://github.com/snocap/calendso/blob/main/lib/calendarClient.ts"
click node_apple_calendar "https://github.com/snocap/calendso/blob/main/lib/integrations/Apple/AppleCalendarAdapter.ts"
click node_caldav_calendar "https://github.com/snocap/calendso/blob/main/lib/integrations/CalDav/CalDavCalendarAdapter.ts"
click node_video "https://github.com/snocap/calendso/blob/main/lib/videoClient.ts"
click node_payments "https://github.com/snocap/calendso/blob/main/ee/lib/stripe/server.ts"
click node_webhooks "https://github.com/snocap/calendso/blob/main/lib/webhooks/sendPayload.tsx"
click node_request_context "https://github.com/snocap/calendso/blob/main/server/createContext.ts"
click node_database "https://github.com/snocap/calendso/blob/main/lib/prisma.ts"
click node_emails "https://github.com/snocap/calendso/blob/main/lib/emails/EventOrganizerMail.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_event_type,node_public_page,node_booking_ui,node_booking_api,node_availability,node_booking_management toneBlue
class node_auth,node_security,node_teams toneAmber
class node_integrations_ui,node_calendar_client,node_apple_calendar,node_caldav_calendar,node_video,node_payments toneMint
class node_webhooks,node_request_context,node_database toneRose
class node_emails,node_invitee toneIndigo
```

## Components

### Scheduling

- [Event types](https://github.com/snocap/calendso/blob/main/pages/event-types/index.tsx): `pages/event-types/index.tsx`
- [Public event page](https://github.com/snocap/calendso/blob/main/pages/%5Buser%5D/%5Btype%5D.tsx): `pages/[user]/[type].tsx`
- [Booking flow](https://github.com/snocap/calendso/blob/main/components/booking/pages/BookingPage.tsx): `components/booking/pages/BookingPage.tsx`
- [Booking endpoints](https://github.com/snocap/calendso/blob/main/pages/api/book/event.ts): `pages/api/book/event.ts`
- [Availability](https://github.com/snocap/calendso/blob/main/pages/availability/index.tsx): `pages/availability/index.tsx`
- [Booking management](https://github.com/snocap/calendso/blob/main/pages/bookings/index.tsx): `pages/bookings/index.tsx`

### Accounts & teams

- [Authentication](https://github.com/snocap/calendso/blob/main/pages/api/auth/%5B...nextauth%5D.tsx): `pages/api/auth/[...nextauth].tsx`
- [Two-factor security](https://github.com/snocap/calendso/blob/main/components/security/TwoFactorAuthSection.tsx): `components/security/TwoFactorAuthSection.tsx`
- [Team scheduling](https://github.com/snocap/calendso/blob/main/pages/api/teams/%5Bteam%5D/index.ts): `pages/api/teams/[team]/index.ts`

### Integrations

- [Integration settings](https://github.com/snocap/calendso/blob/main/pages/integrations/index.tsx): `pages/integrations/index.tsx`
- [Calendar operations](https://github.com/snocap/calendso/blob/main/lib/calendarClient.ts): `lib/calendarClient.ts`
- [Apple calendar adapter](https://github.com/snocap/calendso/blob/main/lib/integrations/Apple/AppleCalendarAdapter.ts): `lib/integrations/Apple/AppleCalendarAdapter.ts`
- [CalDAV adapter](https://github.com/snocap/calendso/blob/main/lib/integrations/CalDav/CalDavCalendarAdapter.ts): `lib/integrations/CalDav/CalDavCalendarAdapter.ts`
- [Video meetings](https://github.com/snocap/calendso/blob/main/lib/videoClient.ts): `lib/videoClient.ts`
- [Stripe payments](https://github.com/snocap/calendso/blob/main/ee/lib/stripe/server.ts): `ee/lib/stripe/server.ts`

### Application platform

- [Webhook delivery](https://github.com/snocap/calendso/blob/main/lib/webhooks/sendPayload.tsx): `lib/webhooks/sendPayload.tsx`
- [Request context](https://github.com/snocap/calendso/blob/main/server/createContext.ts): `server/createContext.ts`
- [Application database](https://github.com/snocap/calendso/blob/main/lib/prisma.ts): `lib/prisma.ts`

### Notifications

- [Email notifications](https://github.com/snocap/calendso/blob/main/lib/emails/EventOrganizerMail.ts): `lib/emails/EventOrganizerMail.ts`

### Other components

- **Invitee**

## Connections

- 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 (evidence: `components/booking/pages/BookingPage.tsx`)
- Calendar operations → Apple calendar adapter: dispatches to (evidence: `lib/calendarClient.ts`)
- Calendar operations → CalDAV adapter: dispatches to (evidence: `lib/calendarClient.ts`)
- Calendar operations → Email notifications: sends organizer mail (evidence: `lib/calendarClient.ts`)
- Request context → Application database: loads user (evidence: `server/createContext.ts`)
- Request context → Authentication: gets session (evidence: `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 (evidence: `ee/lib/stripe/server.ts`)
- Stripe payments → Email notifications: sends payment mail (evidence: `ee/lib/stripe/server.ts`)
- Team scheduling → Booking management: supports team bookings
- Booking management → Booking endpoints: manages bookings
