github.com/ACM-VIT/conclave @main

Conclave

Real-time meetings platform with web/mobile clients, SFU, and an apps SDK

Table of Contents

• About
• Monorepo Layout
• Quick Start
• Mobile Development
• Apps SDK Docs
• Optional Services
• Contributing
• Community & Conduct

About

Conclave is a real-time meetings platform with:

• apps/web: Next.js web client and API routes
• apps/mobile: Expo/React Native mobile client
• apps/conclave-skip: Skip.dev project for native clients
• packages/sfu: mediasoup SFU and real-time socket handlers
• packages/apps-sdk: in-meeting apps runtime SDK (registry, provider, Yjs sync, awareness, uploads)
• packages/shared-browser: optional VNC-based shared browser service

Monorepo Layout

apps/
  web/
  mobile/
packages/
  sfu/
  apps-sdk/
  shared-browser/
scripts/

Prerequisites:

• Node.js 20+
• pnpm 9+
• Docker (optional, for deploy scripts and shared browser runtime image)

Quick Start

1. Install dependencies:

pnpm install

1. Start SFU:

pnpm -C packages/sfu run dev

1. Start web in another terminal:

pnpm -C apps/web run dev

1. Open http://localhost:3000.

Notes:

• Web defaults to https://sfu.acmvit.in if SFU_URL/NEXT_PUBLIC_SFU_URL is unset.
• SFU has development defaults; production must set secrets and announced IPs.

Mobile Development

apps/mobile is intentionally excluded from workspace lockstep due to native tooling constraints.

pnpm -C apps/mobile install
pnpm -C apps/mobile run start

Useful targets:

pnpm -C apps/mobile run ios
pnpm -C apps/mobile run android

Apps SDK Docs

• package README: packages/apps-sdk/README.md
• docs home: packages/apps-sdk/docs/README.md
• add app integration: packages/apps-sdk/docs/guides/add-a-new-app-integration.md
• app cookbook: packages/apps-sdk/docs/guides/app-cookbook.md
• troubleshooting: packages/apps-sdk/docs/guides/troubleshooting.md

Contributor commands:

pnpm -C packages/apps-sdk run new:app polls
pnpm -C packages/apps-sdk run check:apps
pnpm -C packages/apps-sdk run check:apps:fix

Optional Services

Run shared browser service locally:

pnpm -C packages/shared-browser run dev

Deploy SFU pair (Docker Compose):

./scripts/deploy-sfu.sh

Deploy shared browser service (Docker Compose):

./scripts/deploy-browser-service.sh

Contributing

Read CONTRIBUTING.md before opening a PR.

Community & Conduct

By participating in this project, you agree to follow CODE_OF_CONDUCT.md.

🤍 Crafted with love by ACM-VIT