2026.2.0 by jesserockz · Pull Request #6114 · esphome/esphome-docs

jesserockz · 2026-02-18T20:37:25Z

Do not merge, release script will automatically merge

Fix Made for ESPHome logo links and add missing PNGs docs#5917
Fix unresolved image warnings and fail build on missing images docs#5918
Update changelog for 2026.1.0 docs#5919
Update web_server and captive_portal compression default to gzip docs#5924
add Guition JC8012P4A1 docs#5922
[easy] Replace "name" key for color with "id" key in display docs docs#5927
[select] Document select.is condition docs#5928
[mipi_spi] Add docs for CYD variants docs#5947
[status] Document update_interval option docs#5943
[debug] Document min_free sensor and ESP32 fragmentation support docs#5921
Describe the max_delta filter docs#5807
Add Claude Code PR workflow skill docs#5930
[heatpumpir] Add ESP-IDF framework support to docs docs#5959
[infrared] Fix example in release notes docs#5963
[esp32] esp-idf is now the default framework for all variants docs#5960
[nextion] Add configurable startup and queue timeout constants docs#5454
[mipi_dsi] add M5Stack-Tab5-V2 model docs#5677
[bthome_mithermometer] add encrypted beacon support docs#5961
Remove media players that don't rely on Sendspin docs#5965
[sensor] Update clamp filter docs docs#5966
Add Dew Point Sensor Component to DIY examples docs#5964
[scd4x] fix indent in yaml example docs#5967
Adjust BMP581 for component rename, additional sensor example, stage for SPI docs#5914
initial creation for sy6970 component docs#5935
[http_request] Document ca_certificate_path for ESP32 docs#5982
[esp32] Document use_full_certificate_bundle advanced option docs#5989
Add Huidu HD-WF1 to display component list docs#5942
[zigbee,time] add zigbee time doc docs#5863
[zigbee] address change docs#5991
Bump docker/login-action from 3.6.0 to 3.7.0 docs#6000
[nrf52,zigbee] add number docs#5995
Add CH423 I/O expander documentation docs#5895
[pmsx003] add new types docs#5850
[esp32] Document include_builtin_idf_components advanced option docs#6001
Add docs for dlms_meter component docs#4536
[ethernet] Add docs for on_connect and on_disconnect triggers docs#6018
Add WAVESHARE-ESP32-P4-WIFI6-TOUCH-LCD-7B mipi_dsi driver docs#5998
[key_collector] Document text_sensor docs#6003
[cover] document new triggers docs#5971
Update Arduino vs ESP-IDF build time comparison docs#6036
[esp32] Document Arduino selective compilation optimization docs#6006
[vbus]: document DeltaSol BS/2 (DrainBack) support docs#6032
Update DSMR documentation to match changes in https://github.com/esph… docs#6038
Add target temperature lambda to water heater template docs#6012
[epaper_spi] Document JD79660 based Waveshare 1.54 (G) docs#6030
[mipi_dsi] Add WAVESHARE-ESP32-P4-WIFI6-TOUCH-LCD 3.4C and 4C docs#6046
Add on and away state lambdas to water heater template docs#6044
[globals] Document update_interval option docs#5945
[ld2450] Document on_data action docs#5993
[esp32] Document advanced sdkconfig options for debug, TLS, FATFS, and peripherals docs#5999
[bl0942] Update references docs#5853
[logger] Add nRF52 to task_log_buffer_size documentation docs#6061
fix: SchemaGen more resilent handling of docref shortcode docs#6062
[mqtt.cover] Adds mqtt_use_json_payload option to cover. docs#5817
[esp32_ble_beacon] Document tx_power unavailable on ESP-Hosted docs#6040
Hugo to Starlight migration docs#6037
[bl0942] Update docs to match esphome PR#12867 docs#6075
[changelog] Add 2026.2.0 release highlights and breaking changes docs#6070
Fix malformed links and add missing image in component index docs#6076
Fix blank guides/changelog and guides index pages docs#6077
Prefix APIRef links with "API Reference:" docs#6081
Make changelog index a real searchable page docs#6083
[remote_transmitter, remote_receiver, esp32_rmt_led_strip] Document ESP32-C2/C61 no RMT support docs#6086
Fix changelog redirect to preserve URL hash fragment docs#6088
[combination] Fix 'coeffecient' typo to 'coefficient' docs#6087
[sensor] Add filter headings to table of contents docs#6102
Remove Hugo leftovers and update dev tooling for Starlight docs#6078
Remove Docker development environment docs#6103
Remove dangling postCreate.sh file docs#6105
Remove assets symlink docs#6106
Auto-generate All Actions/Conditions lists from doc headings docs#6107
[docs] Add linter check for automation headings and fix sprinkler docs#6109
Link domain names to component pages in automation lists docs#6111

