Build your pixel-perfect booking experience

Demo · Docs · Deploy on Vercel

Discord · Website · Issues

Cal.com Platform Starter Kit showcases the new Cal.com Platform API and Cal.com Atoms. It was built using the T3 Stack with Supabase as the Postgres Database host.

1. Clone the repository

HTTPS:

git clone https://github.com/calcom/platform-starter-kit.git

GitHub CLI:

gh repo clone calcom/platform-starter-kit

2. Move into the Starter

cd platform-starter-kit/

3. Install dependencies

pnpm install

4. Set Environment Variables

We provide most environment variables out of the box (including Cal-related variables).

So get started by copying the .env.example:

cp .env.example .env

4.1 Database

This project uses Postgres with Supabase. You can create a free project at database.new.

Then, get the Database URL from the Supabase dashboard and update the respective values in your .env file:

POSTGRES_PRISMA_URL="postgres://postgres.YOUR-PROJECT-REF:[YOUR-PASSWORD]@aws-0-[REGION].pooler.supabase.com:6543/postgres" # Transaction Mode
POSTGRES_URL_NON_POOLING="postgres://postgres.YOUR-PROJECT-REF:[YOUR-PASSWORD]@aws-0-[REGION].pooler.supabase.com:5432/postgres"  # Session Mode

When working locally you can use the DB URL: postgresql://postgres:[email protected]:54322/postgres outputted by the supabase start command for both vairables.

[Only needed when deploying manually] Initialize the database:

Note that if you used the Vercel Deploy link from above, the Supabase Vercel integration sets this up automatically for you!

pnpm db:init
pnpm db:seed # Will throw an error if DB is already seeded, which you can ignore.

4.2 Authentication

Generate a NextAuth secret and add it to your .env file:

openssl rand -hex 32

# Next Auth
# You can generate a new secret on the command line with
# openssl rand -base64 32
# <https://next-auth.js.org/configuration/options#secret>

AUTH_SECRET="SQhGk****"

4.3 Cal

For development, you're all set! We've provided you with our sandbox keys that you can find the .env.example file.

For production, keep in mind that you'll have to update the NEXT_PUBLIC_REFRESH_URL variable to make it point to your deployment, e.g.:

# 3/ *REFRESH URL.* You have to expose an endpoint that will be used from calcom: https://cal.com/docs/platform/quick-start#4.-backend:-setting-up-refresh-token-endpoint

NEXT_PUBLIC_REFRESH_URL="https://<your-project>.vercel.app/api/cal/refresh"

5. Development Server From here, you're all set. Just start the development server & get going.

pnpm dev

We try to keep this project as simple as possible, so you can start with Cal.com Platform and the scaffolding we set up for you, and add additional things later when they become necessary.

If you are not familiar with the different technologies used in this project, please refer to the respective docs.

• Cal.com Platform
• Next.js
• NextAuth.js
• Prisma
• Tailwind CSS
• tRPC

Visit our documentation at cal.com/docs/platform or join our Discord.

Contact sales to purchase a commercial API key here: cal.com/sales.

To learn more about the T3 Stack, take a look at the following resources:

• Documentation
• Learn the T3 Stack — Check out these awesome tutorials

You can check out the create-t3-app GitHub repository — your feedback and contributions are welcome!

Supabase is the fastest way to get up and running with Next.js and Postgres. Check out this video to learn more!