Skip to content

buzzu-p2p/BuzzU

BuzzU

BuzzU is a decentralized virtual campus and trust-aware social discovery platform built with Nostr identity, WebRTC, and Cloudflare edge services.

Created by Wasif Faisal. Founder and Original Creator: Wasif Faisal.

Official repository: buzzu-p2p/BuzzU GitHub maintainer: @cswasif

Why BuzzU

BuzzU is designed to help students discover like-minded peers, start conversations more safely, and build lasting connections without giving up control of identity to a centralized platform.

Core Ideas

  • Portable identity through Nostr public keys
  • Real-time text and video matching over WebRTC
  • Trust-aware matching and safety controls
  • Interest-based discovery for like-minded peers
  • Edge-native deployment with Cloudflare Pages and Workers

Monorepo Layout

apps/
  web/                Main web app and Cloudflare Pages frontend
  signaling-worker/   WebRTC signaling worker
  matchmaker-worker/  Trust-aware matchmaker worker
  user-index-worker/  Discovery and indexing worker
  nip05-worker/       NIP-05 support worker
packages/
  shared-contracts/   Shared types and contracts
  wasm/               WASM package and bridge
  nostr-reputation/   Reputation package

For the first public release, keep the repo focused on active runtime components. apps/reputation-worker/ should stay out of the initial GitHub release unless it is restored and documented as active.

Why Monorepo

BuzzU should stay a monorepo because the frontend, workers, shared contracts, and research documentation evolve together. A single repository keeps onboarding simpler, avoids version drift, and makes the system easier to reproduce for contributors and researchers.

Quick Start

Prerequisites

  • Node.js 18+
  • pnpm 9+
  • Rust toolchain for worker and WASM development
  • Wrangler CLI credentials for Cloudflare deployment

Install

pnpm install

Run the main app

pnpm dev

Useful scripts

pnpm dev:full
pnpm dev:workers
pnpm build
pnpm test
pnpm deploy

Development Principles

  • Keep BuzzU easy to run from one clone
  • Treat trust and safety features as core architecture, not optional polish
  • Prefer shared packages for contracts and cross-app logic
  • Document protocol and moderation decisions in the repo

Governance And Attribution

BuzzU is open source, but the official project direction remains under founder-led governance.

See:

  • AUTHORS.md
  • NOTICE
  • GOVERNANCE.md
  • TRADEMARK.md
  • CITATION.cff

Security

If you discover a vulnerability, please follow the process in SECURITY.md.

Contributing

Contribution guidelines live in CONTRIBUTING.md.

Public Release Scope

Use PUBLIC_RELEASE_CHECKLIST.md before the first public GitHub push to confirm what should be included and what should stay private or local-only.

License

BuzzU is licensed under Apache-2.0. See LICENSE.

Research And Citation

If you use BuzzU in research, please cite the project using CITATION.cff.

Releases

No releases published

Packages

 
 
 

Contributors