HavenDOCS
Back to Home

Welcome to Haven

Haven is a premium, high-performance social platform designed for meaningful connections and deep vibes. Built with the Vedic Digital Ashram aesthetic—"Stone & Flame"—it combines ancient tranquility with cutting-edge real-time technology.

🏁 What is Haven?

Formerly known as Gurukul, Haven has evolved from an experimental social tool into a comprehensive Social Synergy Engine.

  • Connect & Vibe: A sub-10ms matchmaking system that pairs you with compatible souls using WebRTC.
  • Sangha (Servers): Discord-style persistent communities for group voice/video, powered by LiveKit SFU.
  • Vibrational Economy: A gamified progression system (XP, Levels, Voice-Minutes) that rewards presence and positivity.
  • memberly Architecture: Robust security including AI NSFW scanning and an Auth Proxy layer.

🚀 Quick Start

1. Prerequisites

  • Node.js 18+ (LTS recommended)
  • pnpm or npm
  • Supabase Account (PostgreSQL + Auth)
  • LiveKit Cloud Account (for Sangha)
  • Upstash Redis (for Rate Limiting)

2. Installation

git clone https://github.com/AniketShinde02/Haven.git haven
cd haven
npm install

3. Environment Setup

Copy the .env.example to .env.local and fill in your keys. Reference the Environment Variables guide for details.

4. Run Development

# Start the Next.js app
npm run dev

# (Optional) Start the local matchmaking server
cd matchmaking-server
npm install
npm run dev

🧱 Core Architecture at a Glance

Haven is a distributed ecosystem:

  1. The Nexus (Next.js): Handles the UI, Auth Proxy, and Database interactions.
  2. The Pulse (WebSocket Server): A dedicated Node.js microservice that manages the high-speed matching queue.
  3. The Void (Supabase): Persistent storage, Auth, and RLS-secured real-time tables.
  4. The Ether (LiveKit): High-fidelity SFU infrastructure for low-latency group calls.

Maintained by the Haven Core Team.