Getting Started

This guide walks you through creating your first dashboard on Control Seat.

Step 1: Create A Project

After signing in, create a new project. Projects are containers for your dashboards — you might use one per facility, site, or team.

Step 2: Create A Page

Inside your project, create a new page. This is your dashboard canvas.

Step 3: Build Your Dashboard

Use the drag-and-drop editor to add blocks to your canvas:

  • Charts — line, bar, gauge, and more for visualizing data
  • Text and labels — headers, status indicators, and annotations
  • Tables — alarm tables and data displays
  • Images — logos, diagrams, and P&IDs
  • Embedded views — reuse other pages as components

You can also type a description and let AI generate the dashboard for you.

Step 4: Connect Your Data

Control Seat uses tags as the universal data layer. Tags are named values that update in real time.

  1. Create tags in the tag system (e.g., default/temperature, default/pump/speed)
  2. Connect tags to data sources — PostgreSQL, MySQL, InfluxDB, Prometheus, REST APIs, or manual values
  3. Bind block properties to tags — any property on any block can be driven by live data

Once bound, your dashboard updates automatically as tag values change.

Step 5: Add Automation (Optional)

For custom behavior, you have two options:

  • Flows — visual rules and automations, no code required for most tasks (e.g., "email ops when pump temp > 180", "post every alarm to Slack"). See the Flows docs.
  • Scripts — when you need code:
    • Binding scripts — transform tag values before they reach a block (e.g., convert units, set colors based on thresholds)
    • Page scripts — custom JavaScript that runs on the page (e.g., subscribe to tags, update multiple blocks)
    • Gateway scripts — server-side automation (e.g., alarms, webhooks, scheduled reports)

See the Scripting docs for details and examples.

Step 6: Publish

When your dashboard is ready, publish it. You'll get a URL that anyone with access can open to see the live dashboard.

Next Steps

  • Dashboards — deeper dive into the editor and publishing
  • Flows — visual rule engine for alerts and automations
  • Tags & Data Sources — how the data layer works
  • Scripting — binding scripts, page scripts, and gateway scripts
  • API Reference — programmatic access to screens, tags, and data