micropidash 1.0.0__tar.gz

micropidash-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kritish
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

micropidash-1.0.0/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.1
+Name: micropidash
+Version: 1.0.0
+Summary: A lightweight web dashboard for MicroPython (ESP32, Pico W)
+Home-page: https://github.com/kritishmohapatra/micropidash
+Author: Kritish Mohapatra
+Author-email: kritishmohapatra06norisk@gmail.com
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# 🚀 micropidash: Lightweight MicroPython IoT Dashboard
+
+**micropidash** is a high-performance, asynchronous web dashboard library specifically designed for microcontrollers like the **Raspberry Pi Pico 2W** (RP2350/RP2040) and ESP32. It enables the creation of real-time, responsive web interfaces for IoT projects using minimal MicroPython code.
+
+<p align="center">
+  <a href="https://micropython.org/"><img src="https://img.shields.io/badge/MicroPython-✓-green?logo=micropython&logoColor=white" alt="MicroPython"></a>
+  <a href="https://www.espressif.com/en/products/socs/esp32"><img src="https://img.shields.io/badge/ESP32-Supported-orange?logo=espressif&logoColor=white" alt="ESP32"></a>
+  <a href="https://www.raspberrypi.com/products/raspberry-pi-pico/"><img src="https://img.shields.io/badge/Raspberry%20Pi%20Pico%20 2 W-Compatible-darkgreen?logo=raspberrypi&logoColor=white" alt="Pico 2 W"></a>
+  <a href="https://github.com/kritishmohapatra/micropython-sevenseg/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?logo=open-source-initiative&logoColor=white" alt="License"></a>
+
+  
+</p>
+
+**Author:** [Kritish Mohapatra]  
+
+
+---
+
+## ✨ Key Features
+* **Asynchronous Engine:** Built on `uasyncio` for non-blocking, multi-tasking performance.
+* **Real-Time Sync:** AJAX-based polling ensures all connected devices (Mobile & Laptop) stay synced without page refreshes.
+* **Client-Side Theming:** Every connected user can independently toggle between Dark and Light modes.
+* **Order Preservation:** Uses alphabetical sorting for widget IDs to ensure your layout stays exactly as intended.
+* **Memory Efficient:** Optimized for devices with limited RAM, featuring chunked data transmission and frequent garbage collection.
+
+---
+
+## 📦 Installation
+
+1. Upload `micropidash.py` to your microcontroller's root directory.
+2. Create a `main.py` file to implement your project logic.
+3. Ensure your device is connected to a stable 2.4GHz Wi-Fi network.
+
+---
+## 📂 Project Structure
+    ├── micropidash/
+    │ ├── init.py
+    │ └── micropidash.py 
+    │
+    ├── examples/
+    |  ├── basic_1.py
+    │  └── esp_32_example.py 
+    │
+    ├── README.md
+    └── LICENSE
+## 📚 API Documentation
+
+### `Dashboard(title)`
+Creates a new dashboard instance with the specified title.
+* **title**: (String) The name displayed at the top of your web dashboard.
+
+---
+
+### `add_toggle(id, label)`
+Adds a binary switch (On/Off) to the dashboard.
+* **id**: (String) Unique identifier for the widget. Also used for alphabetical sorting on the UI.
+* **label**: (String) The text displayed above the switch.
+
+---
+
+### `add_label(id, label)`
+Adds a text box designed for displaying live sensor data or status strings.
+* **id**: (String) Unique identifier for the widget.
+* **label**: (String) The descriptive text for the data being shown.
+
+---
+
+### `add_level(id, label, color)`
+Adds a graphical progress bar, perfect for humidity, tank levels, or battery percentage.
+* **id**: (String) Unique identifier for the widget.
+* **label**: (String) The descriptive text for the progress bar.
+* **color**: (Hex/CSS Color) The color of the fill bar (e.g., `#2196F3` or `red`).
+* **Value Range**: Expects an integer between $0$ and $100$.
+
+---
+
+### `update_value(id, value)`
+Injects new data into an existing widget. This change is pushed instantly to all connected web clients via the next poll.
+* **id**: (String) The ID of the widget you want to update.
+* **value**: (String/Int) The new data to display.
+
+---
+## 🚀 Quick Start (Simple Example)
+
+Use this minimal example to test your connection and ensure the dashboard is being served correctly on your local network.
+
+```python
+from micropidash import Dashboard
+import network 
+
+# 1. WiFi Setup
+wlan = network.WLAN(network.STA_IF)
+wlan.active(True)
+
+wlan.connect('YOUR_SSID', 'YOUR_PASSWORD')
+
+print("Connecting...")
+while not wlan.isconnected(): pass
+print("Connected! IP:", wlan.ifconfig()[0])
+
+# 2. Dashboard Initialization
+dash = Dashboard("MicroPiDash v1.0")
+
+# 3. Adding Basic Widgets
+dash.add_toggle("led", "Test Switch")      # A binary toggle
+dash.add_label("status", "System Status")  # A text display
+dash.add_level("level", "Signal Strength") # A progress bar (0-100)
+
+# 4. Start the Web Server
+# Access the dashboard via the IP address printed above
+dash.run()
+```
+
+### 🔌 ESP32 Onboard LED Example
+
+
+```python
+import machine, network, uasyncio as asyncio
+from micropidash import Dashboard
+
+# 1. ESP32 Pin Setup (Most boards use GPIO 2 for built-in LED)
+led = machine.Pin(2, machine.Pin.OUT)
+
+# 2. WiFi Connectivity
+wlan = network.WLAN(network.STA_IF)
+wlan.active(True)
+wlan.connect('YOUR_SSID', 'YOUR_PASSWORD')
+
+print("Connecting...")
+while not wlan.isconnected(): pass
+print("Server Live at IP:", wlan.ifconfig()[0])
+
+# 3. Dashboard Configuration
+dash = Dashboard("ESP32 Control Hub")
+dash.add_toggle("1_led", "Built-in LED")
+dash.add_label("2_status", "Live Status")
+
+# 4. Hardware & Web UI Sync Task
+async def sync_task():
+    while True:
+        # Dashboard UI state ko physical LED se link karna
+        led.value(dash.elements["1_led"]["value"])
+        
+        # Dashboard par status update bhejni
+        state = "GLOWING" if led.value() else "OFF"
+        dash.update_value("2_status", f"LED is {state}")
+        
+        await asyncio.sleep(0.5)
+
+# 5. Execution
+async def main():
+    asyncio.create_task(sync_task())
+    dash.run()
+
+asyncio.run(main())
+```
+## 🤝 Contributing
+As an **Electrical Engineering student**, I built **micropidash** to simplify MicroPython IoT development and bridge the gap between hardware and web interfaces. 
+
+If you find bugs, have feature ideas, or want to optimize the code further, feel free to open an **issue** or submit a **pull request**! Let's build the future of embedded systems together.
+
+---
+## 🌐 Author
+
+**Kritish Mohapatra**  
+🔗 [GitHub](https://github.com/kritishmohapatra)  
+📧 kritishmohapatra06norisk@gmail.com  
+
+✨ *Made with passion for Embedded Systems and MicroPython learners.*

micropidash-1.0.0/README.md

@@ -0,0 +1,169 @@
+# 🚀 micropidash: Lightweight MicroPython IoT Dashboard
+
+**micropidash** is a high-performance, asynchronous web dashboard library specifically designed for microcontrollers like the **Raspberry Pi Pico 2W** (RP2350/RP2040) and ESP32. It enables the creation of real-time, responsive web interfaces for IoT projects using minimal MicroPython code.
+
+<p align="center">
+  <a href="https://micropython.org/"><img src="https://img.shields.io/badge/MicroPython-✓-green?logo=micropython&logoColor=white" alt="MicroPython"></a>
+  <a href="https://www.espressif.com/en/products/socs/esp32"><img src="https://img.shields.io/badge/ESP32-Supported-orange?logo=espressif&logoColor=white" alt="ESP32"></a>
+  <a href="https://www.raspberrypi.com/products/raspberry-pi-pico/"><img src="https://img.shields.io/badge/Raspberry%20Pi%20Pico%20 2 W-Compatible-darkgreen?logo=raspberrypi&logoColor=white" alt="Pico 2 W"></a>
+  <a href="https://github.com/kritishmohapatra/micropython-sevenseg/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?logo=open-source-initiative&logoColor=white" alt="License"></a>
+
+  
+</p>
+
+**Author:** [Kritish Mohapatra]  
+
+
+---
+
+## ✨ Key Features
+* **Asynchronous Engine:** Built on `uasyncio` for non-blocking, multi-tasking performance.
+* **Real-Time Sync:** AJAX-based polling ensures all connected devices (Mobile & Laptop) stay synced without page refreshes.
+* **Client-Side Theming:** Every connected user can independently toggle between Dark and Light modes.
+* **Order Preservation:** Uses alphabetical sorting for widget IDs to ensure your layout stays exactly as intended.
+* **Memory Efficient:** Optimized for devices with limited RAM, featuring chunked data transmission and frequent garbage collection.
+
+---
+
+## 📦 Installation
+
+1. Upload `micropidash.py` to your microcontroller's root directory.
+2. Create a `main.py` file to implement your project logic.
+3. Ensure your device is connected to a stable 2.4GHz Wi-Fi network.
+
+---
+## 📂 Project Structure
+    ├── micropidash/
+    │ ├── init.py
+    │ └── micropidash.py 
+    │
+    ├── examples/
+    |  ├── basic_1.py
+    │  └── esp_32_example.py 
+    │
+    ├── README.md
+    └── LICENSE
+## 📚 API Documentation
+
+### `Dashboard(title)`
+Creates a new dashboard instance with the specified title.
+* **title**: (String) The name displayed at the top of your web dashboard.
+
+---
+
+### `add_toggle(id, label)`
+Adds a binary switch (On/Off) to the dashboard.
+* **id**: (String) Unique identifier for the widget. Also used for alphabetical sorting on the UI.
+* **label**: (String) The text displayed above the switch.
+
+---
+
+### `add_label(id, label)`
+Adds a text box designed for displaying live sensor data or status strings.
+* **id**: (String) Unique identifier for the widget.
+* **label**: (String) The descriptive text for the data being shown.
+
+---
+
+### `add_level(id, label, color)`
+Adds a graphical progress bar, perfect for humidity, tank levels, or battery percentage.
+* **id**: (String) Unique identifier for the widget.
+* **label**: (String) The descriptive text for the progress bar.
+* **color**: (Hex/CSS Color) The color of the fill bar (e.g., `#2196F3` or `red`).
+* **Value Range**: Expects an integer between $0$ and $100$.
+
+---
+
+### `update_value(id, value)`
+Injects new data into an existing widget. This change is pushed instantly to all connected web clients via the next poll.
+* **id**: (String) The ID of the widget you want to update.
+* **value**: (String/Int) The new data to display.
+
+---
+## 🚀 Quick Start (Simple Example)
+
+Use this minimal example to test your connection and ensure the dashboard is being served correctly on your local network.
+
+```python
+from micropidash import Dashboard
+import network 
+
+# 1. WiFi Setup
+wlan = network.WLAN(network.STA_IF)
+wlan.active(True)
+
+wlan.connect('YOUR_SSID', 'YOUR_PASSWORD')
+
+print("Connecting...")
+while not wlan.isconnected(): pass
+print("Connected! IP:", wlan.ifconfig()[0])
+
+# 2. Dashboard Initialization
+dash = Dashboard("MicroPiDash v1.0")
+
+# 3. Adding Basic Widgets
+dash.add_toggle("led", "Test Switch")      # A binary toggle
+dash.add_label("status", "System Status")  # A text display
+dash.add_level("level", "Signal Strength") # A progress bar (0-100)
+
+# 4. Start the Web Server
+# Access the dashboard via the IP address printed above
+dash.run()
+```
+
+### 🔌 ESP32 Onboard LED Example
+
+
+```python
+import machine, network, uasyncio as asyncio
+from micropidash import Dashboard
+
+# 1. ESP32 Pin Setup (Most boards use GPIO 2 for built-in LED)
+led = machine.Pin(2, machine.Pin.OUT)
+
+# 2. WiFi Connectivity
+wlan = network.WLAN(network.STA_IF)
+wlan.active(True)
+wlan.connect('YOUR_SSID', 'YOUR_PASSWORD')
+
+print("Connecting...")
+while not wlan.isconnected(): pass
+print("Server Live at IP:", wlan.ifconfig()[0])
+
+# 3. Dashboard Configuration
+dash = Dashboard("ESP32 Control Hub")
+dash.add_toggle("1_led", "Built-in LED")
+dash.add_label("2_status", "Live Status")
+
+# 4. Hardware & Web UI Sync Task
+async def sync_task():
+    while True:
+        # Dashboard UI state ko physical LED se link karna
+        led.value(dash.elements["1_led"]["value"])
+        
+        # Dashboard par status update bhejni
+        state = "GLOWING" if led.value() else "OFF"
+        dash.update_value("2_status", f"LED is {state}")
+        
+        await asyncio.sleep(0.5)
+
+# 5. Execution
+async def main():
+    asyncio.create_task(sync_task())
+    dash.run()
+
+asyncio.run(main())
+```
+## 🤝 Contributing
+As an **Electrical Engineering student**, I built **micropidash** to simplify MicroPython IoT development and bridge the gap between hardware and web interfaces. 
+
+If you find bugs, have feature ideas, or want to optimize the code further, feel free to open an **issue** or submit a **pull request**! Let's build the future of embedded systems together.
+
+---
+## 🌐 Author
+
+**Kritish Mohapatra**  
+🔗 [GitHub](https://github.com/kritishmohapatra)  
+📧 kritishmohapatra06norisk@gmail.com  
+
+✨ *Made with passion for Embedded Systems and MicroPython learners.*

micropidash-1.0.0/micropidash/__init__.py

@@ -0,0 +1,8 @@
+# micropidash MicroPython Library
+# Author: Kritish Mohapatra
+# Year: 2026
+
+from .micropidash import Dashboard
+
+__all__ = ["Dashboard"]
+__version__ = "1.0.0"

micropidash-1.0.0/micropidash/micropidash.py

@@ -0,0 +1,192 @@
+import uasyncio as asyncio
+import json, gc
+
+class Dashboard:
+    def __init__(self, title="Pi IoT Lab"):
+        self.title = title
+        self.elements = {}
+
+    def add_toggle(self, id, label):
+        self.elements[id] = {"type": "toggle", "label": label, "value": 0}
+
+    def add_label(self, id, label):
+        self.elements[id] = {"type": "label", "label": label, "value": "---"}
+
+    def add_level(self, id, label, color="#4CAF50"):
+        self.elements[id] = {"type": "level", "label": label, "value": 0, "color": color}
+
+    def update_value(self, id, value):
+        if id in self.elements:
+            self.elements[id]["value"] = value
+
+    async def _send_html(self, writer):
+        # Header + CSS
+        html_start = f"""<!DOCTYPE html><html><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1">
+        <title>{self.title}</title>
+        <style>
+        :root {{ 
+            --bg:#f4f4f4;
+            --card:#fff; 
+            --text:#000; 
+            --primary:#4CAF50; }}
+        body {{ 
+                margin:0; 
+                font-family:
+                sans-serif; 
+                background:var(--bg); 
+                color:var(--text); 
+                text-align:center; 
+                padding:10px; }}
+        .header {{ 
+                display:flex; 
+                justify-content:
+                space-between; 
+                align-items:center; 
+                max-width:600px; 
+                margin:0 auto 20px; }}
+        .grid {{ display: grid; 
+                repeat(auto-fit, minmax(160px, 1fr)); 
+                gap: 15px; 
+                max-width: 800px; 
+                margin: 0 auto; }}
+        .card {{ background:var(--card);
+                padding:15px; 
+                border-radius:12px; 
+                box-shadow:0 3px 6px rgba(0,0,0,.1); 
+                display:flex; 
+                flex-direction:column; 
+                align-items:center; gap:8px; }}
+        .p-bg {{ width:100%; 
+                height:12px; 
+                background:#bbb; 
+                border-radius:6px; 
+                overflow:hidden; }}
+        .p-fill {{ 
+                height:100%; 
+                transition:width .4s; }}
+        .switch {{ 
+                position:relative; 
+                width:48px; 
+                height:26px; }}
+        .switch input {{ 
+                opacity:0; 
+                width:0; 
+                height:0; }}
+        .slider {{ 
+                position:absolute; 
+                cursor:pointer; 
+                inset:0; 
+                background:#ccc; 
+                border-radius:26px; 
+                transition:.3s; }}
+        .slider:before {{ 
+            content:""; 
+            position:absolute; 
+            height:20px; 
+            width:20px; 
+            left:3px; 
+            bottom:3px; 
+            background:#fff; 
+            border-radius:50%; 
+            transition:.3s; }}
+        input:checked + .slider {{ background:var(--primary); }}
+        input:checked + .slider:before {{ transform:translateX(22px); }}
+        </style>
+        <script>
+        let dark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+        function applyTheme() {{
+            document.documentElement.style.setProperty('--bg', dark ? '#121212' : '#f4f4f4');
+            document.documentElement.style.setProperty('--card', dark ? '#1e1e1e' : '#fff');
+            document.documentElement.style.setProperty('--text', dark ? '#fff' : '#000');
+        }}
+        function updateData(){{
+            fetch('/data').then(r=>r.json()).then(d=>{{
+                for(let id in d){{
+                    let i=d[id]; let tx=document.getElementById(id); let sw=document.getElementById(id+"-sw");
+                    if(!tx)continue;
+                    if(i.type==="level"){{ tx.style.width=i.value+"%"; document.getElementById(id+"-txt").innerText=i.value+"%"; }} 
+                    else if(i.type==="toggle"){{ tx.innerText=i.value?"ON":"OFF"; tx.style.color=i.value? "var(--primary)":"#888"; if(sw) sw.checked=!!i.value; }} 
+                    else {{ tx.innerText=i.value; }}
+                }}
+            }});
+        }}
+        setInterval(updateData, 1200);
+        function sendCmd(id){{ fetch('/?'+id+'=toggle'); }}
+        
+        // FIXED BRACES HERE
+        function toggleTheme() {{
+          dark=!dark;
+          applyTheme();
+          document.getElementById("themeBtn").innerText = dark ? "☀️" : "🌙";
+        }}
+
+        </script></head><body onload="applyTheme()">
+        <div class="header">
+            <h1>{self.title}</h1>
+            <button id="themeBtn" onclick="toggleTheme()" style="background:none;border:none;font-size:24px;cursor:pointer;">🌙</button>
+        </div>
+        <div class="grid">"""
+
+        writer.write(b"HTTP/1.1 200 OK\r\nContent-Type: text/html\r\nConnection: close\r\n\r\n")
+        writer.write(html_start.encode())
+
+        # Cards generation
+        sorted_keys = sorted(self.elements.keys()) 
+
+        for id in sorted_keys:
+            info = self.elements[id]
+            card = f"<div class='card'><strong>{info['label']}</strong>"
+            if info["type"] == "level":
+                card += f'<div id="{id}-txt">{info["value"]}%</div><div class="p-bg"><div id="{id}" class="p-fill" style="width:{info["value"]}%;background:{info["color"]}"></div></div>'
+            elif info["type"] == "toggle":
+                state = "ON" if info["value"] else "OFF"
+                c = "checked" if info["value"] else ""
+               
+                card += f'''
+                <div style="display:flex;align-items:center;gap:10px;">
+                  <span id="{id}" style="font-weight:bold;color:{'var(--primary)' if info["value"] else '#888'}">
+                    {state}
+                  </span>
+                  <label class="switch">
+                    <input type="checkbox" id="{id}-sw" onchange="sendCmd('{id}')" {c}>
+                    <span class="slider"></span>
+                  </label>
+                </div>
+                '''
+            else:
+                card += f"<div id='{id}' style='font-size:20px;font-weight:bold;'>{info['value']}</div>"
+            card += "</div>"
+            writer.write(card.encode())
+
+        writer.write(b"</div></body></html>")
+        await writer.drain()
+
+    async def _handle_request(self, reader, writer):
+        try:
+            raw = await reader.readline()
+            if not raw: return
+            req = raw.decode()
+            while await reader.readline() != b'\r\n': pass
+
+            if "/data" in req:
+                body = json.dumps({k: {"type": v["type"], "value": v["value"]} for k,v in self.elements.items()})
+                writer.write(b"HTTP/1.1 200 OK\r\nContent-Type: application/json\r\n\r\n")
+                writer.write(body.encode())
+            elif "toggle" in req:
+                for k,v in self.elements.items():
+                    if f"{k}=toggle" in req: v["value"] ^= 1
+                writer.write(b"HTTP/1.1 200 OK\r\n\r\n")
+            else:
+                await self._send_html(writer)
+            await writer.drain()
+        except Exception as e:
+            print("Dashboard error:", e)
+        finally:
+            await writer.wait_closed()
+            gc.collect()
+
+    def run(self, port=80):
+        print(f"Pico Dashboard Live on Port {port}")
+        loop = asyncio.get_event_loop()
+        loop.create_task(asyncio.start_server(self._handle_request, "0.0.0.0", port))
+        loop.run_forever()

micropidash-1.0.0/micropidash.egg-info/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.1
+Name: micropidash
+Version: 1.0.0
+Summary: A lightweight web dashboard for MicroPython (ESP32, Pico W)
+Home-page: https://github.com/kritishmohapatra/micropidash
+Author: Kritish Mohapatra
+Author-email: kritishmohapatra06norisk@gmail.com
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# 🚀 micropidash: Lightweight MicroPython IoT Dashboard
+
+**micropidash** is a high-performance, asynchronous web dashboard library specifically designed for microcontrollers like the **Raspberry Pi Pico 2W** (RP2350/RP2040) and ESP32. It enables the creation of real-time, responsive web interfaces for IoT projects using minimal MicroPython code.
+
+<p align="center">
+  <a href="https://micropython.org/"><img src="https://img.shields.io/badge/MicroPython-✓-green?logo=micropython&logoColor=white" alt="MicroPython"></a>
+  <a href="https://www.espressif.com/en/products/socs/esp32"><img src="https://img.shields.io/badge/ESP32-Supported-orange?logo=espressif&logoColor=white" alt="ESP32"></a>
+  <a href="https://www.raspberrypi.com/products/raspberry-pi-pico/"><img src="https://img.shields.io/badge/Raspberry%20Pi%20Pico%20 2 W-Compatible-darkgreen?logo=raspberrypi&logoColor=white" alt="Pico 2 W"></a>
+  <a href="https://github.com/kritishmohapatra/micropython-sevenseg/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?logo=open-source-initiative&logoColor=white" alt="License"></a>
+
+  
+</p>
+
+**Author:** [Kritish Mohapatra]  
+
+
+---
+
+## ✨ Key Features
+* **Asynchronous Engine:** Built on `uasyncio` for non-blocking, multi-tasking performance.
+* **Real-Time Sync:** AJAX-based polling ensures all connected devices (Mobile & Laptop) stay synced without page refreshes.
+* **Client-Side Theming:** Every connected user can independently toggle between Dark and Light modes.
+* **Order Preservation:** Uses alphabetical sorting for widget IDs to ensure your layout stays exactly as intended.
+* **Memory Efficient:** Optimized for devices with limited RAM, featuring chunked data transmission and frequent garbage collection.
+
+---
+
+## 📦 Installation
+
+1. Upload `micropidash.py` to your microcontroller's root directory.
+2. Create a `main.py` file to implement your project logic.
+3. Ensure your device is connected to a stable 2.4GHz Wi-Fi network.
+
+---
+## 📂 Project Structure
+    ├── micropidash/
+    │ ├── init.py
+    │ └── micropidash.py 
+    │
+    ├── examples/
+    |  ├── basic_1.py
+    │  └── esp_32_example.py 
+    │
+    ├── README.md
+    └── LICENSE
+## 📚 API Documentation
+
+### `Dashboard(title)`
+Creates a new dashboard instance with the specified title.
+* **title**: (String) The name displayed at the top of your web dashboard.
+
+---
+
+### `add_toggle(id, label)`
+Adds a binary switch (On/Off) to the dashboard.
+* **id**: (String) Unique identifier for the widget. Also used for alphabetical sorting on the UI.
+* **label**: (String) The text displayed above the switch.
+
+---
+
+### `add_label(id, label)`
+Adds a text box designed for displaying live sensor data or status strings.
+* **id**: (String) Unique identifier for the widget.
+* **label**: (String) The descriptive text for the data being shown.
+
+---
+
+### `add_level(id, label, color)`
+Adds a graphical progress bar, perfect for humidity, tank levels, or battery percentage.
+* **id**: (String) Unique identifier for the widget.
+* **label**: (String) The descriptive text for the progress bar.
+* **color**: (Hex/CSS Color) The color of the fill bar (e.g., `#2196F3` or `red`).
+* **Value Range**: Expects an integer between $0$ and $100$.
+
+---
+
+### `update_value(id, value)`
+Injects new data into an existing widget. This change is pushed instantly to all connected web clients via the next poll.
+* **id**: (String) The ID of the widget you want to update.
+* **value**: (String/Int) The new data to display.
+
+---
+## 🚀 Quick Start (Simple Example)
+
+Use this minimal example to test your connection and ensure the dashboard is being served correctly on your local network.
+
+```python
+from micropidash import Dashboard
+import network 
+
+# 1. WiFi Setup
+wlan = network.WLAN(network.STA_IF)
+wlan.active(True)
+
+wlan.connect('YOUR_SSID', 'YOUR_PASSWORD')
+
+print("Connecting...")
+while not wlan.isconnected(): pass
+print("Connected! IP:", wlan.ifconfig()[0])
+
+# 2. Dashboard Initialization
+dash = Dashboard("MicroPiDash v1.0")
+
+# 3. Adding Basic Widgets
+dash.add_toggle("led", "Test Switch")      # A binary toggle
+dash.add_label("status", "System Status")  # A text display
+dash.add_level("level", "Signal Strength") # A progress bar (0-100)
+
+# 4. Start the Web Server
+# Access the dashboard via the IP address printed above
+dash.run()
+```
+
+### 🔌 ESP32 Onboard LED Example
+
+
+```python
+import machine, network, uasyncio as asyncio
+from micropidash import Dashboard
+
+# 1. ESP32 Pin Setup (Most boards use GPIO 2 for built-in LED)
+led = machine.Pin(2, machine.Pin.OUT)
+
+# 2. WiFi Connectivity
+wlan = network.WLAN(network.STA_IF)
+wlan.active(True)
+wlan.connect('YOUR_SSID', 'YOUR_PASSWORD')
+
+print("Connecting...")
+while not wlan.isconnected(): pass
+print("Server Live at IP:", wlan.ifconfig()[0])
+
+# 3. Dashboard Configuration
+dash = Dashboard("ESP32 Control Hub")
+dash.add_toggle("1_led", "Built-in LED")
+dash.add_label("2_status", "Live Status")
+
+# 4. Hardware & Web UI Sync Task
+async def sync_task():
+    while True:
+        # Dashboard UI state ko physical LED se link karna
+        led.value(dash.elements["1_led"]["value"])
+        
+        # Dashboard par status update bhejni
+        state = "GLOWING" if led.value() else "OFF"
+        dash.update_value("2_status", f"LED is {state}")
+        
+        await asyncio.sleep(0.5)
+
+# 5. Execution
+async def main():
+    asyncio.create_task(sync_task())
+    dash.run()
+
+asyncio.run(main())
+```
+## 🤝 Contributing
+As an **Electrical Engineering student**, I built **micropidash** to simplify MicroPython IoT development and bridge the gap between hardware and web interfaces. 
+
+If you find bugs, have feature ideas, or want to optimize the code further, feel free to open an **issue** or submit a **pull request**! Let's build the future of embedded systems together.
+
+---
+## 🌐 Author
+
+**Kritish Mohapatra**  
+🔗 [GitHub](https://github.com/kritishmohapatra)  
+📧 kritishmohapatra06norisk@gmail.com  
+
+✨ *Made with passion for Embedded Systems and MicroPython learners.*

micropidash-1.0.0/micropidash.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+micropidash/__init__.py
+micropidash/micropidash.py
+micropidash.egg-info/PKG-INFO
+micropidash.egg-info/SOURCES.txt
+micropidash.egg-info/dependency_links.txt
+micropidash.egg-info/top_level.txt

micropidash-1.0.0/micropidash.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

micropidash-1.0.0/micropidash.egg-info/top_level.txt

@@ -0,0 +1 @@
+micropidash

micropidash-1.0.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools<69", "wheel"]
+build-backend = "setuptools.build_meta"

micropidash-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

micropidash-1.0.0/setup.py

@@ -0,0 +1,19 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="micropidash",
+    version="1.0.0",
+    description="A lightweight web dashboard for MicroPython (ESP32, Pico W)",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    author="Kritish Mohapatra",
+    author_email="kritishmohapatra06norisk@gmail.com",
+    url="https://github.com/kritishmohapatra/micropidash",
+    license="MIT",
+    packages=find_packages(),
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+)