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 [email protected]: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