Identity belongs to the conversation. Not to the person.

---

🌐 Project Ecosystem

• 🌐 Marketing Website: joinchorus.app
• 📖 Technical Documentation: docs.joinchorus.app
• 💬 Live Application: chat.joinchorus.app

---

💡 What is Chorus?

Chorus is an open-source, high-performance anonymous discussion engine. It replaces account registration, user profile tracking, and social media mechanics (likes, upvotes, followers, ranking algorithms) with thread-scoped temporary identities, chronological reading, and an immutable Git persistence engine.

---

⚡ Why it is Different

Traditional Social Platforms	Chorus Discussion Engine
Persistent user accounts & profiles	Zero accounts. No signups or OAuth tracking.
Reputation, likes, karma & follower counts	No likes, upvotes, downvotes, or leaderboards.
Algorithmically ranked feed loops	Pure chronological discourse.
Opaque proprietary databases	Immutable, audit-proof native Git commit engine.
Global identity tracking	Temporary identity assigned per thread (River 🇹🇷).

---

🛠️ Architecture & Mechanism

Every thread creation and message append produces a native, cryptographic Git commit:

./data/repository/
├── .git/
├── identities/
│   └── <identity_id>.json
└── threads/
    └── <thread_id>/
        ├── index.json
        └── messages/
            └── <message_id>.json

Commit history remains cryptographic and tamper-proof:

• c19d788 — thread: create thd_059f40
• dee2875 — message: append msg_111
• 32f90ec — message: append msg_222

---

🚀 Quickstart

1. Run Backend Server (Go 1.22+)

go run ./cmd/server
# Server running on http://localhost:8085

2. Run Frontend Dev Server (Node.js 22+)

cd web
npm install
npm run dev
# Vite dev server running on http://localhost:3000

3. Run with Docker Compose

docker-compose up --build

---

🧪 Testing & Verification

# Run backend Go unit and integration test suite
go test -v ./...

# Build production React SPA bundle
cd web && npm run build

---

🤝 Credits & Origin

• 💡 Concept & Product Idea: Mehmet Emin Dereci (@MEmin00)
• 🏗️ Architecture, Lead Development & First Release: Barış Salih Babacan (@barissalihbabacan)

---

📄 License & Community

Distributed under the MIT License. See LICENSE for details.
Read our CONTRIBUTING.md and SECURITY.md guidelines.