IoT Agent Mesh

A modern web-based platform for managing IoT device agents, built using React, Supabase, Tailwind CSS, and TypeScript.

Overview

IoT Agent Mesh is a comprehensive management system that provides organizations with a centralized platform to monitor, configure, and control their IoT device infrastructure. The platform combines a modern React frontend with a powerful Supabase backend to deliver real-time device monitoring, intelligent alerting, and seamless integrations.

Key Features

🏢 Organization Management

• Multi-tenant organization structure
• Role-based access control (RBAC)
• User invitation and management system
• Organization-level settings and configurations

🤖 IoT Agent Management

• Device agent registration and provisioning
• Real-time agent status monitoring
• Configuration management and updates
• Device lifecycle management

📊 Telemetry & Monitoring

• Real-time data visualization
• Historical data analysis
• Custom dashboard creation
• Device health monitoring

🚨 Alerts & Automation

• Configurable alert rules and thresholds
• Multi-channel notification support
• Automated response workflows
• Integration with external systems

🔌 Integrations

• RESTful API for external systems
• Webhook support for real-time notifications
• Third-party service connectors
• Custom integration framework

Technology Stack

• Frontend: React + Vite + TypeScript + Tailwind CSS + Shadcn/UI
• Backend: Supabase (PostgreSQL, Auth, RLS, Edge Functions)
• Tooling: ESLint, Vitest, Prettier

Why This Stack?

• React 18+: Modern component architecture with hooks and concurrent features
• TypeScript: Type safety and enhanced developer experience
• Vite: Fast development builds and hot module replacement
• Supabase: Backend-as-a-Service with real-time capabilities
• Tailwind CSS: Utility-first CSS framework for rapid UI development
• Shadcn/UI: High-quality, accessible React components

Quick Start

Prerequisites

• Node.js (LTS version recommended)
• npm or yarn package manager
• Supabase account and project

Installation

# Clone the repository
git clone https://github.com/arilonUK/iotagentmesh.git
cd iotagentmesh

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your Supabase credentials

# Start development server
npm run dev

First Steps

1. Setup Environment: Configure your Supabase project credentials
2. Initialize Database: Run the provided SQL scripts to set up tables
3. Create Organization: Register your first organization and admin user
4. Add IoT Agents: Begin registering your IoT devices

Project Structure

iotagentmesh/
├── src/
│   ├── components/          # Reusable React components
│   ├── pages/              # Application pages/routes
│   ├── hooks/              # Custom React hooks
│   ├── lib/                # Utility functions and configurations
│   ├── types/              # TypeScript type definitions
│   └── styles/             # Global styles and Tailwind config
├── public/                 # Static assets
├── supabase/              # Database migrations and functions
│   ├── migrations/        # SQL migration files
│   └── functions/         # Edge functions
├── docs/                  # Documentation
└── tests/                 # Test files

Getting Help

Documentation

• [Getting Started Guide](Getting-Started.md) - Detailed setup instructions
• [Architecture Overview](Architecture-Overview.md) - System design and components
• [API Documentation](API-Documentation.md) - Backend API reference
• [Deployment Guide](Deployment-Guide.md) - Production deployment

Community & Support

• Issues: Report bugs and request features on [GitHub Issues](https://github.com/arilonUK/iotagentmesh/issues)
• Discussions: Community discussions and questions
• Contributing: See our [Contributing Guide](Contributing.md) to get involved

Development Tools

• Lovable Platform: Simply visit the [Lovable Project](https://lovable.dev/projects/dd34faa8-f2b9-4cd0-8328-bd9c99b92734) and start prompting.
• Local Development: Full IDE support with hot reloading
• GitHub Codespaces: Cloud-based development environment

Use Cases

Industrial IoT

• Manufacturing equipment monitoring
• Predictive maintenance systems
• Quality control automation
• Supply chain tracking

Smart Building Management

• HVAC system optimization
• Energy consumption monitoring
• Security system integration
• Environmental sensing

Fleet Management

• Vehicle tracking and monitoring
• Fuel efficiency optimization
• Driver behavior analysis
• Maintenance scheduling

Agriculture & Environmental

• Soil condition monitoring
• Irrigation system control
• Weather station networks
• Crop health assessment

Next Steps

1. [Set up your development environment](Development-Setup.md)
2. [Understand the system architecture](Architecture-Overview.md)
3. [Configure your first organization](User-Management.md)
4. [Deploy to production](Deployment-Guide.md)

---

Last updated: July 2025