Skip to content

Home

Jump to bottom
Zaal Panthaki edited this page Mar 29, 2026 · 2 revisions

ZAO OS

The operating system for decentralized music communities.

ZAO OS is a gated social client built on Farcaster for THE ZAO (ZTalent Artist Organization) — a decentralized music community running 90+ consecutive weeks of fractal governance. It combines messaging, a 9-platform music player, on-chain governance, live audio spaces, and cross-platform publishing into one cohesive experience.

Built with Next.js 16, React 19, Supabase, and the Farcaster protocol. Fully open source and designed to be forked for any community.

For Community Members

Learn how ZAO OS works and what you can do with it:

Page What You'll Learn
Features Overview All five pillars — Social, Music, Governance, Spaces, Library
Music Player Guide 9-platform player, crossfade, binaural beats, radio, playlists
Governance Guide Snapshot polls, fractal voting, ZOUNZ DAO, Respect
Spaces & Calls Voice channels, listening rooms, streaming
Ecosystem Partners — MAGNETIQ, SongJam, Empire Builder, WaveWarZ, ZOUNZ
Research Library Guided index to 164+ research documents in the repo

For Developers & Forkers

Fork ZAO OS for your own community:

Page What You'll Learn
Architecture Overview Tech stack, project structure, key decisions
Fork Guide: Getting Started Clone, configure, deploy your own instance
Fork Guide: Customization Branding, theming, navigation pillars
Fork Guide: Features Enable/disable features, add integrations
Fork Guide: Gating & Access Allowlist, Hats Protocol, Respect tokens
Fork Guide: Database & Auth Supabase setup, iron-session, RLS
API Reference Route patterns, conventions, validation

Quick Links

ZAO OS is built in public by @bettercallzaal. Every feature, every decision, every line of code — documented and shared.

Home

Community Guide

Developer Guide

Fork Guide

Clone this wiki locally