Skip to content

Merge request branch dev into main via CloudCannon #831

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
cloudcannon merged 2 commits into from
May 19, 2026
Merged

Merge request branch dev into main via CloudCannon #831

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
100d719
Updated 1 file via CloudCannon.
Bunton33 May 19, 2026
9cd1310
Updated 1 file via CloudCannon.
Bunton33 May 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 8 additions & 7 deletions docs/products/ESPHome-Starter-Kit/setup/first-steps-sg.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
---
title: First steps with the ESPHome Starter Kit
description: Install ESPHome Device Builder, write your first ESPHome config for the starter kit, and flash the ESP32-C6 over USB.
description: >-
Install ESPHome Device Builder, write your first ESPHome config for the
starter kit, and flash the ESP32-C6 over USB.
---

This guide walks you through installing the ESPHome Device Builder app and making your first ESPHome YAML configuration from scratch. By the end, your ESPHome Starter Kit will be flashed with a working configuration, showing up in Home Assistant, and serving a web UI at its IP address or at `esphome-starter-kit.local` in a browser.

## Install ESPHome Device Builder
Expand Down Expand Up @@ -122,11 +123,11 @@ With ESPHome Device Builder installed and your Wi-Fi credentials saved, you can

1. Navigate back to the ESPHome Device Builder and click **Add new device** then click **Create new project**.

![ESPHome Device Builder Add new device dialog showing Create new project](../../../assets/device-builder-add-new-device.gif)
![ESPHome Device Builder Add new device dialog showing Create new project](../../../assets/device-builder-add-new-device.gif)

2. Select the **Apollo ESPHome Starter Kit** and give it a name such as `esphome-starter-kit`, then click **Finish Setup**.

![Selecting the Apollo ESPHome Starter Kit and naming the device esphome-starter-kit](../../../assets/device-builder-select-esk-name-it.gif)
![Selecting the Apollo ESPHome Starter Kit and naming the device esphome-starter-kit](../../../assets/device-builder-select-esk-name-it.gif)

Your starter kit now appears as a device card in the Device Builder dashboard, ready for components.

Expand Down Expand Up @@ -179,11 +180,11 @@ The device must be flashed via USB using bootloader mode the very first time it

1. Hold the sides of the ESP32-C6 and gently push the USB-C cable firmly into the USB-C port. Plug the other end of the USB-C cable into your computer. Be careful not to snap or damage the FPC ribbon cable connectors located on the sides of the device.

![Plugging the USB-C cable into the ESP32-C6 main board on the ESPHome Starter Kit](../../../assets/esphome-starter-kit-plug-in-usb-c.webp)
![Plugging the USB-C cable into the ESP32-C6 main board on the ESPHome Starter Kit](../../../assets/esphome-starter-kit-plug-in-usb-c.webp)

2. Hold down the boot button. While still holding the boot button, press and release the reset button, then release the boot button.

![Putting the ESP32-C6 into bootloader mode by holding BOOT and tapping RESET](../../../assets/esphome-starter-kit-boot-mode.webp)
![Putting the ESP32-C6 into bootloader mode by holding BOOT and tapping RESET](../../../assets/esphome-starter-kit-boot-mode.webp)

3. Your device is now in boot mode. The board will stay in bootloader mode until you flash it.

Expand Down Expand Up @@ -220,4 +221,4 @@ Here is the light changing colors.

Your ESP32-C6 is on Wi-Fi, in Home Assistant, and serving a web UI you can hit from any browser on your network. From here, every module you add becomes another entity on this same device.

<a href="../start-here/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Back - Start Here</a> <a href="../modules/button-module/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Next - Add Button Module</a>
<a href="https://wiki.apolloautomation.com/products/ESPHome-Starter-Kit/start-here/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Back - Start Here</a> <a href="../modules/button-module/" class="md-button md-button--primary"><img src="/assets/esphome-logo.svg" /> Next - Add Button Module</a>
14 changes: 6 additions & 8 deletions docs/products/ESPHome-Starter-Kit/start-here-sg.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
---
title: ESPHome Starter Kit, start here
description: Unbox the ESPHome Starter Kit, snap the modules off the panel, and meet every part of your kit before you wire it up.
description: >-
Unbox the ESPHome Starter Kit, snap the modules off the panel, and meet every
part of your kit before you wire it up.
---

Welcome to the start of your ESPHome ecosystem journey with the **Apollo ESPHome Starter Kit**.

![Apollo ESPHome Starter Kit shown with the panel of modules and the retail box](../../assets/esphome-starter-kit-exploded-with-box-1.png)
Expand All @@ -26,10 +27,7 @@ Each module is connected to the panel by small breakaway tabs. Follow the steps
1. Hold the panel flat on a table with one hand on the module you want to remove.
2. Gently flex the panel along the tab line until the tab snaps cleanly.

<video autoplay="" loop="" muted="" playsinline="" width="100%">
<source src="/assets/ESPHome_Starter_Kit_Break_Apart_Modules.mp4" type="video/mp4" /><p></p><p></p><p></p><p></p><p></p><p></p><p></p><p></p><p></p><p></p>
Your browser does not support embedded video.
</video>
![](../../assets/esphome-starter-kit-disassembly-final.gif)

Once every module is off the panel, lay them out so you can see what you have before plugging anything in.

Expand All @@ -45,7 +43,7 @@ The brain of every project you'll build with the kit. It handles Wi-Fi and Bluet

The starter kit's notification module, a strip of ten addressable RGB LEDs and a small piezo buzzer behind the ESPHome logo silkscreen. Use the included stand to show it off on a shelf or desk.

![ESPHome Starter Kit LED & Buzzer module with the ESPHome logo silkscreen](../../assets/esphome-starter-kit-rgb-buzzer-module-only.jpg)
![ESPHome Starter Kit LED &amp; Buzzer module with the ESPHome logo silkscreen](../../assets/esphome-starter-kit-rgb-buzzer-module-only.jpg)

### Motion module

Expand Down Expand Up @@ -75,4 +73,4 @@ Each module connects to the main board through an FPC connector using one of the

Once you have identified your modules and snapped them off the panel, the next step is to connect the main board to your computer and walk through your first ESPHome configuration.

<a href="../setup/first-steps/" class="md-button md-button--primary"> <img src="/assets/esphome-logo.svg" /> Next - First Steps </a>
<a href="../setup/first-steps/" class="md-button md-button--primary"> <img src="/assets/esphome-logo.svg" /> Next - First Steps </a>