Home-AssistantConfig/config/README.md

Bear Stone Smart Home Documentation

Be sure to ⭐ 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.yaml simply 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 – packages/tugtainer_updates.yaml logs container updates from Tugtainer into Home Assistant persistent notifications.
• Automations (automation/) – event-driven YAML broken out by area or device; the legacy automations.yaml remains 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.yaml controls the bottom Developer Tools shortcut; HACS owns the plugin files under www/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.	packages/alarm.yaml, packages/garadget.yaml, packages/llmvision.yaml, packages/phynplus.yaml, packages/kiosk_tablet.yaml, packages/vacation_mode.yaml, packages/vacuum.yaml, packages/powerwall.yaml
Automations	Real-world triggers that tie Zwave, MQTT, and REST sensors into the rest of the house.	automation/garage_entry_light.yaml, automation/dark_rainy_day.yaml, automation/dash_buttons.yaml
Scripts	Reusable building blocks for lighting, notifications, safety responses, and Joanna/BearClaw remediation dispatch.	script/joanna_dispatch.yaml, script/notify_engine.yaml, script/speech_engine.yaml
Scenes	Seasonal and ambiance presets that the scripts and automations call into.	scene/monthly_colors.yaml, scene/living_room.yaml
Templates & Speech	Human-friendly voice briefings and templated responses.	templates/speech/briefing.yaml
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.	automation/System/CucKoo_Clock.yaml

The latest walkthrough shows the HVAC maintenance loop in Home Assistant: video, YAML in packages/climate.yaml and dashboards/overview/partials/water_sections.yaml, and the background in issue #273. The earlier Powerwall, Codex reset-credit, leak-detection, kiosk, and LLM Vision walkthroughs are still available with examples in packages/powerwall.yaml, packages/bearclaw.yaml, packages/phynplus.yaml, packages/kiosk_tablet.yaml, and packages/llmvision.yaml.

Gear tied to these automations (affiliate links)

Only including devices that have active references in the files above.

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 - kiosk tablet package, kiosk dashboard, video walkthrough
Garadget garage door controller	Garage doors: open/close, arrival helpers, wind alerts, and nighttime reminders - garadget package, garage entry helper, video walkthrough, companion post
August smart lock	Front-door lock status + remote control – august package
Amazon Echo Show	Pops up the front doorbell camera when the August lock unlocks – august package
Phyn Plus water shutoff	Leak detection + auto shutoff - phynplus package, video walkthrough, companion post, original write-up
Rachio sprinkler controller	Rain-skips and seasonal watering – rachio package
Tesla Powerwall 2	Grid-outage alerts, charging watchdog, and load-shed automations - powerwall package, video walkthrough, companion post
Google Nest thermostat	HVAC schedules plus runtime-based filter reminders and condenser-line cleanout tracking - climate package, dashboard partial, video walkthrough
NodeMCU motion sensor	Office motion lighting + comfort scenes – office_motion package
Raspberry Pi 3 + Aeon Z-Wave stick	Z-Wave backbone for door/hall sensors - garage entry helper, garage automation video
Roku streaming device	TV presence -> scenes/lighting – roku package
Amazon Dash Button	Quick actions (office lamp toggle) – dash buttons automation
Dreame/Neato vacuum	Cleaning schedules, room queues, Alexa room cleans, and rescue notifications - vacuum package, video walkthrough, companion post
Flux/LED strip controller	Monthly color scenes for exterior – monthly color scene script
Etekcity/433MHz outlet	Accent lighting relays – garage entry helper

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.

Still have questions on my Config?
Message me on X :

You can buy me a coffee

Affiliate Disclosure