A web application for monitoring and visualizing environmental sensor data from IoT devices. EnviroHub ingests readings from distributed sensor nodes and displays temperature, humidity, pressure, and CO2 levels on an interactive dashboard.

• Live dashboard — visualize sensor readings per home and node with Chart.js charts
• Multi-location support — manage multiple homes, each with multiple sensor nodes
• REST API — ingest sensor data from IoT devices using bearer token authentication
• Auto node provisioning — nodes are created automatically on first data submission

• PHP 8.2+
• Composer
• Node.js & npm

composer run setup

This single command will:

1. Install PHP dependencies
2. Copy .env.example to .env
3. Generate an application key
4. Run database migrations
5. Install Node dependencies and build frontend assets

composer run dev

Starts all development processes concurrently:

• Laravel development server (php artisan serve)
• Queue worker (php artisan queue:listen)
• Log viewer (php artisan pail)
• Vite watch mode (npm run dev)

php artisan db:seed

Seeds 3 homes with 72 hours of realistic sensor readings at 15-minute intervals, simulating daily temperature cycles, inverse humidity, and CO2 variations based on occupancy hours.

Copy .env.example to .env and set the following:

# Required for API authentication
API_BEARER_TOKEN=your-secret-token-here

# Database (defaults to SQLite)
DB_CONNECTION=sqlite

Stores a sensor reading from a node. Requires a bearer token.

Headers

Authorization: Bearer your-secret-token-here
Content-Type: application/json

Request body

{
    "node_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "temperature": 22.5,
    "humidity": 45.3,
    "pressure": 1013,
    "carbon_dioxide": 420,
    "measured_at": "2024-01-01T12:00:00Z"
}

Responses

201 Created

{
    "message": "Sensor data stored successfully.",
    "data": { }
}

401 Unauthorized — missing or invalid bearer token

422 Unprocessable Entity — validation failed

Nodes are provisioned automatically. If the submitted node_uuid is not yet known, a new Node record is created. Subsequent submissions reuse the existing node.

composer run test

Tests run against an in-memory SQLite database. The suite covers:

• API authentication (valid/invalid tokens)
• Request validation (all fields, boundary values)
• Sensor data persistence and node resolution logic

app/
├── Http/
│   ├── Controllers/Api/    # API controllers
│   ├── Middleware/         # API token authentication
│   └── Requests/           # Form request validation
├── Livewire/               # Livewire components (dashboard)
├── Models/                 # Eloquent models (Home, Node, SensorData)
└── Services/               # Business logic (SensorDataService)
resources/
├── js/                     # Alpine.js components, Chart.js setup
├── css/                    # Tailwind CSS
└── views/                  # Blade templates and Livewire views
tests/
├── Feature/Api/            # HTTP endpoint tests
└── Unit/Services/          # Service layer unit tests

Current version: v0.1.0 — see VERSION.txt