# ESP WiFi Config

> WiFi configuration component for ESP-IDF with multi-network support, auto-reconnect, SoftAP captive portal, Web UI, CLI, BLE GATT, Improv WiFi, and REST API.

## Links

- Documentation: https://configwifi.com/docs
- GitHub: https://github.com/thorrak/esp_wifi_config
- ESP Component Registry: https://components.espressif.com/components/thorrak/esp_wifi_config
- Full AI-readable docs: https://configwifi.com/llms-full.txt

## Table of Contents

- [Overview](https://configwifi.com/docs): ESP WiFi Config — WiFi configuration component for ESP-IDF with multi-network support, auto-reconnect, and provisioning interfaces
- [Getting Started](https://configwifi.com/docs/getting-started): Install and configure ESP WiFi Config in your ESP-IDF project
- [AI Integration Guide](https://configwifi.com/docs/ai-integration-guide): For AI coding assistants — structured questionnaire and code generation recipes for integrating ESP WiFi Config
- [Multi-Network & Auto-Reconnect](https://configwifi.com/docs/guides/multi-network): Configure multiple WiFi networks with priority-based failover and exponential backoff
- [Custom Variables](https://configwifi.com/docs/guides/custom-variables): Store and retrieve application key-value settings via NVS
- [esp_bus Events](https://configwifi.com/docs/guides/esp-bus-events): Event-driven architecture — subscribing to WiFi events and using actions
- [HTTP Server Sharing](https://configwifi.com/docs/guides/http-server-sharing): Share the HTTP server handle with your application for custom endpoints
- [Provisioning Modes](https://configwifi.com/docs/provisioning/modes): Control when and how provisioning interfaces activate — ALWAYS, ON_FAILURE, WHEN_UNPROVISIONED, MANUAL
- [SoftAP & Captive Portal](https://configwifi.com/docs/provisioning/softap-captive-portal): Configure WiFi via the built-in SoftAP captive portal and Web UI
- [BLE Provisioning](https://configwifi.com/docs/provisioning/ble-gatt): Provision Wi-Fi over BLE using ESP-IDF's official Wi-Fi Provisioning manager
- [Improv WiFi](https://configwifi.com/docs/provisioning/improv-wifi): Open-standard provisioning via Web Bluetooth and Web Serial
- [C API Reference](https://configwifi.com/docs/api/c-api): Complete C API reference — initialization, status, network management, SoftAP, variables
- [REST API Reference](https://configwifi.com/docs/api/rest-api): HTTP REST API endpoints for remote WiFi configuration
- [BLE Protocol Reference](https://configwifi.com/docs/api/ble-protocol): ESP-IDF Network Provisioning protocol used over BLE, plus custom protocomm endpoints
- [CLI Commands](https://configwifi.com/docs/api/cli-commands): Serial console commands for WiFi configuration
- [Kconfig Options](https://configwifi.com/docs/api/kconfig): Compile-time configuration options via menuconfig
- [Examples](https://configwifi.com/docs/examples): Complete example projects demonstrating different feature combinations