ESPHome Devices

A database of configuration files and guides for devices commonly flashed with https://esphome.io firmware.

Go to https://devices.esphome.io to view the website.

How To Contribute

Content on devices.esphome.io is generated by Astro with the Starlight docs theme. Pages are written in Markdown which anyone can learn. How to add a new device is documented here.

When you create a merge request, Netlify will automatically compile your proposed changes for you to preview what gets rendered. It puts a comment in the PR on Github.

Development of site

The site requires Node 20 or newer. To build locally:

# Install dependencies:
npm install
# Run a dev server so you can see your copy of the site:
npm run dev
# Open http://localhost:4321/ in your browser.

Code of Conduct

When contributing to this project please abide by our Code of Conduct

This is a an open source project, join our effort

This devices catalog is a collaborative community effort. The goal is to involve more members of the ESPHome community to more actively update the devices! Please submit a PR that adds or modifies a device if you are interested! See this guide for adding devices: https://devices.esphome.io/adding-devices.