Overview

WSHome is a modular, full-stack Smart Home system engineered for cross-platform compatibility and hardware-agnostic deployments. Whether you're building a small personal setup or deploying across dozens of devices, WSHome offers the flexibility, scalability, and performance to adapt to any modern computing environment.

Built to Run Anywhere

Designed with platform independence in mind, WSHome can be deployed and operated on:

• 💻 Any OS that supports Docker (Linux, Windows, macOS)

• 📦 Bare-metal servers or lightweight virtual machines

• ☁️ Cloud platforms and self-hosted environments

• 🔌 Microcontrollers and embedded systems that support networked communication (e.g. ESP32, Raspberry Pi, custom boards)

All device communication is handled via standardized WebSocket protocols, meaning any internet-connected device — from a WiFi-enabled relay to a full Linux system — can be part of the network.

Key Features

• 🔁 Real-time bidirectional communication

• 🔐 JWT-based authentication with role support

• 📦 Containerized architecture for clean deployment and isolation

• 🌱 Lightweight firmware compatible with ESP-IDF for edge devices

• 🧰 Reusable Kotlin library for consistent backend tooling

Ideal For

• Developers building cross-platform smart systems

• IoT engineers integrating custom microcontroller firmware

• Makers prototyping on ESP32, Raspberry Pi, or similar boards

• Teams needing a unified backend & frontend for device control

• Self-hosters and automation enthusiasts who value privacy