Skip to content

Conversation

@vachmara
Copy link
Contributor

@vachmara vachmara commented Nov 6, 2025

Pull Request

Description

This pull request adds documentation and sidebar navigation support for the new Cal.com integration with Databuddy. The main changes include updating the sidebar to feature Cal.com, adding a dedicated integration guide, and registering Cal.com in the integrations metadata.

see Calcom PR

Checklist

  • My code follows the style guidelines of this project
  • I have performed a self-review of my code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes

Summary by CodeRabbit

  • New Features

    • Added Cal.com integration support with setup instructions.
  • Documentation

    • Added comprehensive guide for integrating with Cal.com, including setup steps, self-hosted configuration options, and use-case examples.

✏️ Tip: You can customize this high-level summary in your review settings.

@vercel
Copy link

vercel bot commented Nov 6, 2025

@vachmara is attempting to deploy a commit to the Databuddy OSS Team on Vercel.

A member of the Team first needs to authorize it.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Nov 6, 2025

Walkthrough

Added Cal.com integration documentation and sidebar navigation support. The changes include a new sidebar navigation item linking to the Cal.com integration guide, the integration documentation page itself, and a corresponding metadata entry.

Changes

Cohort / File(s) Summary
Sidebar Navigation
apps/docs/components/sidebar-content.tsx
Added CalendarIcon import and introduced new "Cal.com" public integration item in navigation menu with href pointing to /docs/Integrations/cal.
Integration Documentation
apps/docs/content/docs/Integrations/cal.mdx
Created new documentation page covering Cal.com integration setup, self-hosted configuration, use cases, and action links.
Integration Metadata
apps/docs/content/docs/Integrations/meta.json
Added "cal" entry to pages array between "framer" and "gtm".

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Straightforward additions without logic changes or control-flow modifications
  • Verify documentation accuracy and completeness for Cal.com integration steps
  • Confirm sidebar navigation item renders correctly with CalendarIcon

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: add cal integration' directly and accurately describes the main changes: adding Cal.com integration documentation to the docs.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Tip

✨ Issue Enrichment is now available for GitHub issues!

CodeRabbit can now help you manage issues more effectively:

  • Duplicate Detection — Identify similar or duplicate issues
  • Related Issues & PRs — Find relevant issues and PR's from your repository
  • Suggested Assignees — Find the best person to work on the issue
  • Implementation Planning — Generate detailed coding plans for engineers and agents
Disable automatic issue enrichment

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@izadoesdev
Copy link
Member

set as draft until complete, it's missing the original PR to get merged, and the setting to enable cross origin tracking

@vachmara vachmara marked this pull request as draft November 7, 2025 17:14
@vachmara
Copy link
Contributor Author

vachmara commented Nov 7, 2025

done! ping me when the cross origin tracking option is good so I will speed up things on cal side

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 933e9ab and b4dd887.

📒 Files selected for processing (3)
  • apps/docs/components/sidebar-content.tsx (2 hunks)
  • apps/docs/content/docs/Integrations/cal.mdx (1 hunks)
  • apps/docs/content/docs/Integrations/meta.json (1 hunks)
🔇 Additional comments (8)
apps/docs/content/docs/Integrations/meta.json (1)

12-12: LGTM!

The Cal.com entry is properly placed in the pages array and aligns with the new integration documentation.

apps/docs/components/sidebar-content.tsx (2)

140-144: LGTM!

The sidebar item structure is consistent with other integrations, and the href correctly points to the new Cal.com documentation page.


11-11: This review comment references CalendarIcon on line 11 of sidebar-content.tsx, but the current codebase shows GoogleLogoIcon on line 11. CalendarIcon does not appear in this file's imports. The review comment is based on a code state that does not match the current repository.

Likely an incorrect or invalid review comment.

apps/docs/content/docs/Integrations/cal.mdx (5)

1-4: LGTM!

The frontmatter is properly formatted with a clear title and descriptive metadata.


6-10: LGTM!

The introduction clearly explains the integration's value, and the TL;DR provides a helpful quick summary.


25-31: LGTM!

The self-hosted instructions are clear and provide the necessary configuration details.


44-45: LGTM!

The conclusion provides a clear call-to-action with an appropriate link to the Cal.com app.


