diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 3edecfe1b6..f29a528b04 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -15,7 +15,6 @@ deploy/ @calcom/core scripts/ @calcom/core -apps/docs @calcom/docs apps/swagger @calcom/docs packages/app-store-cli @hariombalhara @calcom/core diff --git a/apps/docs/.gitignore b/apps/docs/.gitignore deleted file mode 100644 index fbea7fdedb..0000000000 --- a/apps/docs/.gitignore +++ /dev/null @@ -1,7 +0,0 @@ -node_modules -.next -.DS_Store -yarn-error.log -dist -examples -packages \ No newline at end of file diff --git a/apps/docs/.nvmrc b/apps/docs/.nvmrc deleted file mode 100644 index 3f430af82b..0000000000 --- a/apps/docs/.nvmrc +++ /dev/null @@ -1 +0,0 @@ -v18 diff --git a/apps/docs/.prettierignore b/apps/docs/.prettierignore deleted file mode 100644 index f74c78183c..0000000000 --- a/apps/docs/.prettierignore +++ /dev/null @@ -1,2 +0,0 @@ -.next -node_modules diff --git a/apps/docs/LICENSE b/apps/docs/LICENSE deleted file mode 100644 index 6734428423..0000000000 --- a/apps/docs/LICENSE +++ /dev/null @@ -1,21 +0,0 @@ -MIT License - -Copyright (c) 2020 Shu Ding - -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. diff --git a/apps/docs/README.md b/apps/docs/README.md deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/apps/docs/components/Anchor.tsx b/apps/docs/components/Anchor.tsx deleted file mode 100644 index b7322b6bf8..0000000000 --- a/apps/docs/components/Anchor.tsx +++ /dev/null @@ -1,21 +0,0 @@ -function getAnchor(text) { - return text - .toLowerCase() - .replace(/[^a-z0-9 ]/g, "") - .replace(/[ ]/g, "-") - .replace(/ /g, "%20"); -} - -export default function Anchor({ as, children }) { - const anchor = getAnchor(children); - const link = `#${anchor}`; - const Component = as || "div"; - return ( - - - § - - {children} - - ); -} diff --git a/apps/docs/lib/useWindowSize.ts b/apps/docs/lib/useWindowSize.ts deleted file mode 100644 index 1987e6f363..0000000000 --- a/apps/docs/lib/useWindowSize.ts +++ /dev/null @@ -1,33 +0,0 @@ -import { useState, useEffect } from "react"; - -// Define general type for useWindowSize hook, which includes width and height -export interface Size { - width: number | undefined; - height: number | undefined; -} -// Hook from: https://usehooks.com/useWindowSize/ -export function useWindowSize(): Size { - // Initialize state with undefined width/height so server and client renders match - // Learn more here: https://joshwcomeau.com/react/the-perils-of-rehydration/ - const [windowSize, setWindowSize] = useState({ - width: undefined, - height: undefined, - }); - useEffect(() => { - // Handler to call on window resize - function handleResize() { - // Set window width/height to state - setWindowSize({ - width: window.innerWidth, - height: window.innerHeight, - }); - } - // Add event listener - window.addEventListener("resize", handleResize); - // Call handler right away so state gets updated with initial window size - handleResize(); - // Remove event listener on cleanup - return () => window.removeEventListener("resize", handleResize); - }, []); // Empty array ensures that effect is only run on mount - return windowSize; -} diff --git a/apps/docs/next-env.d.ts b/apps/docs/next-env.d.ts deleted file mode 100644 index 4f11a03dc6..0000000000 --- a/apps/docs/next-env.d.ts +++ /dev/null @@ -1,5 +0,0 @@ -/// -/// - -// NOTE: This file should not be edited -// see https://nextjs.org/docs/basic-features/typescript for more information. diff --git a/apps/docs/next.config.js b/apps/docs/next.config.js deleted file mode 100644 index dce01e92c1..0000000000 --- a/apps/docs/next.config.js +++ /dev/null @@ -1,17 +0,0 @@ -/* eslint-disable @typescript-eslint/no-var-requires */ -const withNextra = require("nextra")({ - theme: "nextra-theme-docs", - themeConfig: "./theme.config.js", - unstable_staticImage: true, -}); -module.exports = withNextra({ - async rewrites() { - return [ - // This redirects requests recieved at /api to /public-api to workaround nextjs default use of /api. - { - source: "/api", - destination: "/public-api", - }, - ]; - }, -}); diff --git a/apps/docs/package.json b/apps/docs/package.json deleted file mode 100644 index 236c09a272..0000000000 --- a/apps/docs/package.json +++ /dev/null @@ -1,31 +0,0 @@ -{ - "name": "@calcom/docs", - "version": "1.0.0", - "private": true, - "description": "", - "main": "index.js", - "scripts": { - "build": "next build", - "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf .next", - "dev": "PORT=4000 next", - "lint": "eslint . --ignore-path .gitignore", - "lint:fix": "eslint . --ext .ts,.js,.tsx,.jsx --fix", - "lint:report": "eslint . --format json --output-file ../../lint-results/docs.json", - "start": "PORT=4000 next start", - "type-check": "tsc --pretty --noEmit", - "type-check:ci": "tsc-absolute --pretty --noEmit" - }, - "author": "Cal.com, Inc.", - "license": "MIT", - "dependencies": { - "iframe-resizer-react": "^1.1.0", - "next": "^13.2.1", - "nextra": "^1.1.0", - "nextra-theme-docs": "^1.2.2", - "react": "^18.2.0", - "react-dom": "^18.2.0" - }, - "devDependencies": { - "@calcom/config": "*" - } -} diff --git a/apps/docs/pages/_app.tsx b/apps/docs/pages/_app.tsx deleted file mode 100644 index e8aad3b926..0000000000 --- a/apps/docs/pages/_app.tsx +++ /dev/null @@ -1,8 +0,0 @@ -import type { AppProps } from "next/app"; -import "nextra-theme-docs/style.css"; - -import "./style.css"; - -export default function Nextra({ Component, pageProps }: AppProps) { - return ; -} diff --git a/apps/docs/pages/billing.mdx b/apps/docs/pages/billing.mdx deleted file mode 100644 index 36ede5c157..0000000000 --- a/apps/docs/pages/billing.mdx +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Billing ---- - -# Billing -## How the trial works -You are given FREE access for 14 days of our PRO subscription, you can use this to test and try out our product and see if it works for you. No credit card is required to sign up and you decide if you want to upgrade to a PRO subscription afterwards. - -## How to cancel the trial -If you are looking to cancel the trial and want to downgrade to the free option you can contact our support team where we will be happy to help you make that change! - -## How to upgrade -If you are looking at upgrading from our FREE subscription to our PRO subscription, head over to cal.com/upgrade where you can easily upgrade hassle free. - -## How to downgrade -1. Go to your [Billing Settings](https://app.cal.com/settings/billing). -2. From here you can press the button called `Go to the billing Portal`. That will take you to the page where you can upgrade/downgrade your plan. - -## How to delete your account -You can delete your account from within the [Settings](https://app.cal.com/settings/profile) option. Just scroll all the way down and click on `Delete Account`. - -## Purchasing a premium username -We've reserved a ton of premium usernames, such as short handles or first names to prevent name squatters. To find out if your username is premium, head over to [cal.com/signup](https://cal.com/signup) and choose your desired username. From here you will be taken straight to checkout and after proceeding your Cal.com account will be created with your desired username. - -## Manage your subscription -1. Go to your [Billing Settings](https://app.cal.com/settings/billing). -2. From here you can press the button called `Go to the billing Portal`. -3. This will take you to an external site provided by Stripe as they deal with all our payments. - -Some users may not be able to access Billing as their billing email is different to their account email. If this is the case, you can change the email associated with your account in [Profile Settings](https://app.cal.com/settings/profile). - -## Subscription for each team member -If your team requires multiple event types then each team member has to be subscribed to our paid plan. If that is something that isn’t necessary for your team, you can proceed with your FREE plan. - -## Discount for non-profits and students -We offer 50% for non-profit organizations and students. Just raise a ticket with our support team and submit the necessary proof of status. - diff --git a/apps/docs/pages/bookings.mdx b/apps/docs/pages/bookings.mdx deleted file mode 100644 index 0519aeec30..0000000000 --- a/apps/docs/pages/bookings.mdx +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Bookings ---- - -# Bookings - -## What can you do on the bookings page? - -On the bookings page you are able to see upcoming and past events booked through your event type links. This page also lets you cancel or reschedule upcoming events users have scheduled. - -## How to view bookings - -1. Go to [your upcoming and past bookings](https://app.cal.com/bookings/upcoming). -2. On this page you can see upcoming and past events booked through your event type links. - -## Reschedule bookings - -1. Go to [your rescheduled bookings](https://app.cal.com/bookings/upcoming). -2. Hovering over the event you want to reschedule, click the button saying 'Reschedule' -3. Clicking 'Reschedule' will bring you to your Cal booking page. Select a new Time and Date. -4. After selecting this you can go ahead and click that 'Reschedule' Button! -5. After, you and your attendee will receive a new confirmation email of your new date and time. - -## Cancel bookings - -1. Go to [your cancelled](https://app.cal.com/bookings/cancelled). -2. Hovering over the event you want to cancel, click the button saying 'Cancel' -3. Once done, you will receive a confirmation message saying 'Really cancel your booking?'. After confirming you can go ahead and click the red 'Cancel' button at the bottom of your screen. -4. After, you and your attendee will receive a new confirmation email of your event being cancelled. diff --git a/apps/docs/pages/contributing.mdx b/apps/docs/pages/contributing.mdx deleted file mode 100644 index 0714ddd466..0000000000 --- a/apps/docs/pages/contributing.mdx +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: Contributing ---- - -# Contributing - -Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**. - -- Before jumping into a PR be sure to search [existing PRs](https://github.com/calcom/cal.com/pulls) or [issues](https://github.com/calcom/cal.com/issues) for an open or closed item that relates to your submission. - -## Developing - -The development branch is `main`. This is the branch that all pull -requests should be made against. The changes on the `main` -branch are tagged into a release monthly. - -To develop locally: - -1. [Fork](https://help.github.com/articles/fork-a-repo/) this repository to your - own GitHub account and then - [clone](https://help.github.com/articles/cloning-a-repository/) it to your local device. -2. Create a new branch: - - ```sh - git checkout -b MY_BRANCH_NAME - ``` - -3. Install yarn: - - ```sh - npm install -g yarn - ``` - -4. Install the dependencies with: - - ```sh - yarn - ``` - -5. Start developing and watch for code changes: - - ```sh - yarn dev - ``` - -## Building - -You can build the project with: - -```bash -yarn build -``` - -Please be sure that you can make a full production build before pushing code. - -## Testing - -More info on how to add new tests coming soon. - -### Running tests - -This will run and test all flows in multiple Chromium windows to verify that no critical flow breaks: - -```sh -yarn test-e2e -``` - -## Linting - -To check the formatting of your code: - -```sh -yarn lint -``` - -If you get errors, be sure to fix them before comitting. - -## Making a Pull Request - -- Be sure to [check the "Allow edits from maintainers" option](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork) while creating you PR. -- If your PR refers to or fixes an issue, be sure to add `refs #XXX` or `fixes #XXX` to the PR description. Replacing `XXX` with the respective issue number. Se more about [Linking a pull request to an issue - ](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue). -- Be sure to fill the PR Template accordingly. diff --git a/apps/docs/pages/developer/adding-css.mdx b/apps/docs/pages/developer/adding-css.mdx deleted file mode 100644 index 219d1187dd..0000000000 --- a/apps/docs/pages/developer/adding-css.mdx +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Adding CSS ---- - -import Callout from "nextra-theme-docs/callout"; - -# Adding CSS - - - Adding or modifying CSS counts as changing the code, so as per [our license](https://github.com/calcom/cal.com/blob/main/LICENSE) you must either open-source your modified version or purchase an enterprise license. - - -Cal.com uses [TailwindCSS](https://tailwindcss.com) as a replacement for traditional CSS styling within the application, but some people prefer to add CSS styles themselves. - -CSS files should be stored in the `styles` directory within the codebase. - -Within the `styles` directory, you will find a single CSS file, `global.css`. We suggest not to add to this file, and instead create new CSS files and import them into the application. This helps reduce conflicts when pulling in changes that we've made to either of the existing CSS files. - -## Adding new stylesheets -Firstly, create the CSS file inside the `styles` directory. - -Then, open the `pages/_app.tsx` file, and you will see the following two lines: -```javascript -import "../styles/globals.css"; -``` - -Duplicate one of these import statements and change the path to link to your new CSS stylesheet, like so: -```javascript -import "../styles/your-new-stylesheet.css"; -``` - - - These styles will apply to all pages and components in your application. - - -Due to the global nature of stylesheets, and to avoid conflicts, you may **only import them inside `pages/_app.tsx`**. diff --git a/apps/docs/pages/developer/app-store.mdx b/apps/docs/pages/developer/app-store.mdx deleted file mode 100644 index c0acd23996..0000000000 --- a/apps/docs/pages/developer/app-store.mdx +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Contributing to App Store ---- - -# Contributing to the App Store - -Since Cal.com is open source we encourage developers to create new apps for others to use. This guide is to help you get started. - -## Structure - -All apps can be found under `packages/app-store`. In this folder is `_example` which shows the general structure of an app. - -```sh -├──_example -| -| ├──api -| | ├──example.ts -| | ├──index.ts -| -| ├──components -| | ├──InstallAppButton.tsx -| | ├──index.ts -| -| ├──lib -| | ├──adaptor.ts -| | ├──index.ts -| -| ├──static -| | ├──icon.svg -| -| ├──index.ts -| ├──package.json -| ├──.env.example -| ├──DESCRIPTION.md -``` - -## Getting Started - -In the `package.json` name your package appropriately and list the dependencies needed for the package. - -Next in the `.env.example` specify the environmental variables (ex. auth token, API secrets) that your app will need. In a comment add a link to instructions on how to obtain the credentials. Create a `.env` with your the filled in environmental variables. - -In `index.js` fill out the meta data that will be rendered on the app page. Under `packages/app-store/index.ts`, import your app and add it under `appStore`. Your app should now appear in the app store. - -Under the `/api` folder, this is where any API calls that are associated with your app will be handled. Since cal.com uses Next.js we use dynamic API routes. In this example if we want to hit `/api/example.ts` the route would be `{BASE_URL}/api/integrations/_example/example`. Export your endpoints in an `index.ts` file under `/api` folder and import them in your main `index.ts` file. - -Under the `/components` folder, this is where the install button for your app should live. Follow the template under `_example` to add your on click action (ex. Redirecting to a log in page or opening a modal). - -The `/lib` folder is where the functions of your app live. For example, when creating a booking with a MS Teams link the function to make the call to grab the link lives in the `/lib` folder. Export your endpoints in an `index.ts` file under `/lib` folder and import them in your main `index.ts` file. - -On the app store page you can customize your apps description by adding a markdown file called `DESCRIPTION.md`. If you do not add one then the description from you `package.json` will be used instead. - -The `/static` folder is where you can store your app icon and any images that your `DESCRIPTION.md` may use. - -## Adding Your App to the App Store -To render your app on the app store page, go to `packages/app-store/index.ts`. Import your app into the file and add it to the `appStore` object. - -Under `packages/app-store/components.tsx`, in the `InstallAppButtonMap` object dynamically import your install button. Your install button should live under `{your_app}/components`. - -If you need any help feel free to join us on [Slack](https://cal.com/slack) diff --git a/apps/docs/pages/developer/code-styling.mdx b/apps/docs/pages/developer/code-styling.mdx deleted file mode 100644 index b18a4cf26b..0000000000 --- a/apps/docs/pages/developer/code-styling.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Code styling ---- - -# Code Styling -Keeping our code styles consistent is key to making the repository easy to read and work with. - -We use a number of style guides written by other amazing companies, simply because they are widely used and because we like working with them. - -We don't expect you to study every single rule of each style guide, but these are great reference points as to how your code should be styled. We may reject a pull request if your code style significantly differs from these style guides however. - -## ESLint & Prettier -Cal.com uses the ESLint and Prettier formatting tools, and the repository comes with defined rules for each tool. We recommend setting up both tools and using these to help automatically style your code to our guidelines. - -## JavaScript/TypeScript -We use the [Airbnb JavaScript Style Guide](https://github.com/airbnb/javascript) for all JavaScript and TypeScript code. - -## HTML & CSS -We use the [Google HTML/CSS Style Guide](https://google.github.io/styleguide/htmlcssguide.html) for any HTML and CSS markup. However, exceptions to the HTML guide apply where JSX differentiates from standard HTML. diff --git a/apps/docs/pages/developer/meta.json b/apps/docs/pages/developer/meta.json deleted file mode 100644 index be45eb35eb..0000000000 --- a/apps/docs/pages/developer/meta.json +++ /dev/null @@ -1,9 +0,0 @@ -{ - "migrations": "Migrations", - "pre-fill": "Pre-fill fields", - "code-styling": "Code styling", - "project-structure": "Project structure", - "pull-requests": "Pull requests", - "adding-css": "Adding CSS", - "app-store": "Contributing to App Store" -} diff --git a/apps/docs/pages/developer/migrations.mdx b/apps/docs/pages/developer/migrations.mdx deleted file mode 100644 index 28d5acefa3..0000000000 --- a/apps/docs/pages/developer/migrations.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Migrations ---- - -# Database Migrations -As described in the [upgrade guide](https://docs.cal.com/self-hosting/upgrade), you should use the `yarn workspace @calcom/prisma db-migrate` or `yarn workspace @calcom/prisma db-deploy` command to update the database. - -We use database migrations in order to handle changes to the database schema in a more secure and stable way. This is actually very common. The thing is that when just changing the schema in `schema.prisma` without creating migrations, the update to the newer database schema can damage or delete all data in production mode, since the system sometimes doesn't know how to transform the data from A to B. Using migrations, each step is reproducable, transparent and can be undone in a simple way. - -## Creating migrations -If you are modifying the codebase and make a change to the `schema.prisma` file, you must create a migration. - -To create a migration for your previously changed `schema.prisma`, simply run the following: -```sh -yarn workspace @calcom/prisma db-migrate -``` - -Now, you must create a short name for your migration to describe what changed (for example, "user_add_email_verified"). Then just add and commit it with the corresponding code that uses your new database schema. - -:::caution - -Always keep an eye on what migrations Prisma is generating. Prisma often happily will drop entire columns of data because it can't figure out what to do. - -::: - -## Error: The database schema is not empty -Prisma uses a database called `_prisma_migrations` to keep track of which migrations have been applied and which haven't. If your local migrations database doesn't match up with what's in the actual database, then Prisma will throw the following error: -```text -Error: P3005 - -The database schema for `localhost:5432` is not empty. Read more about how to baseline an existing production database: https://pris.ly/d/migrate-baseline -``` - -In order to fix this, we need to tell Prisma which migrations have already been applied. - -This can be done by running the following command, replacing `migration_name` with each migration that you have already applied: -```sh -yarn prisma migrate resolve --applied migration_name -``` - -You will need to run the command for each migration that you want to mark as applied. diff --git a/apps/docs/pages/developer/pre-fill.mdx b/apps/docs/pages/developer/pre-fill.mdx deleted file mode 100644 index e4c6075811..0000000000 --- a/apps/docs/pages/developer/pre-fill.mdx +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Pre-fill fields ---- - -# Pre-fill fields - -You can pre-fill a number of fields on the booking form by using their corresponding URL parameters. This can include the user’s name, email, or guests to be added to the booking. - -Usually when they go to the link, all that is needed will be the time of the booking, and the form will be pre-filled with the information given. - -Pre-filling booking fields can save a lot of time and speed up processes with filling out these forms, and assist with a smooth integration with your existing website or app. - -You can pre-fill a user’s name and email address like so: -```text -cal.com/rick/quick-chat/?email=attendee@example.com&name=John -``` -The data is persisted through the 3 booking pages; and is used to prefill the booking form. - -Guests can also be added to the link, there is also no limit to the amount of guests you wish to add. - -These should be added to your link like this: -```text -guest=guest1@example.com&guest=guest2@example.com -``` diff --git a/apps/docs/pages/developer/project-structure.mdx b/apps/docs/pages/developer/project-structure.mdx deleted file mode 100644 index 72449b6e37..0000000000 --- a/apps/docs/pages/developer/project-structure.mdx +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Project structure ---- - -# Project Structure - -This page gives an overview of how the codebase is structured so you can easily dive into the Cal.com code. - -Cal.com is written in Next.js, so you will find that we follow Next.js best practices for structure and layouts. - -## Basic folder structure - -The project comprises of the following folder structure: - -```text -.github/ - GitHub configuration files - ISSUE_TEMPLATE/ - workflows/ -.husky/ - Git hooks -.vscode/ - VS Code editor configuration -components/ - Application components - booking/ - dialog/ - team/ - ui/ -lib/ - Reusable code - emails/ - events/ - forgot-password/messaging/ - integrations/CalDav/ - teams/ -pages/ - Most of the project lives here - [user]/ - Booking pages - api/ - The backend API - auth/ - Next-Auth.js and other authentication routes - availability/ - bookings/ - cancel/ - event-types/ - integrations/ - reschedule/ - settings/ - team/ -prisma/ - The database schema and migrations - migrations/ -public/ - Images and static files - integrations/ -styles/ -test/lib/ -``` diff --git a/apps/docs/pages/developer/pull-requests.mdx b/apps/docs/pages/developer/pull-requests.mdx deleted file mode 100644 index 56d698d0f3..0000000000 --- a/apps/docs/pages/developer/pull-requests.mdx +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Pull requests ---- - -# Pull Requests - -## Requirements - -We have a number of requirements for PRs to ensure they are as easy to review as possible and to ensure that they are up to standard with the code. - -### Title & Content - -Start by providing a short and concise title. Don’t put something generic (e.g. bug fixes), and instead mention more specifically what your PR achieves, for instance “Fixes dropdown not expanding on settings page”. - -For the PR description, you should go into much greater detail about what your PR adds or fixes. Firstly, the description should include a link to any relevant issues or discussions surrounding the feature or bug that your PR addresses. - -#### Feature PRs - -Give a functional overview of how your feature works, including how the user can use the feature. Then, share any technical details in an overview of how the PR works (e.g. “Once the user enters their password, the password is hashed using BCrypt and stored in the Users database field”). - -#### Bug Fix PRs - -Give an overview of how your PR fixes the bug both as a high-level overview and a technical explanation of what caused the issue and how your PR resolves this. - -Feel free to add a short video or screenshots of what your PR achieves. Loom is a great way of sharing short videos. - -### Code Quality & Styling - -All submitted code must match our [code styling](/docs/code-styling) standards. We will reject pull requests that differ significantly from our standardised code styles. - -All code is automatically checked by Codacy and our linting process, and will notify you if there are any issues with the code that you submit. We require that code passes these quality checks before merging. - -## PR review process - -At least two members of the Calendso team should review and approve any PR before it is merged. - -Once two members of the team have approved this, someone from the team will merge the PR. If you are part of the Calendso team, you should merge your own PRs once you have received both approvals. diff --git a/apps/docs/pages/event-types.mdx b/apps/docs/pages/event-types.mdx deleted file mode 100644 index 8d34cfb87a..0000000000 --- a/apps/docs/pages/event-types.mdx +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: Event Types ---- - -# Event Types -Event types allow you to create different events for different occasions when booking a time with you in your calendar. These can be named differently, have different time durations and the choice of platform can change. - -## Creating an event type -1. Go to [Your Event Types](https://app.cal.com/event-types). -2. Click the button at the top right of your screen saying '+ New Event Type'. -3. Create the title of your new event. -4. Confirm the auto-generated event type URL. -5. Create a description on what your event will be used for. -6. Decide on the amount of minutes you wish for this event to last for. -7. Press 'Continue' -8. Your event has now been created! - -## Editing event types -1. Go to [Your Event Types](https://app.cal.com/event-types). -2. Click anywhere within the box of the event you would like to edit. - (From here you can edit the basic settings of your event) -3. To get the advanced options, at the bottom of your event setting click 'Show Advanced Settings' -4. After you have finished editing the event type, scroll to the bottom of your page and select 'Update' -5. Your event type has now been updated. - -## Deleting event types -1. Go to [Your Event Types](https://app.cal.com/event-types). -2. Click anywhere within the box of the event, just like you would if you were editing the event. -3. From this page, just to the right, a button saying 'delete' will appear. Click this and your event will be deleted! - -## How to block a time slot before/after a meeting -You can block out a time frame in your calendar only after the meeting. You can do this by selecting `Show advanced settings` of your Event Type. The setting is labeled `Time-slot intervals`. - -## Setting up specific availability for each type of Event -Head to `Show advanced settings` of your event. At the bottom you can set up specific availability for different Event Types. - -## Availability not showing on a certain day in your calendar -Head over to your event and once you click on `Show advanced settings`, make sure your time zones are correct. Also, check if you have any calendar events scheduled that could overlap with your availability. - -## People can't book me even though there is still a couple of hours left on my availability for today -Head over to your event and once you click on `Show advanced settings`, have a look at the `Minimum booking notice`. It probably overlaps with your availability so make sure that notice fits your desired time frame for meetings. For example, if someone wants to book a meeting with you at 16:15 and it’s already 15:30, your 90 minutes minimum booking notice doesn’t allow that meeting to be booked. - - diff --git a/apps/docs/pages/faq.mdx b/apps/docs/pages/faq.mdx deleted file mode 100644 index dcc176fc30..0000000000 --- a/apps/docs/pages/faq.mdx +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: FAQs ---- - -# Frequently asked questions - -## Does Cal.com support a custom domain? -This is possible with our self-hosted option. - -## Is there a possibility of multi-bookings for events where more people can book at the same time? -As it stands this is currently not possible. We always keep an eye on the limitations like these that our users point to us. We’ve had requests in the past for the multi-booking feature and this is on our priority list. - -## How to quickly block further bookings? -1. Click on the lower left corner of your dashboard where your username is displayed. -2. That initiates a dropdown menu. Click on `Set yourself as away`. - -This is a method to disable your Cal.com account which won't allow any bookings once initiated. However, bookings made before turning on *away mode* will still be booked. diff --git a/apps/docs/pages/import.mdx b/apps/docs/pages/import.mdx deleted file mode 100644 index dac0d5e3a2..0000000000 --- a/apps/docs/pages/import.mdx +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Import ---- - -import Callout from "nextra-theme-docs/callout"; - -# Import data from other scheduling tools - -When setting up your Cal.com account via the onboarding process, you can import data from other scheduling tools, such as Calendly or SavvyCal. All that you need to import your data is an access token, which you can retrieve from your Calendly/SavvyCal account. - -Once you've pasted your access token, we import your account data in less than a second. - -Naturally, we take security very seriously when it comes to importing your data from other accounts, so that's why we never store your access token, and use it once to query the Calendly/SavvyCal APIs, populate your account with the data it returns, and then your key is destroyed from memory. All of the importer code can be [freely viewed on GitHub](https://github.com/calcom/cal.com/tree/main/pages/api/import), so you can be assured we're not using your data for malicious purposes. - -## Calendly -The following steps will help you retrieve your Calendly access token, which you will need to present at the import screen of the onboarding process. -1. Go to the Calendly website and click on **My Account** in the top right -2. Now click on **Integrations** in the top right -3. Scroll to the bottom and click on **API & Webhooks** -4. Click the blue **Generate new token** button and type in anything you'd like as the app name -5. Press **Copy token** and then paste it into the Cal.com importer - - Even though we don't store your access token, you can press **Revoke** to destroy the access token from the **API & Webhooks** page once the import is complete. - - -## SavvyCal -The following steps will help you retrieve your SavvyCal access token, which you will need to present at the import screen of the onboarding process. -1. Head to the SavvyCal website and click **Settings** in the sidebar -2. Click the **Developers** tab, and under **Personal access tokens**, click the blue **Create a token** link -3. Give the token any name you'd like, and then confirm -4. Click to copy the token, and then paste the token into the Cal.com importer - - Even though we don't store your access token, you can press the trash icon to revoke the access token from the **Developers** tab once the import is complete. - diff --git a/apps/docs/pages/index.mdx b/apps/docs/pages/index.mdx deleted file mode 100644 index 94b8d51ebb..0000000000 --- a/apps/docs/pages/index.mdx +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Home ---- - -import Bleed from "nextra-theme-docs/bleed"; - -# Cal.com Documentation - -Welcome to our product documentation, where you can explore advice and explanations for all of our features, as well as discover new tips and tricks to get the most out of your subscription. - -This is also the home of our design system documentation and developer docs. - -If you don't already know what Cal.com is about, please head over to [our website](https://cal.com), where you can learn more about the product before venturing into the documentation. - -Want to help make these docs even better? This site is fully open source, and the source code is available on [GitHub](https://github.com/calcom/cal.com/tree/main/apps/docs). You can also click the edit button at the bottom of any page to start editing the source code and start a pull request. - -![Telemedicine Example](https://cal.com/telemedicine-example.svg) diff --git a/apps/docs/pages/integrations/embed.mdx b/apps/docs/pages/integrations/embed.mdx deleted file mode 100644 index 7a876d8b45..0000000000 --- a/apps/docs/pages/integrations/embed.mdx +++ /dev/null @@ -1,262 +0,0 @@ ---- -title: Embed ---- - -import Anchor from "../../components/Anchor" - -# Embed - -The Embed allows your website visitors to book a meeting with you directly from your website. - -## Install on any website - -Install the following Vanilla JS Snippet to get embed to work on any website. After that you can choose any of the ways to show your Cal Link embedded on your website. - -```html - -``` - -## Install with a Framework - -### embed-react - -It provides a react component `` that can be used to show the embed inline at that place. - -```bash -yarn add @calcom/embed-react -``` - -### Any XYZ Framework - -You can use Vanilla JS Snippet to install - -Popular ways in which you can embed on your website - -Assuming that you have followed the steps of installing and initializing the snippet, you can show the embed in following ways: - -### Inline - -Show the embed inline inside a container element. It would take the width and height of the container element. - -
- _Vanilla JS_ - -```html - - -*Sample sandbox* -``` - -
- -#### - -
-_React_ - -```jsx -import Cal from "@calcom/embed-react"; - -const MyComponent = () => ( - -); -``` - -*Sample sandbox* - - -
- -### Popup on any existing element - -To show the embed as a popup on clicking an element, add `data-cal-link` attribute to the element. - -
- -Vanilla JS - -To show the embed as a popup on clicking an element, simply add `data-cal-link` attribute to the element. - -*Sample sandbox* - - - -
-
- React - ```jsx - import "@calcom/embed-react"; - - const MyComponent = ()=> { - return - } -``` - -*Sample sandbox* - - -
- -### Floating pop-up button - -```html - -``` - -*Sample sandbox* - - -## Supported Instructions - -Consider an instruction as a function with that name and that would be called with the given arguments. - -### `inline` - -Appends embed inline as the child of the element. - -```html - -```` - -- `elementOrSelector` - Give it either a valid CSS selector or an HTMLElement instance directly - -- `calLink` - Cal Link that you want to embed e.g. john. Just give the username. No need to give the full URL [https://cal.com/john](). It makes it easy to configure the calendar host once and use as many links you want with just usernames - -### `ui` - -Configure UI for embed. Make it look part of your webpage. - -```html - -``` - -- `styles` - It supports styling for `body` and `eventTypeListItem`. Right now we support just background on these two. - -### preload - -Usage: - -If you want to open cal link on some action. Make it pop open instantly by preloading it. - -```html - -``` - -- `calLink` - Cal Link that you want to embed e.g. john. Just give the username. No need to give the full URL [https://cal.com/john]() - -## Actions -You can listen to an action that occurs in embedded cal link as follows. You can think of them as DOM events. We are avoiding the term "events" to not confuse it with Cal Events. -```html - -``` - -Following are the list of supported actions. -- -| Action | Description | Properties | -|----------------------|------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| eventTypeSelected | When user chooses an event-type from the listing. | eventType:object // Event Type that has been selected" | -| bookingSuccessful | When the booking is successfully done. It might not be confirmed. | confirmed: boolean; //Whether confirmation from organizer is pending or not

