A customizable captive portal implementation for ESP32 using AsyncWebServer and LittleFS. When devices connect to the ESP32's WiFi access point, they are automatically presented with a captive portal interface.

• ✨ Automatic captive portal detection on client devices
• 🌐 Custom landing page (captive.html)
• 📱 Responsive web interface
• 💾 File system based content using LittleFS
• ⚡ Async web server for better performance

• PlatformIO installed
• ESP32 development board
• USB cable
• Visual Studio Code (recommended)

1. Clone this repository:

   git clone https://github.com/luanphamng/esp-captive-portal.git
   cd esp-captive-portal

2. Open the project in PlatformIO:

   • Open VS Code
   • Install PlatformIO extension if you haven't
   • Click "Open Project" and select the esp-captive-portal folder

1. Build the project:

   pio run

2. Upload the filesystem:

   pio run -t uploadfs

3. Upload the firmware:

   pio run -t upload

esp-captive-portal/
├── src/                 # Source files
│   └── main.cpp        # Main application code
├── data/               # Web content files
│   ├── captive.html    # Initial captive portal page
│   ├── index.html      # Main application page
│   ├── notifications.css
│   ├── notifications.js
│   └── assets/         # Static assets
│       ├── css/
│       └── js/
└── platformio.ini      # PlatformIO configuration

The project uses platformio.ini for build configuration:

• LittleFS for file system
• ESP32 board settings
• Required libraries
• Debug settings

If you can't flash on Ubuntu/Linux, set the correct permissions:

sudo chmod 777 /dev/ttyUSB0  # Replace ttyUSB0 with your port

If you encounter "build_command.json" errors:

1. Delete the output/build_command.json file
2. Rebuild the project

• If the portal doesn't appear, try clearing your device's network cache
• Make sure all files are properly uploaded to LittleFS
• Check serial monitor for debugging information

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request

This project is licensed under the MIT License - see the LICENSE file for details

• ESPAsyncWebServer
• AsyncTCP
• ESP32 Community