⚡ Lightweight • 🔌 Plug & Play • 📡 Smart Connectivity • 🧠 Self-Healing Network Engine

Professional-grade WiFi management library for ESP8266 IoT systems with automatic fallback, captive portal configuration, and persistent network memory.

⚡ Overview

ViraWM is a professional-grade WiFi management library for ESP8266 designed by ViraMedar (Mostafa MirMousavi).

It removes the complexity of WiFi configuration and replaces it with a smart, self-healing connection system.

✨ Key Features

✔ Captive Portal WiFi Setup (Browser-based)
✔ Static IP / DHCP Switching
✔ EEPROM Persistent Storage
✔ Auto AP Fallback System
✔ One-line AutoConnect API
✔ WiFi Profile Reset (Factory Reset)
✔ Lightweight ESP8266 Optimized

🧠 Smart Connection Engine

At startup, ViraWM automatically decides the best connection strategy:

🔵 Normal Mode (Saved Credentials Found)

✔ Connects automatically to saved WiFi
✔ Applies Static IP (if enabled)

---

Static IP Configuration Panel
_{Part of ViraWM Captive Portal UI}

---

✔ Restores previous network state
✔ Runs in STA mode

🔴 Recovery Mode (No WiFi / Failed Connection)

✔ Switches to Access Point (AP) mode

✔ Starts configuration portal

✔ Allows WiFi setup via browser

✔ Saves configuration to EEPROM

📡 AP Configuration Portal

When the device enters setup mode, it creates a WiFi network:

📶 Vira WiFiManager Configuration

📲 User Flow:

Connect with phone or laptop

Open browser

Configure WiFi settings:

SSID 📡

Password 🔐

Static IP (optional) 🌐

Subnet Mask 🧩

Gateway 🚪

Save & reboot automatically

🌐 Static IP System

ViraWM supports full network manual configuration:

✔ Available Settings

IP Address

Subnet Mask

Gateway

🔄 Modes:

Static Mode: Manual network control

DHCP Mode: Automatic IP assignment

🧹 WiFi Profile Reset

You can fully reset stored network credentials anytime:

wifiManager.clearWiFiProfile(true);

What happens:

🧹 Erases saved SSID & Password

💾 Clears EEPROM storage

🔄 Forces AP Mode on next boot

---

📦 Installation

1️⃣ Download Library

Clone or download repository

2️⃣ Install

Copy folder to:
Documents/Arduino/libraries/ViraWM

3️⃣ Restart Arduino IDE

Done ✔

---

🔧 Basic Example

#include <WiFiClient.h>
#include <ViraWM.h>
#include <EEPROM.h>

#define BAUD_RATE 115200
#define Server_Port 80

ESP8266WebServer server(Server_Port);

void setup() {
  EEPROM.begin(512);
  Serial.begin(BAUD_RATE);
  delay(100);

  ViraWM wifiManager;

  // Auto connect or start AP portal
  wifiManager.autoConnect("Vira WiFiManager Configuration");

  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }

  Serial.println();
  Serial.println("IP address: " + WiFi.localIP().toString());

  server.begin();
  Serial.println("HTTP server started");
}

void loop() {
  // Your code here
}

🔄 How It Works

┌───────────────┐
│   ESP Boots   │
└──────┬────────┘
       │
       ▼
┌──────────────────────┐
│ Read EEPROM Config   │
└──────┬───────────────┘
       │
       ▼
┌──────────────────────┐
│ Credentials Exists ?  │
└──────┬───────────────┘
   YES │            NO
       ▼              ▼
┌──────────────┐   ┌──────────────────┐
│ Connect WiFi │   │  Start AP Mode   │
└──────┬───────┘   └──────┬───────────┘
       │                  │
       ▼                  ▼
┌──────────────┐   ┌──────────────────┐
│ Connection OK│   │ Captive Portal   │
└──────┬───────┘   └──────┬───────────┘
       │                  │
   YES │              User Config
       ▼                  │
┌──────────────┐         ▼
│ STA MODE RUN │   ┌──────────────────┐
│ NORMAL STATE  │   │ Save to EEPROM   │
└──────────────┘   └──────┬───────────┘
                           │
                           ▼
                    ┌──────────────┐
                    │ Auto Reboot  │
                    └──────┬───────┘
                           │
                           ▼
                    ┌──────────────┐
                    │ Reconnect STA│
                    └──────────────┘

🛠 Feature Highlights

⚡ Fast AutoConnect Engine

Instant connection with stored credentials

📡 Captive Portal UI

Browser-based WiFi setup (no app needed)

💾 EEPROM Persistence

WiFi credentials saved permanently in flash memory

🌐 Static IP + DHCP Support

Switch between manual IP and automatic network config

🔄 Auto AP Fallback System

Automatically enters AP mode if connection fails

🧹 WiFi Profile Reset

Clean stored credentials anytime with one function

📶 ESP8266 Optimized Stability

Designed for long-running IoT and embedded systems

---

👨‍💻 Author

Mostafa MirMousavi (@admin3314)

• GitHub: https://github.com/admin3314
• YouTube: https://youtube.com/@viramedar
• Instagram: https://instagram.com/viramedar
• Telegram Channel: https://t.me/viramedar
• Personal Telegram: https://t.me/viraep

---

📚 Tutorials & Files

• 📺 Full tutorials: https://youtube.com/@viramedar
• 📦 PCB, schematics, and project files available on Telegram : T.me/ViraMedar

---

📜 License

MIT License

This project is released under a commercial-friendly custom license by ViraMedar.

---

⭐ Future Plans

ESP32 support

Web dashboard upgrade

JSON configuration API

OTA update integration

Multi-device provisioning

---

💬 Notes

This library is optimized for:

IoT projects

Smart home systems

ESP8266 automation

Industrial embedded systems