Web Dashboard

The RIoT web dashboard is the primary interface for monitoring your device fleet, visualizing sensor data, managing locations, and exporting data. It runs as a Next.js application and is accessible from any modern browser.

Signing In

Navigate to the dashboard URL provided by your organization. The login page offers two authentication methods:

• Google OAuth -- Select Continue with Google to authenticate with your Google account. The platform redirects you to Google's consent screen, then back to the dashboard upon approval.
• Email and password -- Enter your credentials directly if your account was created with a password.

On first login via Google OAuth, the platform creates your user account automatically and associates it with the email address from your Google profile. If you were invited to an organization, the invitation is linked to your account upon first sign-in.

Sessions are server-side and bound to your browser fingerprint. A session cookie replayed from a different browser or device is rejected.

Dashboard Overview

The Dashboard page (/dashboard) is a customizable widget canvas. Build your own monitoring view by adding widgets from the catalog.

Select Add Widget to open the widget catalog. Available widget types:

Widgets can be repositioned and resized on the grid. Your layout is persisted locally in the browser and restored on each visit.

To start fresh, navigate to Settings and select Reset Layout under the Dashboard section.

Navigation

The sidebar provides access to all pages. On desktop, it appears as a collapsed icon rail on the left edge and expands on hover. On mobile, tap the menu icon to open a slide-over navigation sheet.

The sidebar is divided into two sections:

Primary navigation:

Secondary navigation:

The sidebar displays the RIoT logo and application version at the bottom when expanded. You can configure the sidebar to remain expanded by default in Settings.

Key Pages

Devices

The Devices page (/devices) lists every device registered to your organization. Each entry shows the device UID, assigned location and area, firmware version, WiFi signal strength (RSSI), and last seen timestamp.

• Filter by location or area to narrow the list to a specific site or zone.
• Search by device UID to locate a specific unit.
• Register a new device by selecting Register Device and providing a unique device UID and tenant assignment. The platform generates an API key and secret -- copy both values, as the secret is shown only once.

Click any device to open its detail page (/devices/[id]), which includes:

From the detail page you can send commands (reboot, wipe, get status, update config) and push configuration changes over the air.

Charts

The Charts page (/charts) provides advanced sensor data exploration with a full-width interactive time-series chart.

Use the toolbar to build a query:

1. Devices -- Select one or more devices from the multi-select dropdown.
2. Sensor Types -- Filter by sensor type (e.g., sht4x, scd4x). Available types update based on your device selection.
3. Fields -- Choose specific measurement fields to chart. Fields are grouped by sensor type and become available after selecting sensor types.
4. Time Range -- Set start and end timestamps using the time range picker.
5. Resolution -- Choose a data aggregation interval (raw, 1m, 5m, 15m, 1h, 1d) or leave on Auto to let the system select an appropriate resolution for the time window.

Additional toolbar controls:

The chart renders with Recharts and includes a synchronized crosshair and interactive legend panel. Toggle individual series on or off by clicking legend entries.

Locations

The Locations page (/locations) manages the physical hierarchy of your deployment. The layout is a split view: a location list on the left and the selected location's detail on the right.

Each location represents a physical site (plant, facility, well pad). Within a location, define areas to subdivide the site into logical zones (production area, building wing, pipeline segment).

From the detail panel you can:

• Create, rename, and delete locations.
• Add and manage areas within a location.
• View devices assigned to each location and area.

On mobile, the split view collapses into a stacked list-and-detail navigation.

Exports

The Exports page (/exports) manages asynchronous data export jobs. It is organized into three tabs:

Jobs -- Create and monitor export jobs. The export builder walks through a four-step wizard:

1. Format -- Choose the output format.

   Format	Best for
   CSV	Spreadsheets and tabular analysis.
   JSON	APIs, tooling, and structured processing.
   Parquet	Large datasets and columnar analytics.

2. Filters -- Scope the export by device IDs, sensor types, time range, and data resolution.

3. Options -- Name the export, add a description, toggle metadata headers and value flattening.

4. Confirm -- Review the configuration and estimated row count and file size before submitting.

Active jobs display a badge in the page header. Completed jobs show a notification badge that can be dismissed.

Schedules -- Create recurring export schedules to automate data extraction on a regular cadence.

Audit Log -- View a history of export operations for compliance and troubleshooting.

Settings

The Settings page (/settings) controls display preferences and application behavior. All preferences are stored locally in the browser.

Display

Data Formatting

Dashboard Layout

Select Reset Layout to remove all widgets and restore the default empty canvas. This action cannot be undone.

Account

The Account page (/account) displays your profile information (email, role, membership date) and provides security controls:

• Change password -- Update your account password.
• Active sessions -- View all sessions associated with your account, including browser and device details.
• Log out all sessions -- Invalidate every active session, including the current one. You will be redirected to the login page.

Organization

The Organization page (/organization) manages your active organization's membership and settings. It is divided into three tabs:

• Members -- View current members and their roles. Invite new members by selecting Invite Member and providing an email address.
• Invitations -- View and manage pending invitation links.
• Settings -- Configure organization-level preferences.

Roles determine access to locations, devices, and administrative functions within the organization.