Skip to content

qdi-esp32 is a minimal yet functional template project designed to help you quickly build and test web-based interfaces on ESP32 boards. Ideal for prototyping and educational projects, it serves a static web UI from the ESP32 itself, with no external JavaScript libraries required.

License

Notifications You must be signed in to change notification settings

lucianovk/qdi-esp32

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

qdi-esp32 – Quick and Dirty Interface for ESP32 Prototypes

qdi-esp32Quick and Dirty Interface for ESP32 Prototypes – because sometimes you just need to get things working without overengineering. This project is a barebones template that lets your ESP32 serve up a simple web UI with minimal fuss.

Perfect for rapid prototyping, hardware hacking, or impressing your friends with a Wi-Fi-enabled LED toggle. No dependency hell – just raw HTML, a pinch of JavaScript, and your ESP32 doing what it does best.


✨ Features

  • Built-in Web Interface: Serves static HTML, CSS, and JS directly from the ESP32 using SPIFFS.
  • No External Dependencies: Pure browser-native code – because simple is sexy.
  • Wi-Fi Access Point Mode: Your ESP32 becomes its own hotspot. No router? No problem.
  • Quick and Dirty by Design: Get it running fast, tweak as you go, and clean it up later (or not).

🚀 Getting Started

  1. Install Tools:

  2. Clone the Repository:

    git clone https://github.com/lucianovk/qdi-esp32.git
  3. Open the Project in VSCode

  4. Select Your Board in PlatformIO under PIO Home → Projects & Configuration.

  5. Upload the Web Files and Firmware:

    • Build File System Image
    • Upload File System Image
    • Build firmware
    • Upload firmware
  6. Connect to the ESP32 Wi-Fi:

    • SSID: qdi-esp32
    • Password: 12345678
  7. Access the Web Interface:


🖼️ UI Preview

Below is a screenshot of the web interface served by the ESP32:

Web UI Screenshot


📁 Project Structure

  • src/: Main ESP32 application code
  • data/: Static website (HTML, CSS, JS) to be served from SPIFFS
  • platformio.ini: PlatformIO build configuration
  • qdi-screenshot.png: UI preview image

📜 License

This project is released under the Creative Commons Zero v1.0 Universal license (CC0-1.0), placing it in the public domain.

About

qdi-esp32 is a minimal yet functional template project designed to help you quickly build and test web-based interfaces on ESP32 boards. Ideal for prototyping and educational projects, it serves a static web UI from the ESP32 itself, with no external JavaScript libraries required.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published