Metadata

Co-authored-by: J. Nick Koston <[email protected]>

* [hub75] Update scan enum values * add SCAN_1_8_40PX_HIGH

* Fix Made for ESPHome logo links and add missing PNGs - Move logo files from content/guides/images/ to static/images/ for simpler absolute path references - Generate missing PNG versions of logos (white-on-black, black-on-transparent, white-on-transparent) - Update markdown to use absolute paths (/images/...) instead of relative paths that resolved incorrectly - Fix SEO image path in frontmatter Fixes #5894 Co-Authored-By: Claude Opus 4.5 <[email protected]> * Skip absolute /images/ paths in internal link validation Allow links to static image assets like /images/foo.png in markdown without triggering the internal link checker. Co-Authored-By: Claude Opus 4.5 <[email protected]> --------- Co-authored-by: Claude Opus 4.5 <[email protected]>

Move images from static/images/ to content/images/ (which is mounted as assets/) so Hugo's resource pipeline can find them. The img shortcode uses resources.Get which searches in assets/, not static/. This fixes warnings like: "Unresolved image 'captive_portal-ui.png' in page..." Images moved: - captive_portal-ui.png - factory-rst-ui.png - gpio-ui.png - haier-climate.jpg - output-ui.png - safemode-ui.png - shutdown-ui.png Also change warnf to errorf in the image partial so CI will catch missing images by failing the build. Co-authored-by: Claude Opus 4.5 <[email protected]>

This one entry in the docs has a "name" key for a color, but this appears to be mistaken; every other entry has "id", and "id" appears to be correct.

* Add reference to water heater template documentation * Remove empty line in water heater index file

…mperature documentation (#5949) * [water_heater] Fix incorrect Home Assistant integration and target_temperature documentation * Update content/changelog/2026.1.0.md Co-authored-by: Copilot <[email protected]> --------- Co-authored-by: Copilot <[email protected]>

Co-authored-by: clydebarrow <[email protected]>

Co-authored-by: Keith Burzinski <[email protected]>

Co-authored-by: Clyde Stubbs <[email protected]> Co-authored-by: dcgrove <[email protected]>

Add a skill that teaches Claude Code the proper procedures for creating pull requests in esphome-docs, including: - Basing branches on upstream (not fork) - Using the correct PR template - Choosing the right base branch (current vs next) - Filling in all required template sections Co-authored-by: Claude Opus 4.5 <[email protected]>

Co-authored-by: Claude Opus 4.6 <[email protected]>

2026.2.0b3

Co-authored-by: Claude Opus 4.6 <[email protected]>

) Co-authored-by: Claude Opus 4.6 <[email protected]>

2026.2.0b4

Co-authored-by: Claude Opus 4.6 <[email protected]>

2026.2.0b5

Copilot

Pull request overview

Migrates the ESPHome docs site from the legacy Hugo-based structure to an Astro/Starlight-based setup and updates tooling/CI accordingly.

Changes:

Added Astro/Starlight configuration and updated repository docs to reflect the new structure and authoring patterns.
Updated CI/dev tooling (Node-based build/lint, devcontainer, Gitpod, VS Code task).
Removed legacy Hugo content/pages, build scripts, and Docker-based dev workflow artifacts.

Reviewed changes