eventType: "Object for Event Type that has been booked";

date: string; // Date of Event

duration: number; //Duration of booked Event

organizer: object //Organizer details like name, timezone, email | -| linkReady | Tells that the link is ready to be shown now. | None | -| linkFailed | Fired if link fails to load | code: number; // Error Code

msg: string; //Human Readable msg

data: object // More details to debug the error | -| __iframeReady | It is fired when the embedded iframe is ready to communicate with parent snippet. This is mostly for internal use by Embed Snippet | None | -| __windowLoadComplete | Tells that window load for iframe is complete | None | -| __dimensionChanged | Tells that dimensions of the content inside the iframe changed. | iframeWidth:number, iframeHeight:number | - -_Actions that start with __ are internal._ \ No newline at end of file diff --git a/apps/docs/pages/integrations/google.mdx b/apps/docs/pages/integrations/google.mdx deleted file mode 100644 index 06de91189a..0000000000 --- a/apps/docs/pages/integrations/google.mdx +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Google ---- - -# Google Calendar -The Google Calendar integration checks for availability in your Google Calendars and creates bookings for you. - -## Removing Permissions for Cal to access your Google Account - -1. Go to your [Google Account](https://myaccount.google.com/). -2. On the left, click Data & privacy. -3. Scroll to "Data from apps and services you use." -4. Under "Download or delete your data," click Delete a Google service. You may need to sign in again. -5. Next to the product you want to remove, click Delete. -6. Follow the steps on the screen. - -To remove a product from your account that isn't listed in your Google Account, visit [Google Support](https://support.google.com) for more info on a specific product. - -## Obtaining the Google API Credentials -1. Open [Google API Console](https://console.cloud.google.com/apis/dashboard). If you don't have a project in your Google Cloud subscription, you'll need to create one before proceeding further. Under Dashboard pane, select Enable APIS and Services. -2. In the search box, type calendar and select the Google Calendar API search result. -3. Enable the selected API. -4. Next, go to the [OAuth consent screen](https://console.cloud.google.com/apis/credentials/consent) from the side pane. Select the app type (Internal or External) and enter the basic app details on the first page. -5. In the second page on Scopes, select Add or Remove Scopes. Search for Calendar.event and select the scope with scope value `.../auth/calendar.events`, `.../auth/calendar.readonly`, `.../auth/calendar` and select Update. -6. In the third page (Test Users), add the Google account(s) you'll using. Make sure the details are correct on the last page of the wizard and your consent screen will be configured. -7. Now select [Credentials](https://console.cloud.google.com/apis/credentials) from the side pane and then select Create Credentials. Select the OAuth Client ID option. -8. Select Web Application as the Application Type. -9. Under Authorized redirect URI's, select Add URI and then add the two URIs `/api/integrations/googlecalendar/callback` and `/api/auth/callback/google` replacing CALENDSO URL with the URI at which your application runs. -10. The key will be created and you will be redirected back to the Credentials page. Select the newly generated client ID under OAuth 2.0 Client IDs. -11. Select Download JSON. Copy the contents of this file and paste the entire JSON string in the .env file as the value for GOOGLE_API_CREDENTIALS key. - -## Where to find the Google Meet integration? - -Google Meet is a part of the Google Calendar integration and it should be available once you've added your Google Calendar. Just select Google Meet as location for your Event Type: - -1. Go to your `Event Types`. -2. Click on the `Location` drop-down menu. -3. Select Google Meet as the location of your meeting. - -Once your Event Type slot is booked, it will automatically generate the Google Meet link for the meeting. diff --git a/apps/docs/pages/integrations/introduction.mdx b/apps/docs/pages/integrations/introduction.mdx deleted file mode 100644 index fc3af40f72..0000000000 --- a/apps/docs/pages/integrations/introduction.mdx +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Introduction ---- - -# Integrations - -## Connecting new calendars -1. Go to the [Cal App Store](https://app.cal.com/apps). -2. Located at the top right of the screen, press the button saying '+ Connect A New App' -3. Choose the account your calendar is connected too by clicking 'Add'. (e.g. Google, Office 365, Zoom) -4. You will be redirected to the log in page of the chosen account. -5. Allow Cal access to view and edit your calendars. -6. You will be sent back to the [Cal App Store](https://app.cal.com/apps/installed). From here you will now be able to see your connected calendar! - -## How to choose the primary Calendar? - -If you have two or more integrated calendars and you want your events to show in only one, you can define a primary calendar like this: - -1. Go to your [Installed](https://app.cal.com/apps/installed) page. -2. Next to your `Calendars` you will see a dropdown that says `Create events on:`. -3. Select your primary calendar. diff --git a/apps/docs/pages/integrations/meta.json b/apps/docs/pages/integrations/meta.json deleted file mode 100644 index 7b74194351..0000000000 --- a/apps/docs/pages/integrations/meta.json +++ /dev/null @@ -1,9 +0,0 @@ -{ - "introduction": "Introduction", - "google": "Google", - "microsoft": "Microsoft", - "zoom": "Zoom", - "stripe": "Stripe", - "zapier": "Zapier" - } - \ No newline at end of file diff --git a/apps/docs/pages/integrations/microsoft.mdx b/apps/docs/pages/integrations/microsoft.mdx deleted file mode 100644 index afdfeaf118..0000000000 --- a/apps/docs/pages/integrations/microsoft.mdx +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Microsoft ---- - -# Outlook/Microsoft 365 -The Outlook integration enables you to use your outlook.com or Microsoft 365 account to use for conflict checking and event bookings. - -## Obtaining Microsoft Graph Client ID and Secret -1. Open [Azure App Registration](https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps) and select New registration -2. Name your application -3. Set **Who can use this application or access this API?** to **Accounts in any organizational directory (Any Azure AD directory - Multitenant)** -4. Set the **Web** redirect URI to `/api/integrations/office365calendar/callback` replacing CALENDSO URL with the URI at which your application runs. -5. Use **Application (client) ID** as the **MS_GRAPH_CLIENT_ID** attribute value in .env -6. Click **Certificates & secrets** create a new client secret and use the value as the **MS_GRAPH_CLIENT_SECRET** attribute - -## Removing Permissions for Cal to access your Microsoft Workplace Account - -Hover over Cal.com in the my apps portal, then select `manage your application`. - -The top part of permissions window shows what you personally consented to. Examples of apps permissions include the ability to access your calendar, contacts, or camera. - -You can revoke any of the permissions you consented to by selecting `Revoke Permissions`, however removing a permission may break some of the apps functionality. If you have problems after you remove permissions or accounts, contact your organization's Helpdesk for additional assistance. - -If you require more help, head over the Microsoft Documentation Page about [Managing Applications](https://docs.microsoft.com/en-us/azure/active-directory/user-help/my-applications-portal-permissions-saved-accounts) diff --git a/apps/docs/pages/integrations/slack.mdx b/apps/docs/pages/integrations/slack.mdx deleted file mode 100644 index 441a094674..0000000000 --- a/apps/docs/pages/integrations/slack.mdx +++ /dev/null @@ -1,21 +0,0 @@ ---- -Title: Slack ---- - -# Slack - -## Connecting -Connecting the bot is easy - If you are a workspace admin, the install button will add the bot to the workspace and also authorize your account with the bot. If you are a normal user, the install button will connect your Slack account with Cal.com. This will allow you to perform commands in Slack. - -## Commands -`/today` - This command will display all meetings you have in your Cal.com profile for the current day. This will send a hidden message (not visible to anyone other than you) to the channel you issued the command in. - -`/create-event` - It will display a modal allowing you to simply create a meeting invite with anyone in Slack. Success/Error information will be displayed in a private direct message from the bot. - -`/links` - This command will post all your Cal.com meeting links into the current Slack channel you are in. **Note**: The bot needs to have permission to talk in the channel you are sending the message in. Otherwise, you won't be able to send your links. - -As this is the beggining stage of our Slack integration, we plan on adding more commands in the future that will further improve your Cal.com experience. - -## Self-Hosted -If you are using our self-hosted version, please refer to our documentation in -[cal.com/README.md](https://github.com/calcom/cal.com/blob/main/README.md#obtaining-slack-client-id-and-secret-and-signing-secret) diff --git a/apps/docs/pages/integrations/stripe.mdx b/apps/docs/pages/integrations/stripe.mdx deleted file mode 100644 index bb563abd86..0000000000 --- a/apps/docs/pages/integrations/stripe.mdx +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Stripe ---- - -# Stripe Payments - -The Stripe integration allows users to add payments to their bookings. - -## Adding the stripe integration - -1. Go to the [Cal App Store](https://app.cal.com/integrations). -2. Located near the top of this page will be the integration 'Stripe' and located to the right will be a button called 'Connect', press this. -3. You will be redirected to Stripe requesting for Cal.com to be authorized access. Press 'Accept'. - -This stripe integration has now successfully been added. - -## Removing the stripe integration - -1. Go to the [Cal App Store](https://app.cal.com/integrations). -2. Located near the top of this page will be the integration 'Stripe' and located to the right will be a button called 'Disconnect', press this. -3. A confirmation pop up box will appear, to confirm press the button saying 'Yes, disconnect integration'. - -This stripe integration has now successfully been disconnected. diff --git a/apps/docs/pages/integrations/zapier.mdx b/apps/docs/pages/integrations/zapier.mdx deleted file mode 100644 index f1cb8c9c0b..0000000000 --- a/apps/docs/pages/integrations/zapier.mdx +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Zapier ---- - -## Do you have a Zapier integration? - -We are currently working on it, but it isn’t live just yet. Until then, you can use our Webhooks integration and use Zapier's “Webhooks by Zapier”. diff --git a/apps/docs/pages/integrations/zoom.mdx b/apps/docs/pages/integrations/zoom.mdx deleted file mode 100644 index 94fd02e6b1..0000000000 --- a/apps/docs/pages/integrations/zoom.mdx +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Zoom -sidebar_position: 3 ---- - -# Zoom - -The Zoom integration automatically creates Zoom meetings for your bookings. - -## Connecting your Zoom account - -1. Go to the App Store page, and click the 'Add new integration' button. -2. Next to Zoom, go ahead and click the 'Add' button. -3. You will now be taken to Zoom to sign into your account and authorize Cal. - -## Disconnecting your Zoom account - -1. Go to the App Store page, and click on your Zoom integration in the list. -2. On the right hand side, click the Delete App button. - -This will remove the integration from Cal. Cal will not perform any actions on your account once the integration is removed. However, if you want to revoke Cal's permissions from your Zoom account, perform the following steps: - -1. Log into your Zoom account and navigate to the App Marketplace -2. Click Manage > Installed Apps or search for the Cal app -3. Click on the Cal app -4. Click Uninstall - -## How we interact with your Zoom account - -We only need the ability to create meetings, so when somebody books an event with you, Cal can communicate with Zoom and create the corresponding meeting. - -## Setting up Zoom on your self-hosted instance - -1. Open [Zoom Marketplace](https://marketplace.zoom.us/) and sign in with your Zoom account. -2. On the upper right, click "Develop" => "Build App". -3. On "OAuth", select "Create". -4. Name your App. -5. Choose "User-managed app" as the app type. -6. De-select the option to publish the app on the Zoom App Marketplace. -7. Click "Create". -8. Now copy the Client ID and Client Secret to your .env file into the `ZOOM_CLIENT_ID` and `ZOOM_CLIENT_SECRET` fields. -9. Set the Redirect URL for OAuth `/api/integrations/zoomvideo/callback` replacing CALENDSO URL with the URI at which your application runs. -10. Also add the redirect URL given above as an allowlist URL and enable "Subdomain check". Make sure it says "saved" below the form. -11. You don't need to provide basic information about your app. Instead click at "Scopes" and then at "+ Add Scopes". On the left, click the category "Meeting" and check the scope `meeting:write`. -12. Click "Done". -13. You're good to go. Now you can easily add your Zoom integration in the Cal settings. diff --git a/apps/docs/pages/meta.json b/apps/docs/pages/meta.json deleted file mode 100644 index 4d37384fa7..0000000000 --- a/apps/docs/pages/meta.json +++ /dev/null @@ -1,17 +0,0 @@ -{ - "index": "Home", - "self-hosting": "Self-hosting", - "availability": "Availability", - "bookings": "Bookings", - "event-types": "Event Types", - "teams": "Teams", - "integrations": "Integrations", - "public-api": "API", - "webhooks": "Webhooks", - "settings": "Settings", - "import": "Import", - "billing": "Billing", - "developer": "Developer", - "contributing": "Contributing", - "faq": "FAQs" -} diff --git a/apps/docs/pages/public-api.mdx b/apps/docs/pages/public-api.mdx deleted file mode 100644 index a5a2fa62a4..0000000000 --- a/apps/docs/pages/public-api.mdx +++ /dev/null @@ -1,20 +0,0 @@ -import Bleed from 'nextra-theme-docs/bleed' -import Head from "next/head"; -import IframeResizer from "iframe-resizer-react"; -import {useWindowSize} from "../lib/useWindowSize"; - - - - Public API | Cal.com - 768 ? "calc(100vw - 16rem)": "100vw", - minHeight: useWindowSize().width > 768 ? "100vh" : "200vh", - height: "auto", - border: 0, - }} - /> - diff --git a/apps/docs/pages/self-hosting/docker.mdx b/apps/docs/pages/self-hosting/docker.mdx deleted file mode 100644 index 068ed8be87..0000000000 --- a/apps/docs/pages/self-hosting/docker.mdx +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Docker ---- - -# Docker - -The Docker configuration for Cal is an effort powered by people within the community. Cal does not provide official support for Docker, but we will accept fixes and documentation. Use at your own risk. - -The Docker configuration can be found [in our docker repository](https://github.com/calcom/docker). - -## Requirements - -Make sure you have `docker` & `docker-compose` installed on the server / system. - -## Getting Started - -### Option #1: Docker Hub - - ```bash - docker pull calendso/calendso - ``` - -or - -### Option #2: Cloning - -1. Clone calendso-docker - - ```bash - git clone --recursive https://github.com/calendso/docker.git calendso-docker - ``` - -2. Update `.env` if needed - -3. Build and start calendso - - ```bash - docker-compose up --build - ``` - -4. Start prisma studio - ```bash - docker-compose exec calendso npx prisma studio - ``` -5. Open a browser to [port 5555](http://localhost:5555) on your localhost to look at or modify the database content. - -6. Click on the `User` model to add a new user record. -7. Fill out the fields (remembering to encrypt your password with [BCrypt](https://bcrypt-generator.com/)) and click `Save 1 Record` to create your first user. -8. Open a browser to [port 3000](http://localhost:3000) on your localhost and login with your just created, first user. diff --git a/apps/docs/pages/self-hosting/install.mdx b/apps/docs/pages/self-hosting/install.mdx deleted file mode 100644 index 93e5cac0bf..0000000000 --- a/apps/docs/pages/self-hosting/install.mdx +++ /dev/null @@ -1,128 +0,0 @@ ---- -title: Installation ---- - -# Installation - -To get a local copy up and running, please follow these simple steps. - -## Prerequisites - -Here is what you need to be able to run Cal. - -- Node.js -- PostgreSQL -- Yarn _(recommended)_ - -> If you want to enable any of the available integrations, you may want to obtain additional credentials for each one. More details on this can be found below under the integrations category. - -## Setup - -1. Clone the repo - - ```sh - git clone https://github.com/calcom/cal.com.git - ``` - -1. Go to the project folder - - ```sh - cd cal.com - ``` - -1. Copy `.env.example` to `.env` - - ```sh - cp apps/web/.env.example apps/web/.env - ``` - -1. Install packages with yarn - - ```sh - yarn - ``` - -### Quick start with `yarn dx` - -> - **Requires Docker and Docker Compose to be installed** -> - Will start a local Postgres instance with a few test users - the credentials will be logged in the console - -```sh -yarn dx -``` - -### Manual setup - -1. Configure database in the `.env` file. Replace ``, ``, ``, `` with their applicable values - - ```text - DATABASE_URL='postgresql://:@:' - ``` - -
- - - If you don't know how to configure the DATABASE_URL, then follow the steps here to create a quick DB - using Heroku - - - 1. Create a free account with [Heroku](https://www.heroku.com/). - - 2. Create a new app. - - Create an App - - 3. In your new app, go to `Overview` and next to `Installed add-ons`, click `Configure Add-ons`. We need this to set up our database. - ![image](https://user-images.githubusercontent.com/16905768/115323232-a53ba480-a17f-11eb-98db-58e2f8c52426.png) - - 4. Once you clicked on `Configure Add-ons`, click on `Find more add-ons` and search for `postgres`. One of the options will be `Heroku Postgres` - click on that option. - ![image](https://user-images.githubusercontent.com/16905768/115323126-5beb5500-a17f-11eb-8030-7380310807a9.png) - - 5. Once the pop-up appears, click `Submit Order Form` - plan name should be `Hobby Dev - Free`. - - Submit Order Form - - 6. Once you completed the above steps, click on your newly created `Heroku Postgres` and go to its `Settings`. - ![image](https://user-images.githubusercontent.com/16905768/115323367-e92ea980-a17f-11eb-9ff4-dec95f2ec349.png) - - 7. In `Settings`, copy your URI to your Cal.com .env file and replace the `postgresql://:@:` with it. - ![image](https://user-images.githubusercontent.com/16905768/115323556-4591c900-a180-11eb-9808-2f55d2aa3995.png) - ![image](https://user-images.githubusercontent.com/16905768/115323697-7a9e1b80-a180-11eb-9f08-a742b1037f90.png) - - 8. To view your DB, once you add new data in Prisma, you can use [Heroku Data Explorer](https://heroku-data-explorer.herokuapp.com/). - -
- -1. Set a 32 character random string in your `apps/web/.env` file for the `CALENDSO_ENCRYPTION_KEY` (You can use a command like `openssl rand -base64 24` to generate one). -1. Set up the database using the Prisma schema (found in `packages/prisma/schema.prisma`) - - ```sh - yarn workspace @calcom/prisma db-deploy - ``` - -1. Run (in development mode) - - ```sh - yarn dev - ``` - -### Setting up your first user - -1. Open [Prisma Studio](https://www.prisma.io/studio) to look at or modify the database content: - - ```sh - yarn db-studio - ``` - -1. Click on the `User` model to add a new user record. -1. Fill out the fields `email`, `username`, `password`, and set `metadata` to empty `{}` (remembering to encrypt your password with [BCrypt](https://bcrypt-generator.com/)) and click `Save 1 Record` to create your first user. - > New users are set on a `TRIAL` plan by default. You might want to adjust this behavior to your needs in the `prisma/schema.prisma` file. -1. Open a browser to [port 3000](http://localhost:3000) and login with your just created, first user. diff --git a/apps/docs/pages/self-hosting/meta.json b/apps/docs/pages/self-hosting/meta.json deleted file mode 100644 index 9bd1650cfb..0000000000 --- a/apps/docs/pages/self-hosting/meta.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "install": "Installation", - "upgrade": "Upgrade", - "docker": "Docker", - "vercel": "Vercel" -} diff --git a/apps/docs/pages/self-hosting/upgrade.mdx b/apps/docs/pages/self-hosting/upgrade.mdx deleted file mode 100644 index f22431fa01..0000000000 --- a/apps/docs/pages/self-hosting/upgrade.mdx +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Upgrade ---- - -# Upgrading - -**Warning**: When performing database migrations, you may lose data if the migration is not done properly. - -1. Pull the current version: - ```sh - git pull - ``` -2. Apply database migrations by running one of the following commands: - - In a development environment, run: - - ```sh - yarn workspace @calcom/prisma db-migrate - ``` - - (this can clear your development database in some cases) - - In a production environment, run: - - ```sh - yarn workspace @calcom/prisma db-deploy - ``` - -3. Check the `.env.example` and compare it to your current `.env` file. In case there are any fields not present - in your current `.env`, add them there. - - For the current version, especially check if the variable `BASE_URL` is present and properly set in your environment, for example: - - ```text - BASE_URL='https://yourdomain.com' - ``` - -4. Start the server. In a development environment, just do: - ```sh - yarn dev - ``` - For a production build, run for example: - ```sh - yarn build - yarn start - ``` -5. Enjoy the new version. diff --git a/apps/docs/pages/self-hosting/vercel.mdx b/apps/docs/pages/self-hosting/vercel.mdx deleted file mode 100644 index 2dc4b97bb4..0000000000 --- a/apps/docs/pages/self-hosting/vercel.mdx +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Vercel ---- - -# Vercel - -## Requirements - -You need a PostgresDB database hosted somewhere. [Supabase](https://supabase.com/) offers a great free option. - -## Getting Started - -### Local settings - -1. Fork and clone the repository - - ```bash - git clone https://github.com//cal.com.git - ``` - -2. Copy the `.env.example` file in `apps/web`, rename it to `.env` and fill it with your settings ([See manual setup](https://github.com/calcom/cal.com#manual-setup) and [Obtaining the Google API Credentials](https://github.com/calcom/cal.com#obtaining-the-google-api-credentials)) - -3. Install packages with `yarn` - - ```bash - yarn install - ``` - -4. Set up the database using the Prisma schema (found in `packages/prisma/schema.prisma`) - - ```sh - yarn workspace @calcom/prisma db-deploy - ``` - -5. Open [Prisma Studio](https://www.prisma.io/studio) to look at or modify the database content: - ``` - yarn db-studio - ``` -6. Click on the `User` model to add a new user record. -7. Fill out the fields (remembering to encrypt your password with [BCrypt](https://bcrypt-generator.com/)) and click `Save 1 Record` to create your first user. -8. Open a browser to [port 3000](http://localhost:3000) on your localhost and login with your just created, first user. - -### Deployment - -1. Create a new project on Vercel -1. Import from your forked repository -1. Set the Environment Variables -1. Set the root directory to `apps/web` -1. Override the build command to `cd ../.. && yarn build` -1. Hit Deploy diff --git a/apps/docs/pages/settings.mdx b/apps/docs/pages/settings.mdx deleted file mode 100644 index 83f3ca3180..0000000000 --- a/apps/docs/pages/settings.mdx +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Settings ---- - -# Settings -## Setting up or making changes to your Profile - -1. Go to your [Profile Settings](https://app.cal.com/settings/profile). -2. From this page you are able to edit the following: -- Your URL Username -- Your Display Name -- Your About Information -- Change your Profile Picture -- Your Local Time Zone -- Your Chosen 'First Day Of The Week' -- Light or Dark Mode for your Booking Page -- Enabling or Disabling cal.com Branding on your Booking Page -3. Once you have completed all your changes, press that 'save' button located at the bottom right of your page. - -## Reset your password - -1. Go to [your account security settings](https://app.cal.com/settings/security). -2. Located at the top of your screen, you will see two boxes. -3. Enter your Old Password and New Password. -4. Click the button 'Save' located to the bottom right of your new password. -5. You have now successfully changed your password! - -## Change your email - -Go to [Profile Settings](https://app.cal.com/settings/profile). There, you will see the email associated with your account which you can then update. You’d just need to log out and back in to see the change take effect. - -## Enable 2FA - -1. Go to [Your Account Security Settings](https://app.cal.com/settings/security). -2. Located at the bottom of your screen, click on the tab labeled 'Enable Two-Factor Authentication'. -3. Enter your Password. -4. In your authenticator app, scan the QR Code presented on your screen. -5. Once Scanned, press 'Next' and then enter the code presented within your Authentication App -6. Press 'Enabled' - -You have now successfully enabled Two-Factor Authentication - -## Disable 2FA -1. Go to [Your Account Security Settings](https://app.cal.com/settings/security). -2. Located at the bottom of your screen, click on the tab labeled 'Disable Two-Factor Authentication'. -3. Enter your Password. - -You have now successfully disabled Two-Factor Authentication - -## How to delete my account - -You can delete your account from within the [Settings](https://app.cal.com/settings/profile) option. Just scroll all the way down and click on `Delete Account`. - -## How to change the language - -Go to your [Profile Settings](https://app.cal.com/settings/profile). Under `Language` you will see the dropdown menu and you can use it to select your desired language. diff --git a/apps/docs/pages/style.css b/apps/docs/pages/style.css deleted file mode 100644 index 55e436f61a..0000000000 --- a/apps/docs/pages/style.css +++ /dev/null @@ -1,15 +0,0 @@ -@font-face { - font-family: 'Cal Sans'; - src: url("https://cal.com/cal.ttf"); -} - -h1, -h2, -h3, -h4, -h5, -h6 { - font-family: 'Cal Sans'; - font-weight: normal; - letter-spacing: normal; -} diff --git a/apps/docs/pages/teams.mdx b/apps/docs/pages/teams.mdx deleted file mode 100644 index 3428294faa..0000000000 --- a/apps/docs/pages/teams.mdx +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Teams ---- - -# Teams - -## How do I create a new team? - -1. Go to [Your Teams Settings](https://app.cal.com/settings/teams). -2. Press the button displayed on your screen called '+ New Team' -3. Enter the name you wish to call your team. -4. After entering the name press the 'Create Team' button located just under your new team name. -5. You have now created your new team. - -Creating a team will allow you to create new event types for the team, invite team members and much more! - -## How do I change my teams URL? - -1. Go to [Your Teams Settings](https://app.cal.com/settings/teams) and select the team you wish to edit. -2. Located at the top of your teams settings will be a team-url bar, from here you can input your requested teams url. -3. Once complete make sure you press 'save' at the bottom of the page. - -## How do I change my teams name? - -1. Go to [Your Teams Settings](https://app.cal.com/settings/teams) and select the team you wish to edit. -2. Located in the 2nd row of your teams settings will be a Team Name bar, from here you can input your requested team name. -3. Once complete make sure you press 'save' at the bottom of the page. - -## How do I add and remove a description of my team? - -1. Go to [Your Teams Settings](https://app.cal.com/settings/teams) and select the team you wish to edit. -2. Located below your team name entry box is a large text box labeled 'About', - -## How do I upload my team logo? - -1. Go to [Your Teams Settings](https://app.cal.com/settings/teams) and select the team you wish to edit. -2. Located under your teams subscription will be a box that says 'Upload a logo', press this box. -3. Press 'choose a file' and locate a file from your machine you wish to use as your team logo. -4. Once complete make sure you press 'save' at the bottom of the page. - -## How do I manage team members? - -1. Go to [Your Teams Settings](https://app.cal.com/settings/teams) and select the team you wish to edit. -2. Located at the bottom of your page is your team members, from here you can choose to add or remove team members and even change their role which could be Member, Admin or Owner. - -## How do I delete my team I created? - -1. Go to [Your Teams Settings](https://app.cal.com/settings/teams). -2. From here you will be able to see a list of teams you have created or apart of, located to the right of the team you wish to delete you can find three dots (...) -3. Press the 3 dots (...) then 'Disband Team' -4. This will brin gup a prompt confirming if you wish to disband your team, if your are sure you can press the button labeled 'Yes, disband team' - -Your team has now successfully been deleted. - -## Where can I find my team's Event Types? - -Once you open `Event Types` on your dashboard, you will find your team's Event Types below your individual ones. diff --git a/apps/docs/pages/webhooks.mdx b/apps/docs/pages/webhooks.mdx deleted file mode 100644 index 24659a2e6c..0000000000 --- a/apps/docs/pages/webhooks.mdx +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Webhooks ---- - -# Webhooks - -## Create a new Webhook - -1. Go to [Your Integrations](https://app.cal.com/integrations). -2. Scrolling down to the bottom of the page you will see a button called ‘New Webhook’. Press this button to open up the box which will ask for details on creating the new webhooks. -3. Select whatever event this triggers, this may be Create, Cancelled or Reschedule. -4. Once this is completed, insert the Subscriber URL then click 'Save' located at the bottom right of the box. - -## Edit an existing Webhook - -1. Go to [Your Integrations](https://app.cal.com/integrations). -2. Scrolling down to the bottom of the page you will see an icon to the right of your webhook, this will be labeled edit webhook. -3. Press the button and from here you can change any of the webhook settings. This could be changing the event that is triggered and this may be Create, Cancelled or Reschedule. Or you can change the Subscriber URL. - -## Delete an existing Webhook - -1. Go to [Your Integrations](https://app.cal.com/integrations). -2. Scrolling down to the bottom of the page you will see an icon to the right of your webhook, this will be labeled delete webhook. -3. Press the button and from here your webhook will no longer work and be deleted. - -## Webhook metadata - -Metadata is a way to pass extra information to Cal.com about a booking that is returned through a webhook. - -### Example - -The best way to explain this is with an example. Let's say you're a bank, and people register an account on your website, but you want them to book an onboarding call with your team to get set up. You could send them to your Cal.com booking link as part of your onboarding process, but when the webhook is returned, it may be difficult to match up which user booked a meeting with the user's account in your own database. Hence, you can pass a `user_id` value for instance as a URL parameter, which makes no difference to the booking process, but when the webhook is returned, you will receive the metadata as part of the webhook payload. - -Metadata is passed as a URL parameter on top of your booking link and follows the following syntax: - -```text -metadata[key_name]=value -``` - -For example, if your booking link is `cal.com/rick/quick-chat`, you can pass a user ID of 123 like so: - -```text -cal.com/rick/quick-chat?metadata[user_id]=123 -``` - -As a result, the webhook will be returned in this format: - -```text -\{ , metadata: \{ user_id: 123 \} \} -``` - -## Custom Webhooks template variable list - -Customizable webhooks are a great way reduce the development effort and in many cases remove the need for a developer to build an additional integration service. Using a custom template you can easily decide what data you receive in your webhook endpoint, manage the payload and setup related workflows accordingly. Here’s a breakdown of the payload that you would receive via an incoming webhook. - -### Webhook structure - -| Variable | Type | Description | -| ------------------- | -------- | -------------------------------------------------------------------------------------- | -| triggerEvent | String | The name of the trigger event [BOOKING_CREATED, BOOKING_RESHEDULED, BOOKING_CANCELLED] | -| createdAt | String | The time of the webhook trigger | -| type | String | The event-type slug | -| title | String | The event-type name | -| startTime | String | The event's start time | -| endTime | String | The event's end time | -| description? | String | The event's description as described in the event type | -| location? | String | Location of the event | -| organizer | Person | The organizer of the event | -| attendees | Person[] | The event booker & any guests | -| uid? | String | The UID of the booking | -| resheduleUid? | String | The UID for the rescheduling | -| cancellationReason? | String | Reason for cancellation | -| rejectionReason? | String | Reason for rejection | -| team?.name | String | Name of the team booked | -| team?.members | String[] | Members of the team booked | - -### Person structure - -| Variable | Type | Description | -| --------------- | ------ | --------------------------------------------------------------------- | -| name | String | Name of the individual | -| email | String | Email of the individual | -| timeZone | String | Timezone of the individual ("America/New_York", "Asia/Kolkata", etc.) | -| language.locale | String | Locale of the individual ("en", "fr", etc.) | - -### Example usage of variables for custom template: - -```sh -\{ - - "content": "A new event has been scheduled", - "type": "\{\{type\}\}", - "name": "\{\{title\}\}", - "organizer": "\{\{organizer.name\}\}", - "booker": "\{\{attendees.0.name\}\}" - -\} -``` diff --git a/apps/docs/public/android-chrome-192x192.png b/apps/docs/public/android-chrome-192x192.png deleted file mode 100644 index 395bfe3c60..0000000000 Binary files a/apps/docs/public/android-chrome-192x192.png and /dev/null differ diff --git a/apps/docs/public/android-chrome-256x256.png b/apps/docs/public/android-chrome-256x256.png deleted file mode 100644 index 83b5eb0ded..0000000000 Binary files a/apps/docs/public/android-chrome-256x256.png and /dev/null differ diff --git a/apps/docs/public/android-chrome-384x384.png b/apps/docs/public/android-chrome-384x384.png deleted file mode 100644 index 12d4935429..0000000000 Binary files a/apps/docs/public/android-chrome-384x384.png and /dev/null differ diff --git a/apps/docs/public/android-chrome-512x512.png b/apps/docs/public/android-chrome-512x512.png deleted file mode 100644 index f8f9a4852c..0000000000 Binary files a/apps/docs/public/android-chrome-512x512.png and /dev/null differ diff --git a/apps/docs/public/apple-touch-icon.png b/apps/docs/public/apple-touch-icon.png deleted file mode 100644 index ffa076315f..0000000000 Binary files a/apps/docs/public/apple-touch-icon.png and /dev/null differ diff --git a/apps/docs/public/browserconfig.xml b/apps/docs/public/browserconfig.xml deleted file mode 100644 index 3c58a03a73..0000000000 --- a/apps/docs/public/browserconfig.xml +++ /dev/null @@ -1,9 +0,0 @@ - - - - - - #292929 - - - diff --git a/apps/docs/public/cal.ttf b/apps/docs/public/cal.ttf deleted file mode 100644 index 4a2950a045..0000000000 Binary files a/apps/docs/public/cal.ttf and /dev/null differ diff --git a/apps/docs/public/demo.png b/apps/docs/public/demo.png deleted file mode 100644 index 3751514339..0000000000 Binary files a/apps/docs/public/demo.png and /dev/null differ diff --git a/apps/docs/public/favicon-16x16.png b/apps/docs/public/favicon-16x16.png deleted file mode 100644 index 92717c306b..0000000000 Binary files a/apps/docs/public/favicon-16x16.png and /dev/null differ diff --git a/apps/docs/public/favicon-32x32.png b/apps/docs/public/favicon-32x32.png deleted file mode 100644 index 5846956222..0000000000 Binary files a/apps/docs/public/favicon-32x32.png and /dev/null differ diff --git a/apps/docs/public/favicon.ico b/apps/docs/public/favicon.ico deleted file mode 100644 index 0760f8a241..0000000000 Binary files a/apps/docs/public/favicon.ico and /dev/null differ diff --git a/apps/docs/public/mstile-144x144.png b/apps/docs/public/mstile-144x144.png deleted file mode 100644 index 62f0fc9790..0000000000 Binary files a/apps/docs/public/mstile-144x144.png and /dev/null differ diff --git a/apps/docs/public/mstile-150x150.png b/apps/docs/public/mstile-150x150.png deleted file mode 100644 index f31d64926b..0000000000 Binary files a/apps/docs/public/mstile-150x150.png and /dev/null differ diff --git a/apps/docs/public/mstile-310x150.png b/apps/docs/public/mstile-310x150.png deleted file mode 100644 index 30025ecd6a..0000000000 Binary files a/apps/docs/public/mstile-310x150.png and /dev/null differ diff --git a/apps/docs/public/mstile-310x310.png b/apps/docs/public/mstile-310x310.png deleted file mode 100644 index 877f8974f1..0000000000 Binary files a/apps/docs/public/mstile-310x310.png and /dev/null differ diff --git a/apps/docs/public/mstile-70x70.png b/apps/docs/public/mstile-70x70.png deleted file mode 100644 index 56bace16e0..0000000000 Binary files a/apps/docs/public/mstile-70x70.png and /dev/null differ diff --git a/apps/docs/public/safari-pinned-tab.svg b/apps/docs/public/safari-pinned-tab.svg deleted file mode 100644 index 596052799d..0000000000 --- a/apps/docs/public/safari-pinned-tab.svg +++ /dev/null @@ -1,31 +0,0 @@ - - - - -Created by potrace 1.14, written by Peter Selinger 2001-2017 - - - - - - - diff --git a/apps/docs/public/site.webmanifest b/apps/docs/public/site.webmanifest deleted file mode 100644 index 31a1e10fdb..0000000000 --- a/apps/docs/public/site.webmanifest +++ /dev/null @@ -1,19 +0,0 @@ -{ - "name": "Cal.com", - "short_name": "Cal.com", - "icons": [ - { - "src": "/android-chrome-192x192.png", - "sizes": "192x192", - "type": "image/png" - }, - { - "src": "/android-chrome-512x512.png", - "sizes": "512x512", - "type": "image/png" - } - ], - "theme_color": "#292929", - "background_color": "#292929", - "display": "standalone" -} diff --git a/apps/docs/theme.config.js b/apps/docs/theme.config.js deleted file mode 100644 index 25857c7491..0000000000 --- a/apps/docs/theme.config.js +++ /dev/null @@ -1,47 +0,0 @@ -import { SEO_IMG_DEFAULT, DOCS_URL } from "@calcom/lib/constants"; - -const themeConfig = { - github: "https://github.com/calcom/cal.com", - docsRepositoryBase: "https://github.com/calcom/cal.com/blob/main/apps/docs/pages", - titleSuffix: " | Cal.com", - logo:

