Bloyid

Bloyid is a Discord-inspired but visually distinct community platform with real-time chat, voice channel scaffolding, DMs, server/channel management, roles/permissions, invite links, a bump system, and bot/developer tooling.

Stack

• Frontend: React + Vite
• Backend: FastAPI + Motor (MongoDB)
• Realtime: WebSocket (chat presence/events)
• Voice: WebRTC signaling scaffolding

Project Structure

• backend/ FastAPI API, auth, websocket, Mongo models
• frontend/ React SPA with all primary pages/views
• docs/ API docs and product notes

Frontend Docs Page

• Public docs page in the app: http://localhost:5173/docs
• Includes architecture summary, API quick reference, and Docker quick start

One-Command Docker Host (recommended)

From project root run:

• docker compose up --build -d

Or on Windows PowerShell:

• ./scripts/start-docker.ps1

Then open:

• Frontend: http://localhost:5173
• Frontend Docs: http://localhost:5173/docs
• Backend API: http://localhost:8000

Public Hosting (network/external access)

• Frontend and backend are bound to all interfaces (0.0.0.0) in docker-compose.yml.
• Access from another device in your network:
  • http://<SERVER_IP>:5173
  • http://<SERVER_IP>:8000
• This repo is prefilled for your domains:
  • Frontend host: https://chat.radionet.app
  • Backend host: https://backend.radionet.app
  • VITE_API_BASE=https://backend.radionet.app/api
  • VITE_WS_BASE=wss://backend.radionet.app
• You can override via root .env if needed, then run docker compose up --build -d
• Open firewall/router ports:
  • 5173/TCP (frontend)
  • 8000/TCP (backend)

Logs:

• docker compose logs -f

Stop:

• docker compose down

Reset DB volume:

• docker compose down -v

Local Quick Start (without Docker)

1. Start MongoDB locally (mongodb://localhost:27017).
2. Backend:
   • cd backend
   • python -m venv .venv
   • .venv\\Scripts\\activate
   • pip install -r requirements.txt
   • uvicorn app.main:app --reload --port 8000
3. Frontend:
   • cd frontend
   • npm install
   • npm run dev

Frontend expects backend at http://localhost:8000.