Copilot reviewed 65 out of 2772 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
content/changelog/2024.7.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/changelog/2023.8.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/changelog/2023.7.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/changelog/2023.5.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/changelog/2023.4.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/changelog/2023.10.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/changelog/2022.9.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/changelog/2022.8.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/changelog/2022.6.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/changelog/2022.5.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/changelog/2022.4.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/changelog/2022.3.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/changelog/2022.10.0.md	Removes legacy Hugo changelog page (part of migration cleanup).
content/automations/templates.md	Removes legacy Hugo automation templates page (part of migration cleanup).
content/automations/all_conditions.md	Removes legacy Hugo generated automations list page (part of migration cleanup).
content/automations/all_actions.md	Removes legacy Hugo generated automations list page (part of migration cleanup).
content/automations/actions.md	Removes legacy Hugo automations documentation page (part of migration cleanup).
content/automations/_index.md	Removes legacy Hugo automations section index (part of migration cleanup).
content/_index.md	Removes legacy Hugo homepage content (part of migration cleanup).
build_automations_pages.py	Removes legacy helper script used for Hugo automation pages.
astro.config.mjs	Adds Astro/Starlight site configuration and sidebar generation logic.
assets	Removes legacy assets symlink (migration cleanup).
all_automations.json	Removes legacy generated automation data file (migration cleanup).
README.md	Updates repo documentation for Astro/Starlight structure and workflows.
Makefile	Removes Hugo/Pagefind build targets (replaced by npm scripts).
Dockerfile	Removes Docker-based dev environment (migration cleanup).
.vscode/tasks.json	Updates VS Code task to run Astro dev server instead of `make live-html`.
.markdownlintignore	Ignores node_modules for markdown linting in Node-based workflow.
.gitpod.yml	Updates Gitpod port and commands for Astro dev server.
.github/workflows/docker.yml	Removes Docker image build workflow (migration cleanup).
.github/workflows/ci.yml	Switches CI to Node-based install/build/lint.
.github/dependabot.yml	Switches Dependabot from pip to npm updates.
.github/copilot-instructions.md	Updates contributor/AI guidance to Astro/Starlight + MDX practices.
.github/PULL_REQUEST_TEMPLATE.md	Updates template paths and image placement guidance for new structure.
.devcontainer/postCreate.sh	Removes Hugo/Python devcontainer bootstrapping script.
.devcontainer/devcontainer.json	Updates devcontainer to Node/Astro toolchain and port 4321.
.claude/instructions.md	Updates writing guidance to MDX/Astro conventions (images, alerts, links).

Copilot · 2026-02-18T20:39:47Z

astro.config.mjs

+import { defineConfig } from "astro/config";
+import starlight from "@astrojs/starlight";
+import sitemap from "@astrojs/sitemap";
+import starlightBlog from "starlight-blog";


starlightBlog is imported but not used (the plugin configuration is commented out). This commonly fails linting in Node/TS repos. Either remove the unused import or re-enable the plugin configuration so the import is exercised.

Suggested change

import starlightBlog from "starlight-blog";

Copilot · 2026-02-18T20:39:47Z

astro.config.mjs

