ESP32 WiFi Template with Qwen3-Coder

A production-ready ESP32 IDF project template featuring WiFi configuration, LittleFS filesystem, WebSocket communication, and a modern SvelteKit frontend. Integrated with Qwen3-Coder via Aider for AI-assisted embedded development.

What This Skill Does

This skill configures an Aider project for ESP32 embedded development with Qwen3-Coder as your AI coding assistant. It provides a complete starter template with WiFi management, file system storage, real-time WebSocket communication, and a reactive web interface—ideal for IoT applications requiring configuration portals or remote control.

Instructions for AI Agent

When a user requests to use this skill, follow these steps:

1. **Verify Prerequisites**

- Confirm ESP-IDF is installed and configured

- Check that Aider CLI is available in the environment

- Verify `QWEN3_API_KEY` environment variable is set or prompt user to provide it

2. **Create Project Directory**

- Create a new directory for the ESP32 project

- Initialize a Git repository (required by Aider)

3. **Generate Aider Configuration**

- Create `.aider.conf.yaml` in the project root with the following structure:

```yaml

version: 1

project:

name: wifi_config_qwen_template

description: >-

ESP32 IDF Wi-Fi + LittleFS + WebSocket template with SvelteKit frontend

and Qwen3-Coder integration.

plugins:

qwen3:

api_key: ${QWEN3_API_KEY}

```

4. **Initialize ESP32 Project Structure**

- Create standard ESP-IDF directory structure:

- `main/` - C source files for ESP32

- `components/` - Reusable components (WiFi manager, WebSocket server, LittleFS wrapper)

- `frontend/` - SvelteKit application

- `CMakeLists.txt` - Build configuration

- `sdkconfig.defaults` - ESP32 SDK defaults

5. **Scaffold Core Components**

- WiFi configuration manager with AP/STA modes

- LittleFS integration for persistent storage

- WebSocket server for real-time communication

- Basic SvelteKit frontend with WiFi config UI

6. **Configure Aider Session**

- Launch Aider with Qwen3-Coder model: `aider --model qwen/qwen3-coder`

- Add relevant files to Aider's context:

- `main/main.c`

- `main/wifi_manager.c`

- `main/websocket_server.c`

- `frontend/src/routes/+page.svelte`

7. **Provide User Guidance**

- Explain how to modify WiFi credentials

- Show how to add custom WebSocket message handlers

- Document the build process: `idf.py build`, `idf.py flash`

- Demonstrate how to use Aider for iterative development:

- Adding new features

- Debugging issues

- Refactoring code with AI assistance

8. **Example Usage Scenarios**

- "Add MQTT client to publish sensor data"

- "Implement OTA firmware update via WebSocket"

- "Create a configuration page for device settings"

- "Debug WiFi connection stability issues"

Constraints and Notes

Example Commands

```bash

Set up environment

export QWEN3_API_KEY="your_api_key_here"

Create and initialize project

mkdir my-esp32-project && cd my-esp32-project

git init

aider --model qwen/qwen3-coder

Inside Aider session

/add main/main.c

/add main/wifi_manager.c

/ask "Add a WebSocket command to read temperature from DHT22 sensor"

```