README.md
July 12, 2026 · View on GitHub
Bear Stone Smart Home Documentation
Be sure to :star: my configuration repo so you can keep up to date on any daily progress!
Live view of the config/ directory my production Home Assistant instance loads every night. Use this README as a map when you want to jump directly into the most interesting packages, automations, and supporting assets.
Quick navigation
- You are here:
config/(configuration root) - Repo overview | Blog | Issues | Diagram | YouTube
- Directory highlights: packages, automation, script, scene, templates, dashboards, www, custom_components

What this folder is (and isn't)
- Every YAML file here is live and version-controlled; anything missing is intentionally ignored via
.gitignore(databases, logs, caches, etc.). - This is a split-configuration layout:
configuration.yamlsimply includes the files and directories documented here so changes are easy to isolate. - Nothing in this folder is a drop-in template—borrow ideas, but adjust entity IDs, helpers, and secrets to match your home before reloading HA.
How the config is organized
- Packages (
packages/) – complete subsystems that bundle sensors, switches, automations, scripts, and lovelace assets for a single feature (alarm, garage, water shutoff, etc.). - Container updates –
logs Tugtainer reports into Home Assistant persistent notifications and dispatches controlled review work.
- Automations (
automation/) – event-driven YAML broken out by area or device; the legacyautomations.yamlremains for UI-created flows. - Scripts & scenes (
script/,scene/) – curated lighting, notification, and AGENT engineer handoff helpers used by presence, holiday, seasonal, and infrastructure routines. - Templates (
templates/) – Jinja helpers and speech templates reused by the notify/speech engines. - Dashboards (
dashboards/) – YAML-managed Lovelace dashboards and UI resources (generated from storage, then maintained as code). - www/ + custom components – branding assets, floorplans, and any custom components the core install depends on.
- Custom Sidebar –
www/custom-sidebar-config.yamlcontrols the bottom Developer Tools shortcut; HACS owns the plugin files underwww/community/custom-sidebar.
Featured automations by section
| Section | Why start here | Featured automation(s) |
|---|---|---|
| Packages | Self-contained subsystems that highlight patterns like combined alerts + actions. | |
| Automations | Real-world triggers that tie Zwave, MQTT, and REST sensors into the rest of the house. | |
| Scripts | Reusable building blocks for lighting, notifications, safety responses, and Joanna/BearClaw remediation dispatch. | |
| Scenes | Seasonal and ambiance presets that the scripts and automations call into. | |
| Templates & Speech | Human-friendly voice briefings and templated responses. | |
| Dashboards & Media | UI chrome, floorplans, sound bites, and automation assets. | dashboards/kiosk, topology diagram, media/ |
| Seasonal Audio | Cuckoo clock with Halloween and Christmas sound packs. |
The latest walkthrough shows a two-lane Docker update workflow: Tugtainer handles routine checks and recreates, Home Assistant keeps every report visible, and Codex handles exceptions through Compose with service-specific proof.
. YAML lives in
, with the supporting infrastructure dashboard. The earlier water-softener, HVAC, Powerwall, Codex reset-credit, leak-detection, kiosk, and LLM Vision walkthroughs are still available with examples in
,
,
,
,
,
, and
.
Gear tied to these automations (affiliate links)
Only including devices that have active references in the files above or an open implementation issue.
| Device | What it drives (friendly name -> file) | Buy |
|---|---|---|
| Amazon Fire tablet wall kiosk | Bedroom camera screen with Fully Kiosk recovery, bedtime dimming, and a dedicated YAML dashboard - | |
| Garadget garage door controller | Garage doors: open/close, arrival helpers, wind alerts, and nighttime reminders - | |
| August smart lock | Front-door lock status + remote control – | |
| Amazon Echo Show | Pops up the front doorbell camera when the August lock unlocks – | |
| Phyn Plus water shutoff | Leak detection + auto shutoff - | |
| Rachio sprinkler controller | Rain-skips, active-zone status, trigger-derived last-run history, and dashboard controls – | |
| Tesla Powerwall 2 | Grid-outage alerts, charging watchdog, and load-shed automations - | |
| Google Nest thermostat | HVAC schedules plus runtime-based filter reminders and condenser-line cleanout tracking - | |
| NodeMCU motion sensor | Office motion lighting + comfort scenes – | |
| Raspberry Pi 3 + Aeon Z-Wave stick | Z-Wave backbone for door/hall sensors - | |
| Roku streaming device | TV presence -> scenes/lighting – | |
| Amazon Dash Button | Quick actions (office lamp toggle) – | |
| Amazon Echo Glow | Visual notification light candidate for Home Assistant status cues - | |
| Dreame/Neato vacuum | Cleaning schedules, room queues, Alexa room cleans, and rescue notifications - | |
| Flux/LED strip controller | Monthly color scenes for exterior – | |
| Etekcity/433MHz outlet | Accent lighting relays – |
Tips for re-use
- Copy a package folder and adjust entity IDs in one place instead of hunting through automations.
- Use the scripts and scenes as examples of how to break complicated flows into composable blocks.
- The
www/assets are ideal references when building your own Lovelace floorplans or dashboards.
All of my configuration files are tested against the most stable version of home-assistant.
