Skip to content

A Lit Element web component frontend for the ESPHome web_server.

License

Notifications You must be signed in to change notification settings

afarago/esphome-webserver

 
 

Repository files navigation

esphome-webserver

A Lit Element web component htm webserver for esphome devices.

Features

  • 30 sec heartbeat showing node connection is active
  • Built with Lit Element web components
  • completely standalone - no other external dependancies 9K compressed
  • Light and Dark themes
  • Primary theme - currently light blue - can be overridden
  • Embedded ESP home logo svg
  • Entities are discovered and display
  • No css fetch - index page fetches one js file

dark scheme desktop:

web_server-v2

Light scheme on mobile:

image

Near future:

  • Support for compressed files in flash for Standalone no internet nodes
  • Add Climate
  • Add Select drop list
  • Add Number editing
  • Potentially use an optional card layout instead of a table

Example entry for config.yaml:

# Example config.yaml

web_server:
  port: 80
  css_url: ""
  js_url: https://esphome.io/_static/v2/www.js
  version: 2

development

git clone https://github.com/esphome/esphome-webserver.git
pnpm install

npm run start Starts a dev server on https://localhost:3000

proxy

Events from a real device can be proxied for developement. Update this line in vite.config.ts to point to your real device

const proxy_target = "https://nodemcu.local";

The json api will POST to the real device and the events are proxied

build

npm run build The build files are copied to static/v2 usually for deployment to https://esphome.io/static/v2 or your /local/www homeassistant folder

If you customise, you can deploy to your local homeassistant /local/www/_static/v2 and use:

web_server:
  port: 80
  version: 2
  js_url: https://homeassistant.local:8123/local/_static/v2/www.js

serve

npm run server Starts a production test server on https://localhost:5001 Events and the json api are proxied.

About

A Lit Element web component frontend for the ESPHome web_server.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 62.1%
  • CSS 29.3%
  • JavaScript 4.5%
  • HTML 2.7%
  • Other 1.4%