explaingit

predatorray/rendezvous

12TypeScriptAudience · developerComplexity · 2/5Setup · easy

TLDR

A serverless video conferencing web app that runs entirely in the browser with no backend needed, join with a six-letter code, no account required, and host video calls for free.

Mindmap

mindmap
  root((rendezvous))
    What it does
      Browser video calls
      Host as relay
      Chat with history
      Six-letter join code
    Tech stack
      React
      TypeScript
      PeerJS
      WebRTC
    Use cases
      Free serverless calls
      GitHub Pages deploy
      Small team meetings
    Audience
      Developers
      Small teams
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Host a free serverless video call with no backend costs using the built-in host-relay architecture.

USE CASE 2

Deploy a private video conference app to GitHub Pages with a single command.

USE CASE 3

Build a no-account video chat tool where late joiners can scroll back through chat history.

Tech stack

ReactTypeScriptPeerJSWebRTCGitHub Pages

Getting it running

Difficulty · easy Time to first run · 30min

Requires Node.js for local dev, deploy to GitHub Pages with a single npm script.

In plain English

Rendezvous is a video conferencing web app that works without any application server. It runs entirely in the browser and can be hosted as a plain static website, meaning there is no backend to maintain or pay for. You can try it at the live demo link in the README. The way it works is that one participant, the host, acts as the relay point for the meeting. Video and audio from each other participant flows to the host, and the host sends everyone else's streams out to all other attendees. Chat messages follow the same path. This design avoids the need for a central server but does mean the host's own internet connection determines how many people can join before quality degrades, since the host's upload bandwidth is shared across all streams going out to other participants. Joining a meeting is simple: pick a name, then either start a new meeting or enter a short six-letter code to join an existing one. No accounts or passwords are required. The interface shows a grid of video tiles, and when someone's camera is off, their initials appear instead. Controls let you mute audio and turn video on or off. A collapsible chat panel on the right side keeps a history of messages, so people who join late can see what was said before they arrived. The app is built with React and TypeScript, uses a library called PeerJS for the underlying peer-to-peer connection setup, and can be deployed to GitHub Pages with a single command. The README provides instructions for running it locally for testing or deploying to your own GitHub Pages site. One honest limitation the README notes is that the "serverless" description has a caveat: if any participant is on a particularly restrictive network connection, video traffic may end up routed through a third-party relay server rather than flowing directly between browsers. This is a standard WebRTC behavior rather than something specific to this project.

Copy-paste prompts

Prompt 1
Help me run the Rendezvous video conferencing app locally for testing, show me the exact npm commands to install dependencies and start the dev server.
Prompt 2
I want to deploy the Rendezvous app to my own GitHub Pages site. Walk me through the deployment command and any repository settings I need to configure first.
Prompt 3
The Rendezvous app uses a host-relay design where the host's upload bandwidth is shared across all streams. Help me add a participant limit warning that appears when more than 5 people join.
Prompt 4
Add a feature to Rendezvous so that when someone's camera is off, a user-uploaded avatar image shows instead of just their initials.
Open on GitHub → Explain another repo

← predatorray on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.