Cal.com

, - head: ( - <> - - - - - - - - - - - - - - - - - - - - - - - ), - search: true, - prevLinks: true, - nextLinks: true, - footer: true, - footerEditLink: "Edit this page on GitHub", - footerText: <>© {new Date().getFullYear()} Cal.com, Inc. All rights reserved., -}; - -export default themeConfig; diff --git a/apps/docs/tsconfig.json b/apps/docs/tsconfig.json deleted file mode 100644 index d1581064cf..0000000000 --- a/apps/docs/tsconfig.json +++ /dev/null @@ -1,8 +0,0 @@ -{ - "extends": "@calcom/tsconfig/nextjs.json", - "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"], - "exclude": ["node_modules"], - "compilerOptions": { - "noImplicitAny": false - } -} diff --git a/package.json b/package.json index 8864cab3f3..175833acbc 100644 --- a/package.json +++ b/package.json @@ -35,9 +35,6 @@ "dev:swagger": "turbo run dev --scope=\"@calcom/api\" --scope=\"@calcom/swagger\"", "dev:website": "turbo run dev --scope=\"@calcom/web\" --scope=\"@calcom/website\"", "dev": "turbo run dev --scope=\"@calcom/web\"", - "docs-build": "turbo run build --scope=\"@calcom/docs\" --include-dependencies", - "docs-dev": "turbo run dev --scope=\"@calcom/docs\"", - "docs-start": "turbo run start --scope=\"@calcom/docs\"", "build-storybook": "turbo run build --scope=\"@calcom/storybook\"", "dx": "turbo run dx", "i-dev": "infisical run -- turbo run dev --scope=\"@calcom/web\"",