README.md
September 10, 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 –
processes Available reports without persistent alerts, keeps Updated/Failed outcomes visible, and dispatches controlled review work.
- WAN monitoring –
,
, and the WAN dashboard separate multi-probe reachability, continuous latency/loss, Ookla capacity, and result freshness.
- Entity cleanup –
,
, recorder, and logbook show how the Portainer and Glances audit kept proven history while removing stale registry noise.
- Automations (
automation/) – event-driven YAML broken out by area or device; the legacyautomations.yamlremains for UI-created flows. The Frigate driveway example turns a car-specific zone and 30-second loiter into a two-phone camera alert plus LLM-backed speech. - 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, including a phone-first Overview view with large two-column controls. - www/ + custom components – branding assets, floorplans, and any custom components the core install depends on.
- Custom Sidebar –
www/custom-sidebar-config.yamlpins Overview/Systems, hides Calendar/Media, and controls 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, REST, and Frigate occupancy events 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, including quiet-by-default air-quality warnings with separate Airly CAQI and Pirate Weather US AQI thresholds. | |
| Dashboards & Media | Desktop control-center, mobile quick-access, and purpose-built kiosk views, UI chrome, floorplans, and automation assets. | dashboards, WAN dashboard, Bedroom dashboard, |
| Seasonal Audio | Cuckoo clock with Halloween and Christmas sound packs. |
The latest walkthrough uses Tesla Fleet's four PSI sensors to send an early warning below 40 PSI and share one-day or three-day snoozes with Joanna's morning briefing.
. The Home Assistant implementation is
. The earlier driveway, WAN, mobile-dashboard, air-quality, entity-cleanup, Tugtainer, water-softener, HVAC, Powerwall, leak-detection, kiosk, and LLM Vision walkthroughs remain available in their featured rows.
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 Fully recovery and clock-free night-watch dashboard plus a distinct Kitchen Show clock/forecast, household-alert surface, motion-aware idle dimming, household-aware screen power, and state-driven full-screen Garage/Front Door views - | |
| Garadget garage door controller | Garage doors: open/close, arrival helpers, 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 - | |
| 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.
