Skip to content

nostrocket/relayexplorer

Repository files navigation

Nostr Relay Browser

Discover the hidden gems and thriving communities you've been missing across Nostr's vast relay ecosystem with this powerful tool, transforming your limited feed into an infinite universe of authentic human connections.

Ever wondered what's happening inside a Nostr relay? This sleek browser app transforms any Nostr relay into an explorable universe of decentralized content, wrapped in a beautiful email-client-inspired interface that makes browsing events as intuitive as checking your inbox.

Connect to any relay with a single URL, watch real-time events stream in, and explore the raw pulse of the decentralized social web with powerful filtering, search, and export capabilities—all running entirely in your browser with zero backend dependencies.

✨ What Makes This Special

  • One-Click Relay Exploration - Just paste a relay URL and instantly dive into its event stream
  • Gmail-Inspired UI - Familiar three-pane layout with sidebar navigation, event timeline, and detailed preview
  • Real-Time Updates - Watch events flow in live via WebSocket subscriptions
  • Smart Filtering - Browse by event types (notes, profiles, reactions), authors, or time ranges
  • Developer-Friendly - Export events as JSON, view raw event data, and inspect relay metadata
  • Privacy-First - Completely client-side with no tracking, accounts, or data collection

🛠 Tech Stack

Built on a modern foundation:

  • React 19 + TypeScript for robust development
  • Vite 7 for lightning-fast builds and development
  • shadcn/ui + Tailwind CSS v4 for beautiful, accessible components
  • NDK/nostr-tools for Nostr protocol compliance
  • Responsive design that works perfectly on mobile and desktop

🚀 Quick Start

git clone [repository-url]
cd relay_browser
npm install
npm run dev

Visit http://localhost:5173 and start exploring the decentralized web!

🎯 Perfect For

  • Nostr Enthusiasts - Discover what's happening across different relays
  • Developers - Debug relay behavior and inspect event structures
  • Researchers - Analyze decentralized social patterns and content flows
  • Curious Minds - Experience the raw, unfiltered pulse of Web3 social networking

Join the decentralized revolution - one relay at a time. 🌐

About

Browse individual nostr relays for fun and profit

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published