Need help with esp8266-iot-framework?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

227 Stars 59 Forks GNU General Public License v3.0 247 Commits 4 Opened issues


Framework for IoT projects implementing HTTPS requests, a React web interface, WiFi manager, live dashboard, configuration manager, file manager and OTA updates.

Services available


Need anything else?

Contributors list

ESP8266 IoT Framework Status

The ESP8266 IoT Framework is a set of modules to be used as a starting point in new ESP8266 projects, implementing HTTPS requests, a React web interface, WiFi manager, configuration manager, live dashboard and OTA updates.

The unique advantage of this framework is that code generation at build time is used to provide different benefits. Code generation is used to dynamically generate a configuration struct and a live dashboard from JSON files, to incorporate the web interface into PROGMEM in the firmware and to bundle a full root certificate store in PROGMEM that allows the ESP8266 to do secure HTTPS requests to arbitrary URLs.


Details beyond the documentation can be found at

Featured projects

I would love to showcase some cool projects here that are based on this framework. Would you like to be featured with a picture and a link? contact me!

Quick start

If you are new to PlatformIO, start with the installation guide. Otherwise, simply start a new project for your ESP8266, and add the following line to your

lib_deps = ESP8266 IoT Framework

Take one of the examples as a starting point to develop your application.






The framework consists of five main parts. A web server including the interface it's serving, a WiFi manager, a configuration manager and classes for HTTP requests and OTA updates. The architecture of the framework is shown in the following diagram:

Architecture Architecture of the framework shown in blue

The basic principles used in developing this framework are:

  1. The framework is built upon the ESP8266 Arduino libraries
  2. The framework does not include any functionality to control external hardware.
  3. The framework is fully self-contained for easy deployment. SPIFFS/LittleFS storage is not needed.
  4. There is a strict split between the ESP8266 application and the web interface through an API.

In short, the framework aims to be unobtrusive, easy to deploy, with a modern web interface that's easy to modify and expand for different projects :).

Note: The ESP32 is not supported by this framework right now, due to the reliance on BearSSL. BearSSL is part of the ESP8266 Arduino libraries, but not part of the ESP32 Arduino libraries. Also, many functionalities of this framework are supported by ESP-IDF for the ESP32. Therefore my recommendation would be to use ESP-IDF and I don't see enough added value in porting this framework.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.