🛡️ OviShield: Automated Lethal Ovitrap IoT Controller

OviShield is a premium, high-fidelity responsive IoT control dashboard developed by Janith Suraweera in partnership with JNEX Solutions. This portal acts as the centralized Command & Control interface for a network of smart biothermal ovitraps designed to combat Dengue outbreaks by attracting, detecting, and automatically terminating mosquito larvae.

---

🦟 Project Concept & IoT Mechanics

Traditional ovitraps monitor mosquito populations passively. OviShield interfaces with active, automated traps that perform the following cycle:

1. Attraction: Stagnant water, visual dark contours, and slow-release organic oviposition pheromones attract pregnant female Dengue mosquitoes.
2. Detection: Optical and conductive biosensors in the trap chamber detect the presence of hatched larvae.
3. Eradication: When larvae density exceeds limits, the trap locks its entry valves and activates a biothermal heating coil to raise water temperature to 42.5°C for 15 minutes (thermal shock), ensuring 100% larval mortality without chemical toxins.
4. Flushing & Reset: The chamber flushes, resets, and transmits telemetry packets back to the dashboard via secure cloud sync.

---

✨ Features & Interactive Panels

This dashboard includes:

• Dashboard Hub: Glassmorphic KPI cards with hover expansions, live system uptime reports, and active device tallies.
• Biothermal Trend Analytics: Responsive area charts detailing larvae termination spikes and thermal cycle triggers, supporting 7-day and 30-day views.
• Geographic Telemetry HUD: Interactive vector map of the Colombo District. Features pulsing high-risk heatwaves and clickable telemetry nodes that load real-time sensor states.
• Live Device Registry Table: A search-and-filter-supported diagnostic log sheet. Features a "Thermal Shock" manual override button that simulates the physical heating cycle, rising temperature, and status indicators in real-time.
• IoT Calibrator: A settings portal to modify target heating temperatures, activation times, alert hotlines, and cloud sync e-mails.

---

🛠️ Tech Stack & Architecture

• Frontend Core: React 19, Next.js 16 (App Router)
• Bundler: Webpack Fallback Compiler (optimized for high-compatibility win32 SWC compilation environments)
• Styling: Tailwind CSS v4, custom utility glows, glassmorphism, and coordinate wave vectors.
• Data Visualization: Recharts
• Iconography: Lucide React

---

🚀 Quick Start (Local Run)

Follow these steps to run the dashboard locally on your system:

1. Prerequisites

Ensure you have Node.js (v18.x or later) and npm installed.

2. Installation

Clone the repository, navigate to the folder, and install the project dependencies:

# Install dependencies with legacy peer resolutions for React 19 charts compatibility
npm install --legacy-peer-deps

3. Run Development Server

Start the Next.js dev compiler:

npm run dev

Next.js will compile the project and open the portal. If port 3000 is occupied, it will automatically launch on: 👉 http://localhost:3001

4. Build for Production

To generate a highly optimized static build file structure:

npm run build

---

🌐 Deployment to Vercel

To deploy this project to the cloud in under 2 minutes:

1. Push to GitHub: Initialize git, commit your changes, and push to a GitHub repository:

   git init
   git add .
   git commit -m "feat: OviShield IoT Dashboard Redesign"
   # Push to your remote repo

2. Deploy on Vercel:

   • Go to Vercel Dashboard.
   • Click Add New -> Project.
   • Import your GitHub repository.
   • Click Deploy. Vercel will automatically read the Next.js configurations and deploy your live dashboard.

---

🧑‍💻 Development Attribution

• Lead IoT Developer: Janith Suraweera
• Agency Partner: JNEX Solutions
• Project License: MIT

Designed & Engineered for advanced vector control.