Your lightweight, self-hosted, open-source, and privacy-first chat app. 💬
Built with V and Vite, it's fast, minimalist, and ready to run anywhere.

v install siguici.shub
v run ~/.vmodules/siguici/shub/install.vsh
shub

A minimalist real-time messaging platform, ideal for:

• internal team communication
• local LAN chats or Raspberry Pi setups
• retro-style chatrooms and social spaces
• hacker communities and self-hosted networks

• ⚡ Vlang – backend & WebSocket server
• 🧠 SQLite – optional persistence layer (rooms, users, etc.)
• 🎨 TailwindCSS – beautiful, minimal design
• 🔧 vite.v – V-native frontend builder
• 📡 WebSocket + optional Server-Sent Events (SSE)

• 🧑‍🤝‍🧑 Public & private rooms with password support
• 🔁 Auto-reconnect & ping/pong keep-alive
• 📦 No install — just open index.html
• 🛠️ Single binary backend (no Node.js needed)
• 📡 Real-time messaging via WebSocket
• 🧪 CLI client included (Vlang)
• 🐳 Docker support (optional)
• 🌍 Self-hosted, privacy-first, AGPL-licensed

We ❤️ open collaboration. Fork us, PR us, remix us.
You can contribute:

• new themes or dark mode
• performance or memory optimizations
• CLI or TUI clients in V
• message history or federation support
• translations (i18n)

📚 Read the README
📮 Open an issue or start a discussion!

• 🐙 Contribute
• 📦 Download
• 🌍 Join
• 𝕏 Follow
• 🧑‍💻 Support

Released under the AGPL-3.0 license.
Free as in freedom. ✊

If you run it over a network, you must share your modifications.
Your users deserve the same freedom you enjoy.

Most of Shub was written with love, music, and V.

🎧 Probably listening to lo-fi or retro funk.
🍳 Breakfast? Tunisian brik & black coffee ☕

Made for humans, not corporations.

🕊️ Shub is tiny, transparent and timeless.
Let's bring open chat back.