+function getChangelogItems() {
+  const changelogDir = path.join(__dirname, "src/content/docs/changelog");
+  const files = fs.readdirSync(changelogDir).filter((f) => f.endsWith(".mdx"));
+
+  const versions = files
+    .map((f) => {
+      const filePath = path.join(changelogDir, f);
+      const content = fs.readFileSync(filePath, "utf-8");
+      const titleMatch = content.match(/^title:\s*["']?([^"'\n]+)["']?/m);


The sidebar generation reads and parses every changelog file synchronously during config evaluation. With many changelog entries this can noticeably slow npm run dev startup and rebuilds. Consider generating this list from filenames only, caching results, or using a frontmatter parser with a fast partial read (e.g., read only the frontmatter block) rather than readFileSync for full file contents.

Copilot · 2026-02-18T20:39:48Z

astro.config.mjs

+function getComponentItems() {
+  const componentsDir = path.join(__dirname, "src/content/docs/components");
+  const entries = fs.readdirSync(componentsDir, { withFileTypes: true });
+  const items = [];
+
+  for (const entry of entries) {
+    if (entry.name === "images" || entry.name === "index.mdx") continue;
+
+    if (entry.isFile() && entry.name.endsWith(".mdx")) {
+      const filePath = path.join(componentsDir, entry.name);
+      const content = fs.readFileSync(filePath, "utf-8");
+      const titleMatch = content.match(/^title:\s*["']?([^"'\n]+)["']?/m);


Similar to changelogs, generating the full components sidebar by synchronously reading every MDX file can become a bottleneck (the components directory is typically large). If you need titles, consider a pre-generated index (built once and committed), or a content-collection-driven approach that avoids full-file sync reads on startup.

Copilot · 2026-02-18T20:39:48Z

astro.config.mjs

+    .map((f) => {
+      const filePath = path.join(changelogDir, f);
+      const content = fs.readFileSync(filePath, "utf-8");
+      const titleMatch = content.match(/^title:\s*["']?([^"'\n]+)["']?/m);


The title: extraction uses a regex over the entire file and isn’t scoped to frontmatter. If a file ever lacks a frontmatter title (or the frontmatter is malformed), the regex can accidentally match title: inside a code block or example and produce an incorrect sidebar label. Using a frontmatter parser (e.g., gray-matter) or restricting the search to the first frontmatter block would make this more robust.

Copilot · 2026-02-18T20:39:48Z

README.md

+```jsx
+<Image src="/images/shared-image.jpg" alt="Description" layout="constrained" />


This example suggests using astro:assets’ Image component with a /public absolute path. In Astro, images in public/ are typically referenced via standard <img>/Markdown, while Image is generally used with imported assets (or configured remote sources) for optimization. To avoid readers copying a pattern that may not work or won’t be optimized, update this example to either (a) use an <img src=\"/images/...\">/Markdown image, or (b) show importing the image so it’s processed by the asset pipeline.

Suggested change

```jsx

<Image src="/images/shared-image.jpg" alt="Description" layout="constrained" />

```html

<img src="/images/shared-image.jpg" alt="Description" />

Copilot · 2026-02-18T20:39:48Z

.claude/instructions.md

+   - Reference using absolute path

-Examples:
-```markdown
-![Debug output](debug.png)
+   ```mdx
+   <Image src="/images/shared-image.jpg" alt="Description" layout="constrained" />
+   ```
+


This repeats the guidance to use astro:assets Image with /public/images/... paths. If the project expects public images to be used via <img>/Markdown (and only imported images to use Image), the instructions should reflect that to prevent contributors from introducing non-working or non-optimized image markup.

Suggested change

- Reference using absolute path

Examples:

```markdown

![Debug output](debug.png)

```mdx

<Image src="/images/shared-image.jpg" alt="Description" layout="constrained" />

```

- Reference using an absolute path in Markdown or HTML

- **Do NOT** use `astro:assets` `Image` for `/public` images; use standard Markdown or `<img>` instead

```markdown

![Description](/images/shared-image.jpg)

or, if you need HTML:

<img src="/images/shared-image.jpg" alt="Description">

Copilot · 2026-02-18T20:39:49Z

.github/workflows/ci.yml

+      - name: Set up Node.js
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0


The inline version comment # v6.2.0 appears incorrect for actions/setup-node (and can cause confusion during dependency/security audits). Since the action is pinned by SHA, consider either updating the comment to the correct tag version for that SHA or removing the tag comment entirely.

netlify · 2026-02-18T20:41:30Z

✅ Deploy Preview for esphome ready!

Name	Link
🔨 Latest commit	`c8412e5`
🔍 Latest deploy log	https://app.netlify.com/projects/esphome/deploys/6996231648305c0008040a20
😎 Deploy Preview	https://deploy-preview-6114--esphome.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

swoboda1337 and others added 30 commits January 14, 2026 09:19

Bump version to 2026.2.0-dev

a01ba93

Merge branch 'beta' into next

c8aee5f

Update changelog for 2026.1.0 (#5919)

4c2e2d8

Add OTA update callout to 2026.1 release notes (#5920)

54a99bd

Co-authored-by: J. Nick Koston <[email protected]>

Update web_server and captive_portal compression default to gzip (#5924)

64421b2

[mipi_dsi] add Guition JC8012P4A1 (#5922)

05d133b

[select] Document select.is condition (#5928)

1accab6

[hub75] Update scan enum values (#5923)

0ecd066

* [hub75] Update scan enum values * add SCAN_1_8_40PX_HIGH

Bump version to 2026.1.0b2

b6af5cd

Replace "name" key for display color with "id" key in docs (#5927)

dbc1b17

This one entry in the docs has a "name" key for a color, but this appears to be mistaken; every other entry has "id", and "id" appears to be correct.

Update changelog for 2025.12.7

a61e949

Update supporters for 2025.12.7

1bad0db

Update changelog for 2026.1.0b2

7e2a59e

Merge branch 'beta' into next

2a0ff5b

Add reference to water heater template documentation (#5953)

c7391da

* Add reference to water heater template documentation * Remove empty line in water heater index file

[mipi_spi] Add docs for CYD variants (#5947)

d480060

[status] Document update_interval option (#5943)

ae37686

[debug] Document min_free sensor and ESP32 fragmentation support (#5921)

4e016fc

Merge branch 'beta' into next

483ccec

Describe the max_delta filter (#5807)

a47e56f

Co-authored-by: clydebarrow <[email protected]>

Merge branch 'current' into next

bd332d1

[heatpumpir] Add ESP-IDF framework support to docs (#5959)

2e2e160

[nextion] Add configurable startup and queue timeout constants (#5454)

f79591f

Co-authored-by: Keith Burzinski <[email protected]>

[mipi_dsi] add M5Stack-Tab5-V2 model (#5677)

823e08d

Co-authored-by: Clyde Stubbs <[email protected]> Co-authored-by: dcgrove <[email protected]>

[bthome_mithermometer] add encrypted beacon support (#5961)

0032448

[sensor] Update clamp filter docs (#5966)

a3247d8

swoboda1337 and others added 23 commits February 17, 2026 13:24

[combination] Fix 'coeffecient' typo to 'coefficient' in docs (#6087)

c33474d

Co-authored-by: Claude Opus 4.6 <[email protected]>

Bump version to 2026.2.0b3

926125d

Update changelog for 2026.2.0b3

548d463

Update supporters for 2026.2.0b3

7bebbb3

Merge pull request #6100 from esphome/bump-2026.2.0b3

84ad5ec

2026.2.0b3

[sensor] Add filter headings to table of contents (#6102)

5118842

Co-authored-by: Claude Opus 4.6 <[email protected]>

Remove Hugo leftovers and update dev tooling for Starlight (#6078)

d1545f9

Co-authored-by: Claude Opus 4.6 <[email protected]>

Remove Docker development environment (#6103)

b45792b

Co-authored-by: Claude Opus 4.6 <[email protected]>

Remove dangling postCreate.sh file (#6105)

0bedfca

Remove assets symlink (#6106)

aceca57

Auto-generate All Actions/Conditions lists from doc headings (#6107)

44390ae

Co-authored-by: Claude Opus 4.6 <[email protected]>

[docs] Add linter check for automation headings and fix sprinkler (#6109

bd4b236

) Co-authored-by: Claude Opus 4.6 <[email protected]>

Bump version to 2026.2.0b4

e4d9548

Update changelog for 2026.2.0b4

8a5e31e

Update supporters for 2026.2.0b4

aac346d

Merge pull request #6110 from esphome/bump-2026.2.0b4

80f99a5

2026.2.0b4

Link domain names to component pages in automation lists (#6111)

d7b50a3

Co-authored-by: Claude Opus 4.6 <[email protected]>

Bump version to 2026.2.0b5

b3bb375

Update changelog for 2026.2.0b5

2d73afe

Update supporters for 2026.2.0b5

9a816f3

Merge pull request #6113 from esphome/bump-2026.2.0b5

8c43d5a

2026.2.0b5

Bump version to 2026.2.0

f4362e6

Update changelog for 2026.2.0

c8412e5

Copilot AI review requested due to automatic review settings February 18, 2026 20:37

esphome bot added the current label Feb 18, 2026

Copilot AI reviewed Feb 18, 2026

View reviewed changes

jesserockz merged commit 0051110 into current Feb 18, 2026
6 checks passed

jesserockz deleted the bump-2026.2.0 branch February 18, 2026 22:41

github-actions bot locked and limited conversation to collaborators Feb 20, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

2026.2.0#6114

2026.2.0#6114
jesserockz merged 116 commits intocurrentfrom
bump-2026.2.0

jesserockz commented Feb 18, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Feb 18, 2026

Uh oh!

Copilot AI Feb 18, 2026

Uh oh!

Copilot AI Feb 18, 2026

Uh oh!

Copilot AI Feb 18, 2026

Uh oh!

Copilot AI Feb 18, 2026

Uh oh!

Copilot AI Feb 18, 2026

Uh oh!

Copilot AI Feb 18, 2026

Uh oh!

netlify bot commented Feb 18, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

20 participants

		```jsx
		<Image src="/images/shared-image.jpg" alt="Description" layout="constrained" />

		- name: Set up Node.js
		uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0

Uh oh!

Conversation

jesserockz commented Feb 18, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

netlify bot commented Feb 18, 2026

✅ Deploy Preview for esphome ready!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

20 participants