Skip to content

Conversation

@ravindra-dyte
Copy link
Contributor

@ravindra-dyte ravindra-dyte commented Aug 19, 2025

Summary

Added Getting Started Page for RealtimeKit Product. A separate PR will be raised to explain to clients about how to create custom UI.

Thinks to be Noted.

  1. PR uses Dyte Sample Links
  2. Links to APIs, such as https://developers.cloudflare.com/api/resources/realtime/realtimekit/, will result in 404. RealtimeKit APIs are not live yet.

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The documentation style guide has been adhered to.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

@ravindra-dyte ravindra-dyte marked this pull request as ready for review August 19, 2025 08:55
@ravindra-dyte ravindra-dyte requested a review from a team as a code owner August 19, 2025 08:55
Copy link
Contributor

@roerohan roerohan left a comment

Choose a reason for hiding this comment

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

Changes in internal URLs


Before we get started with RealtimeKit, let's understand the SDK model.

In RealtimeKit, the concepts of [**meeting**](/realtime/realtimekit/concepts#meeting) and [**participant**](/realtime/realtimekit/concepts#participant) serve as blueprints—these are database entries that define the structure and roles for real-time interactions. A meeting blueprint outlines the configuration for a collaborative space (such as a classroom, telehealth appointment, or webinar), while a participant blueprint defines the roles and permissions available within that space.
Copy link
Contributor

Choose a reason for hiding this comment

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

The URLs should have trailing /s
This makes sure that when the URL is opened, the corresponding tab is highlighted on the left sidebar.

Suggested change
In RealtimeKit, the concepts of [**meeting**](/realtime/realtimekit/concepts#meeting) and [**participant**](/realtime/realtimekit/concepts#participant) serve as blueprints—these are database entries that define the structure and roles for real-time interactions. A meeting blueprint outlines the configuration for a collaborative space (such as a classroom, telehealth appointment, or webinar), while a participant blueprint defines the roles and permissions available within that space.
In RealtimeKit, the concepts of [**meeting**](/realtime/realtimekit/concepts/#meeting) and [**participant**](/realtime/realtimekit/concepts/#participant) serve as blueprints—these are database entries that define the structure and roles for real-time interactions. A meeting blueprint outlines the configuration for a collaborative space (such as a classroom, telehealth appointment, or webinar), while a participant blueprint defines the roles and permissions available within that space.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done

In RealtimeKit, the concepts of [**meeting**](/realtime/realtimekit/concepts#meeting) and [**participant**](/realtime/realtimekit/concepts#participant) serve as blueprints—these are database entries that define the structure and roles for real-time interactions. A meeting blueprint outlines the configuration for a collaborative space (such as a classroom, telehealth appointment, or webinar), while a participant blueprint defines the roles and permissions available within that space.

When it comes to real-time usage, these blueprints are instantiated as sessions and peers:
- A [**session**](/realtime/realtimekit/concepts#session) is a live instance of a meeting, representing an active, real-time interaction.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- A [**session**](/realtime/realtimekit/concepts#session) is a live instance of a meeting, representing an active, real-time interaction.
- A [**session**](/realtime/realtimekit/concepts/#session) is a live instance of a meeting, representing an active, real-time interaction.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done


When it comes to real-time usage, these blueprints are instantiated as sessions and peers:
- A [**session**](/realtime/realtimekit/concepts#session) is a live instance of a meeting, representing an active, real-time interaction.
- A [**peer**](/realtime/realtimekit/concepts#peer) is a live instance of a participant—an actual user (such as a teacher, student, doctor, or patient) joining the session.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- A [**peer**](/realtime/realtimekit/concepts#peer) is a live instance of a participant—an actual user (such as a teacher, student, doctor, or patient) joining the session.
- A [**peer**](/realtime/realtimekit/concepts/#peer) is a live instance of a participant—an actual user (such as a teacher, student, doctor, or patient) joining the session.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done

}'
```

For more about apps and their role, see the [RealtimeKit Concepts guide](/realtime/realtimekit/concepts#app).
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
For more about apps and their role, see the [RealtimeKit Concepts guide](/realtime/realtimekit/concepts#app).
For more about apps and their role, see the [RealtimeKit Concepts guide](/realtime/realtimekit/concepts/#app).

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done


Before adding participants, you need to decide what permissions they should have.
Presets define these permissions, and RealtimeKit provides some default presets to get you started.
Learn more about presets in the [Concepts guide](/realtime/realtimekit/concepts#preset).
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Learn more about presets in the [Concepts guide](/realtime/realtimekit/concepts#preset).
Learn more about presets in the [Concepts guide](/realtime/realtimekit/concepts/#preset).

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done

@ravindra-dyte ravindra-dyte marked this pull request as draft August 19, 2025 09:44
- A [**session**](/realtime/realtimekit/concepts/#session) is a live instance of a meeting, representing an active, real-time interaction.
- A [**peer**](/realtime/realtimekit/concepts/#peer) is a live instance of a participant—an actual user (such as a teacher, student, doctor, or patient) joining the session.

> **Note:** In some contexts, the terms **session** and **meeting**, as well as **peer** and **participant**, are used interchangeably. This is because most people are more familiar with the terms "meeting" and "participant." However, in RealtimeKit, using "session" and "peer" helps differentiate between live instances (sessions and peers) and their blueprints (meetings and participants), making it easier to track and manage them individually in the RealtimeKit dashboard.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
> **Note:** In some contexts, the terms **session** and **meeting**, as well as **peer** and **participant**, are used interchangeably. This is because most people are more familiar with the terms "meeting" and "participant." However, in RealtimeKit, using "session" and "peer" helps differentiate between live instances (sessions and peers) and their blueprints (meetings and participants), making it easier to track and manage them individually in the RealtimeKit dashboard.
> **Note:** In some contexts, the terms **session** and **meeting**, as well as **peer** and **participant**, are used interchangeably. This is because most people are more familiar with the terms "meeting" and "participant". However, in RealtimeKit, using "session" and "peer" helps differentiate between live instances (sessions and peers) and their blueprints (meetings and participants), making it easier to track and manage them individually in the RealtimeKit dashboard.

@ravindra-cloudflare
Copy link
Contributor

PR: #26407 has all these changes. Closing this PR.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants