Chocolate Smart Home 🍫🏠

An extensible smart home platform that enables integration of custom IoT devices and clients through a plugin-based architecture.

Project Components

Backend Service

A Fast API-powered backend that handles device communication and client requests.

• Backend Repository

Frontend Application

A React-based web interface for device control and monitoring.

• Frontend Repository

Microcontroller Integration

Libraries and examples for integrating various microcontroller-based devices.

• Microcontroller Repository

Websocket Service

A websocket service for real-time communication between the frontend and backend.

• Websocket Repository

Development (requires docker compose and make to be installed)

Clone project and navigate to the project directory:

git clone --recurse-submodules git@github.com:ZFudge/chocolate-smart-home.git
cd chocolate-smart-home

Run the following script to pull external images, build local images, install frontend dependencies, and copy environment variables:

./setup-dev.sh

Start project in development mode:

make dev

Open http://localhost:15173/ in your browser.

Stop project:

make down

View logs:

make logs

View mqtt logs:

make mqttlogs