12-22: The file apps/docs/content/docs/Integrations/cal.mdx does not exist in the repository. The Integrations directory contains: framer.mdx, gtm.mdx, index.mdx, nextjs.mdx, react.mdx, shopify.mdx, stripe.mdx, and wordpress.mdx, but no cal.mdx file. This review comment references a file that is not present.

Likely an incorrect or invalid review comment.

Comment on lines +34 to +42
## Use case

You can use the **same Client ID** across your **main website** and **Cal.com booking pages** to track full user journeys.

Example:

- A visitor lands on `yourwebsite.com/pricing` → clicks “Book a demo” → schedules via your Cal.com page.
- In Databuddy, you can setup with page view your [**funnel**](/docs/dashboard#funnel-analysis), allowing you to measure drop-off, setup goals and optimize conversions.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Search for dashboard documentation files and verify funnel-analysis anchor
find apps/docs/content/docs -name "*dashboard*" -type f

Repository: databuddy-analytics/Databuddy

Length of output: 109


🏁 Script executed:

#!/bin/bash
# Search for funnel-analysis or funnel content in dashboard documentation
rg -i "funnel" apps/docs/content/docs/ --type mdx --type md -n

Repository: databuddy-analytics/Databuddy

Length of output: 100


🏁 Script executed:

#!/bin/bash
# Search for funnel content in dashboard.mdx without type filter
rg -i "funnel" apps/docs/content/docs/dashboard.mdx -n

Repository: databuddy-analytics/Databuddy

Length of output: 1260


🏁 Script executed:

#!/bin/bash
# Also search for any heading or anchor that might be funnel-analysis
rg "##|funnel" apps/docs/content/docs/dashboard.mdx -i -n

Repository: databuddy-analytics/Databuddy

Length of output: 2413


Fix grammar errors on line 41.

The sentence contains multiple grammatical issues that make it unclear:

-In Databuddy, you can setup with page view your [**funnel**](/docs/dashboard#funnel-analysis), allowing you to measure drop-off, setup goals and optimize conversions.
+In Databuddy, you can set up a [**funnel**](/docs/dashboard#funnel-analysis) using page views, allowing you to measure drop-off, set up goals, and optimize conversions.

Changes:

  • "setup" → "set up" (verb form)
  • "with page view your" → "using page views" (clearer phrasing)
  • "setup goals" → "set up goals" (verb form)
  • Added missing Oxford comma

The dashboard link anchor is valid.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
## Use case
You can use the **same Client ID** across your **main website** and **Cal.com booking pages** to track full user journeys.
Example:
- A visitor lands on `yourwebsite.com/pricing` → clicks Book a demo → schedules via your Cal.com page.
- In Databuddy, you can setup with page view your [**funnel**](/docs/dashboard#funnel-analysis), allowing you to measure drop-off, setup goals and optimize conversions.
## Use case
You can use the **same Client ID** across your **main website** and **Cal.com booking pages** to track full user journeys.
Example:
- A visitor lands on `yourwebsite.com/pricing` → clicks "Book a demo" → schedules via your Cal.com page.
- In Databuddy, you can set up a [**funnel**](/docs/dashboard#funnel-analysis) using page views, allowing you to measure drop-off, set up goals, and optimize conversions.
🤖 Prompt for AI Agents
In apps/docs/content/docs/Integrations/cal.mdx around lines 34 to 42, fix the
grammar on line 41 by changing "setup" to the verb form "set up", replacing the
awkward phrase "with page view your" with "using page views", changing "setup
goals" to "set up goals", and add the Oxford comma; e.g. rewrite the sentence to
read: "In Databuddy, you can set up your funnel using page views, allowing you
to measure drop-off, set up goals, and optimize conversions."

@vachmara vachmara marked this pull request as ready for review December 3, 2025 10:34
@vachmara
Copy link
Contributor Author

vachmara commented Dec 3, 2025

It has been merge on the calcom side, is it ready on your side tho @izadoesdev ?

@izadoesdev izadoesdev merged commit cec22b1 into databuddy-analytics:staging Dec 3, 2025
4 of 6 checks passed
@vachmara
Copy link
Contributor Author

vachmara commented Dec 3, 2025

Great, now we need to wait until it's deployed on prod calcom side

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants