Project Overview
EdgeChat is an edge-hosted chat system built on the Cloudflare ecosystem. It is suitable for internal team communication, private communities, and lightweight in-app messaging.
Its goals are simple: low setup effort, low cost, and easy deployment. Public registration is disabled by default; administrators control access by inviting users or creating accounts manually.
Core Features
- Group chats, including public groups and custom private groups
- One-to-one direct messages
- Server-side encryption for newly written messages and attachments, without bulk migration of historical data
- No message-content search or full-conversation inspection in the admin panel
- Administrators can permanently ban users or set temporary bans in days, hours, or minutes; expired bans lift automatically without scheduled jobs
- File uploads, avatars, and real-time messaging
- Bidirectional synchronization of text, Unicode Emoji, and files up to 16 MiB between public groups and Telegram group chats
Technology Stack
- Frontend: Vue 3 + Vue Router + Vite
- Backend: Cloudflare Workers + Hono
- Data: Cloudflare D1
- Sessions: Cloudflare KV
- Files: Cloudflare R2
- Real-time communication: Durable Objects + WebSocket
Suggested Reading Order
If you are preparing to deploy EdgeChat, start with Getting Started, then continue with GitHub Actions Deployment. To connect a Telegram group chat, see Telegram Bridge.