DamageLabs/kandan

---

DamageLabs/kandan.json

{
  "createdAt": "2013-01-24T19:24:05Z",
  "defaultBranch": "main",
  "description": "Kandan is an Open Source Alternative to HipChat",
  "fullName": "DamageLabs/kandan",
  "homepage": "",
  "language": "TypeScript",
  "name": "kandan",
  "pushedAt": "2026-04-06T02:21:12Z",
  "stargazersCount": 2685,
  "topics": [],
  "updatedAt": "2026-07-11T20:35:25Z",
  "url": "https://github.com/DamageLabs/kandan"
}

Kandan Core

Modern revival of Kandan — a self-hosted open-source team chat app. Built on Angular 21 + Express/Node/TypeScript with real-time messaging via Socket.io.

Status: Early development. Backend scaffolded, Angular client coming next.

Stack

Layer	Technology
Frontend	Angular 21 + TailwindCSS
Backend	Express 5 + TypeScript
Database	SQLite via Drizzle ORM
Real-time	Socket.io
Auth	JWT + bcrypt

Features (planned)

• Real-time messaging via WebSockets
• Multiple channels
• User authentication (register/login/JWT)
• Admin controls (user approval, suspension, channel management)
• File attachments
• /me emote commands
• Typing indicators
• Message history with pagination
• Dark/light mode

Getting Started

git clone git@github.com:DamageLabs/kandan-core.git
cd kandan-core

# Server
cd server
cp ../.env.example .env   # edit as needed
npm install
npm run dev               # http://localhost:3200

API

Endpoint	Method	Description
/api/v1/auth/register	POST	Register new user
/api/v1/auth/login	POST	Login, returns JWT
/api/v1/auth/me	GET	Current user
/api/v1/channels	GET	List channels
/api/v1/channels/:id	GET	Channel + recent messages
/api/v1/channels	POST	Create channel (admin)
/api/v1/messages/channel/:id	GET	Paginated message history
/api/v1/users	GET	List users (admin)

Socket.io Events

Event	Direction	Description
channel:join	client → server	Join a channel room
channel:leave	client → server	Leave a channel room
message:send	client → server	Send a message
message:new	server → client	New message broadcast
typing:start	client → server	User started typing
typing:stop	client → server	User stopped typing
user:connected	server → client	User joined channel
user:disconnected	server → client	User left channel

License

MIT