Threadbyte ⚡

Next-Gen AI-Powered Developer Chat & Collaboration Platform

---

🌐 Live Demo

Live Deployment: https://threadbyte.vercel.app/ (Demo URL Placeholder)

---

📖 Overview

Threadbyte is a high-performance, real-time developer communication and collaboration platform designed specifically for software engineering teams. It bridges instant WebSocket communication with contextual AI code analysis, multi-provider model routing, zero-trust security, and group membership governance.

Developers can discuss codebases, upload multi-file archives, review algorithm snippets, and interact with AI models (OpenRouter Free, Google Gemini, OpenAI) that understand the entire conversation history.

---

📸 Visual Showcase

1. Authentication (Login & Register)

Login Screen

Registration Screen

---

2. Collaboration Hub & Developer Profile

Main Chat Interface (Dual-Card AI Analysis & Code View)

Developer Profile & Activity

---

3. Comprehensive Group Settings

General Settings & Repo Links

Multi-Provider AI Keys (UUID Management)

Membership Join Requests

---

✨ Key Features

• ⚡ Real-Time Collaboration: Sub-millisecond WebSocket bidirectional chat, live typing indicators, and user presence tracking.
• 🤖 Context-Aware Multi-Provider AI:
  • Full group conversational memory fed into AI queries for deep, continuous context.
  • Seamless switching between OpenRouter (Free), Google Gemini, and OpenAI / ChatGPT.
  • 3-level prompt hierarchy: Hardened System Prompt $\rightarrow$ Group Custom Prompt $\rightarrow$ Message-level Override.
• 🔒 Zero-Trust Security & Data Sanitization:
  • Strict server-side verification: Group settings and AI configurations are strictly restricted to the group creator (created_by).
  • Passwords (bcrypt), OAuth tokens, and API keys are masked with json:"-" and never returned in API payloads.
• 👥 Invite Link & Join Requests System:
  • Secure invite codes preview group information without automatically granting entry.
  • Owners review pending join requests with one-click Approve or Reject actions.
• 🌐 Instant Multilingual Translation:
  • Translate any message or AI analysis into Persian (فارسی), English, German (Deutsch), French (Français), Spanish (Español), Arabic (العربية), Russian (Русский), and Chinese (中文).
• 📂 Developer File Attachments:
  • Native support for ZIP code archives, PDFs, audio, video, and high-resolution images.

---

🛠️ Architecture & Tech Stack

graph TD
    Client["Client (Next.js 16 + React 19 + Tailwind CSS)"]
    WS["WebSocket Gateway"]
    API["Gin HTTP Router (Go 1.25)"]
    Auth["JWT & Security Middleware"]
    DB[(PostgreSQL 16 Database)]
    AI["AI Engine (OpenRouter / Gemini / OpenAI)"]

    Client <-->|Real-time Events| WS
    Client <-->|REST API| API
    API --> Auth
    Auth --> DB
    API --> DB
    API --> AI

Loading

Frontend

• Framework: Next.js 16 (App Router, Turbopack)
• UI & Styling: React 19, Tailwind CSS 4, Radix / Shadcn primitives, Lucide Icons, Sonner
• State & Communication: React Hook Form, Zod, Axios, WebSockets
• Testing: Jest, Testing Library (@testing-library/react, @testing-library/jest-dom)

Backend

• Language & Server: Go 1.25, Gin Web Framework
• Persistence & ORM: PostgreSQL 16, SQLC (Type-safe SQL generation), pgx/v5
• Authentication: Stateless JWT (golang-jwt/jwt/v5), bcrypt password hashing, AES encryption
• Testing: Go standard testing package, race detector, mock queries

---

📁 Repository Structure

Threadbyte/
├── .github/
│   └── workflows/
│       └── ci.yml                 # Automated CI/CD workflow
├── backend/
│   ├── cmd/server/main.go         # Application entry point
│   ├── db/
│   │   ├── migrations/            # Versioned SQL schema migrations
│   │   └── queries/               # SQLC prepared query definitions
│   ├── internal/
│   │   ├── ai/                    # Multi-provider AI engine (OpenAI, Gemini)
│   │   ├── api/                   # Handlers, routes, and security middleware
│   │   ├── database/              # PostgreSQL connection & auto-migrations
│   │   └── service/               # Core business logic & sanitized DTOs
│   ├── pkg/utils/                 # JWT, password hashing, cryptography
│   ├── Dockerfile                 # Multi-stage production Docker build
│   └── Makefile                   # Build and development scripts
├── frontend/
│   ├── app/                       # Next.js App Router (pages & layouts)
│   ├── components/                # Modular React UI components
│   ├── lib/                       # API clients, types, validations, auth context
│   ├── __tests__/                 # Jest unit and component test suites
│   └── Dockerfile                 # Next.js standalone container
├── screenshots/                   # Application screenshots for documentation
└── docker-compose.yml             # Full-stack container orchestration

---

🚀 Getting Started

Prerequisites

• Docker & Docker Compose
• Or for local development: Go 1.25+, Node.js 20+, pnpm 10+, PostgreSQL 16+

---

Option 1: Quickstart with Docker Compose (Recommended)

1. Clone the repository:

   git clone https://github.com/v-urit/Threadbyte.git
   cd Threadbyte

2. Configure environment variables: Create a .env file in the root or backend/ directory:

   PORT=8080
   DATABASE_URL=postgres://postgres:postgres@postgres:5432/threadbyte?sslmode=disable
   JWT_SECRET=super-secure-production-jwt-secret-key-32-chars
   CORS_ALLOWED_ORIGINS=http://localhost:3000
   OPENAI_API_KEY=sk-or-v1-your-openrouter-key
   GEMINI_API_KEY=your-gemini-key

3. Start the full stack:

   docker compose up --build

4. Access the application:

   • Frontend: http://localhost:3000
   • Backend API: http://localhost:8080
   • Health Check: http://localhost:8080/health

---

Option 2: Local Development Setup

1. Backend Setup

cd backend
# Start PostgreSQL database (via local docker or system service)
docker compose up -d postgres

# Run database migrations and start server
make run
# Or directly: go run cmd/server/main.go

2. Frontend Setup

cd frontend
# Install dependencies
pnpm install

# Start Next.js development server
pnpm run dev

---

🧪 Testing

Backend Unit & Integration Tests

cd backend
go test -v -race ./...

Frontend Unit & Component Tests

cd frontend
pnpm test

---

📜 License

This project is licensed under the MIT License — see the LICENSE file for details.